Administração de serviços para Azure AI Search no portal do Azure
No Azure AI Search, o portal do Azure dá suporte a uma ampla gama de operações administrativas e de gerenciamento de conteúdo para que você não precise escrever código, a menos que queira automação.
Cada serviço de pesquisa é gerenciado como um recurso autônomo. Sua atribuição de função determina quais operações são expostas no portal.
Permissões de portal e administrador
O acesso ao portal é feito por meio de atribuições de função. Por padrão, todos os serviços de pesquisa começam com pelo menos um Proprietário. Proprietários, administradores de serviço e coadministradores têm permissão para criar outros administradores e outras atribuições de função. Eles têm acesso total a todas as páginas e operações do portal.
Os Colaboradores e os Colaboradores do Serviço de Pesquisa têm o mesmo acesso que o Proprietário, menos a capacidade de atribuir funções.
Os leitores têm acesso às informações de serviço na seção Essentials e na guia Monitoramento. O acesso é limitado. Um leitor pode obter informações básicas sobre um serviço de pesquisa, mas não o suficiente para configurar uma conexão ou confirmar a existência de objetos no serviço.
Para tarefas do plano de dados, como criar e configurar índices e indexadores: em um sistema padrão, o portal tenta chaves de API de administração primeiro, mesmo que haja atribuições de função. Se as chaves estiverem desativadas, aqui está a experiência do portal para as seguintes funções:
O Colaborador de Dados de Índice de Pesquisa pode ver a lista de indexadores e acessar um individual para ver suas execuções históricas e status, mas não pode executá-la, redefini-la, criá-la, atualizá-la ou excluí-la.
Um Leitor de Dados de Índice de Pesquisa pode consultar os índices.
Em resumo, se você quiser acesso irrestrito aos recursos do portal, incluindo a capacidade de executar os assistentes de Importação de dados, deverá ter permissões de Colaborador ou Colaborador do Search Servicer.
Gorjeta
Por padrão, qualquer proprietário ou administrador pode criar ou excluir serviços. Para evitar exclusões acidentais, você pode bloquear recursos.
Resumo do portal do Azure
A página de visão geral é a página "inicial" de cada serviço. Na captura de tela a seguir, as caixas vermelhas indicam tarefas, ferramentas e blocos que você pode usar com frequência, especialmente se você for novo no serviço.
| Área | Description |
|---|---|
| 5 | Uma barra de comandos na parte superior da página inclui o assistente de importação de dados e o explorador de pesquisa, usados para prototipagem e exploração. |
| 2 | A seção Essentials lista as propriedades do serviço, como o ponto de extremidade do serviço, a camada de serviço e as contagens de réplica e partição. |
| 3 | As páginas com guias no centro fornecem acesso rápido a estatísticas de uso e métricas de integridade do serviço. |
| 4 | Links de navegação para índices, indexadores, fontes de dados e conjuntos de habilidades existentes. |
Não é possível alterar o nome do serviço de pesquisa, a assinatura, o grupo de recursos, a região (local) ou a camada. A mudança de camadas requer a criação de um novo serviço ou o preenchimento de um tíquete de suporte para solicitar uma atualização de camada, que só é suportada para Basic e superior.
Lista de verificação de gestão do primeiro dia
Em um novo serviço de pesquisa, recomendamos essas tarefas de configuração.
Verifique a capacidade e entenda o faturamento
Por padrão, um serviço de pesquisa é criado em uma configuração mínima de uma réplica e partição cada. Você pode adicionar capacidade adicionando réplicas e partições, mas recomendamos aguardar até que os volumes a exijam. Muitos clientes executam cargas de trabalho de produção na configuração mínima.
Alguns recursos aumentam o custo de execução do serviço:
- Como você é cobrado pelo Azure AI Search explica quais recursos têm impacto na cobrança.
- (Opcional) desative a classificação semântica no nível de serviço para impedir o uso do recurso.
Configurar a segurança de rede
Por predefinição, um serviço de pesquisa aceita pedidos autenticados e autorizados através de ligações públicas à Internet. A segurança de rede restringe o acesso por meio de regras de firewall ou desabilitando conexões públicas e permitindo solicitações somente de redes virtuais do Azure.
- Configure regras de firewall IP para restringir o acesso por endereço IP.
- Configure um ponto de extremidade privado usando o Azure Private Link e uma rede virtual privada.
A segurança no Azure AI Search explica as chamadas de entrada e saída no Azure AI Search.
Ativar registo de diagnóstico
Habilite o log de diagnóstico para rastrear a atividade do usuário. Se você pular esta etapa, ainda obterá registros de atividades e métricas da plataforma automaticamente, mas se quiser informações de uso de índice e consulta, habilite o log de diagnóstico e escolha um destino para as operações registradas.
Recomendamos o Log Analytics Workspace para armazenamento durável para que você possa executar consultas do sistema no portal.
Internamente, a Microsoft coleta dados de telemetria sobre seu serviço e a plataforma. Ele é armazenado internamente nos data centers da Microsoft e disponibilizado globalmente para os engenheiros de suporte da Microsoft quando você abre um tíquete de suporte.
| Monitorizar dados | Retenção |
|---|---|
| Registos de atividade | 90 dias em um cronograma contínuo |
| Métricas de plataforma | 93 dias em um cronograma contínuo, exceto que a visualização do portal é limitada a uma janela de 30 dias |
| Registos do recurso | Gerenciado pelo usuário |
| Telemetria | Um ano e meio |
Nota
Consulte a seção "Residência de dados" do artigo de visão geral de segurança para obter mais informações sobre localização e privacidade de dados.
Configurar o acesso de utilizador
Inicialmente, apenas um proprietário tem acesso às informações e operações do serviço de pesquisa. Atribua funções para estender o acesso ou forneça aos usuários um ponto de extremidade de pesquisa com uma chave de API.
Um serviço de pesquisa é sempre criado com chaves de API. Uma chave de API admin concede acesso de leitura e gravação a todas as operações do plano de dados. Você não pode excluir chaves de API de administrador, mas pode desabilitar chaves de API se quiser que todos os usuários acessem operações de plano de dados por meio de atribuições de função.
Fornecer informações de conexão aos desenvolvedores
Os desenvolvedores precisam das seguintes informações para se conectar ao Azure AI Search:
- Um ponto de extremidade ou URL, fornecido na página Visão geral .
- Uma chave de API da página Chaves ou uma atribuição de função (o colaborador é recomendado).
Recomendamos o acesso ao portal para os seguintes assistentes e ferramentas: Assistente de importação de dados, Importar e vetorizar dados, Explorador de pesquisa. Lembre-se de que um usuário deve ser um contribuidor ou superior para executar os assistentes de importação.
Próximos passos
O suporte programático para administração de serviços pode ser encontrado nas seguintes APIs e módulos:
Você também pode usar as bibliotecas de cliente de gerenciamento nos SDKs do Azure para .NET, Python, Java e JavaScript.
Há paridade de recursos em todas as modalidades e idiomas, exceto para recursos de gerenciamento de visualização. Como regra geral, os recursos de gerenciamento de visualização são liberados primeiro por meio da API REST de gerenciamento.