Administração do serviço do Azure AI Search no portal do Azure

Este artigo aborda as tarefas de administração da Pesquisa de IA do Azure que você pode executar no portal do Azure.

Dependendo do seu nível de permissão, o portal fornece cobertura da maioria das operações de serviço de pesquisa, incluindo:

Cada serviço de pesquisa é gerenciado como um recurso autônomo. A imagem a seguir mostra as páginas do portal para um único serviço de pesquisa gratuito, chamado "demo-search-svc".

Página (inicial) de visão geral

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 for novo no serviço.

Portal pages for a search service

Área Descrição
1 Uma barra de comandos na parte superior da página inclui o Assistente de importação de dados e o Gerenciador de pesquisa, usados para criação de protótipos e exploração.
2 A seção Essentials lista as propriedades do serviço, como o ponto de extremidade de 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.

Propriedades do serviço somente leitura

Vários aspectos de um serviço de pesquisa são determinados quando o serviço é provisionado e não podem ser alterados:

  • Nome do serviço
  • Local do serviço 1
  • Camada de serviço 2

1 Embora existam modelos ARM e bicep para implantação de serviço, mover conteúdo é um esforço manual.

2 Alternar uma camada requer a criação de um novo serviço ou o arquivamento de um tíquete de suporte para solicitar uma atualização de camada.

Tarefas de gerenciamento

A administração inclui as seguintes tarefas:

Há paridade de recursos em todas as modalidades e idiomas, exceto para recursos de gerenciamento de visualização. Em geral, os recursos de gerenciamento de visualização são lançados pela API REST de Gerenciamento primeiro. 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.

Coleta e retenção de dados

Como o Azure AI Search é um recurso monitorado, você pode examinar os logs de atividades internos e as métricas de plataforma para obter insights sobre as operações de serviço. Os logs de atividades e os dados usados para relatar as métricas da plataforma são mantidos para os períodos descritos na tabela a seguir.

Se optar pelo registro em log de recursos, você especificará o armazenamento durável sobre o qual terá controle total sobre a retenção de dados e o acesso a dados por meio de consultas Kusto. Para obter mais informações sobre como configurar o log de recursos no Azure AI Search, confira Coletar e analisar dados de log.

Internamente, a Microsoft coleta dados de telemetria sobre seu serviço e a plataforma. Os dados são armazenados internamente em data centers da Microsoft e disponibilizado globalmente para engenheiros de suporte da Microsoft ao abrir um tíquete de suporte.

Dados de monitoramento Retenção
Logs de atividades 90 dias em uma agenda sem interrupção
Métricas de plataforma 93 dias em uma agenda sem interrupção, exceto que a visualização do portal é limitada a uma janela de 30 dias
Logs de recursos Usuário gerenciado
Telemetria Um ano e meio

Observação

Confira a seção "Residência de dados" do artigo de visão geral de segurança para obter mais informações sobre a localização e a privacidade dos dados.

Permissões de administrador

Quando você abre a página de visão geral do serviço de pesquisa, a função do Azure atribuída à sua conta determina qual conteúdo no portal está disponível para você. A página de visão geral no início do artigo mostra o conteúdo do portal disponível para um Proprietário ou Colaborador.

As funções do Azure usadas para a administração do serviço incluem:

  • Proprietário
  • Colaborador (mesmo que Proprietário, menos a capacidade de atribuir funções)
  • Leitor (fornece acesso às informações do serviço na seção Informações gerais e na guia Monitoramento)

Por padrão, todos os serviços de pesquisa começam com, pelo menos, um Proprietário. Os proprietários, os administradores de serviços e os coadministradores têm permissão para criar outros administradores e outras atribuições de função.

Também por padrão, os serviços de pesquisa começam com chaves de API para tarefas relacionadas ao conteúdo que um Proprietário ou um Colaborador pode executar no portal. No entanto, é possível desativar a autenticação de chave de API e usar exclusivamente o controle de acesso baseado em função do Azure. Se você desativar as chaves de API, lembre-se de configurar atribuições de função de acesso a dados para que todos os recursos do portal permaneçam operacionais.

Dica

Por padrão, qualquer proprietário ou administrador pode criar ou excluir serviços. Para evitar exclusões acidentais, você pode bloquear recursos.

Próximas etapas