Administração do serviço do Azure Search no portal do AzureService administration for Azure Search in the Azure portal

O Azure Search é um serviço de pesquisa baseado em nuvem, totalmente gerenciado usado para criar uma experiência avançada de pesquisa em aplicativos personalizados.Azure Search is a fully managed, cloud-based search service used for building a rich search experience into custom apps. Este artigo aborda as tarefas administração de serviço que você pode executar no portal do Azure para um serviço de pesquisa que você já tenha provisionado.This article covers the service administration tasks that you can perform in the Azure portal for a search service that you've already provisioned. Service administration é leve por design, limitada às seguintes tarefas:Service administration is lightweight by design, limited to the following tasks:

  • Gerenciar e proteger o acesso para as chaves de api usadas para acesso de leitura ou gravação para o serviço.Manage and secure access to the api-keys used for read or write access to your service.
  • Ajuste a capacidade de serviço, alterando a alocação de partições e réplicas.Adjust service capacity by changing the allocation of partitions and replicas.
  • Monitorar o uso de recursos, em relação aos limites máximos da sua camada de serviço.Monitor resource usage, relative to maximum limits of your service tier.

Observe que atualização não está listado como uma tarefa administrativa.Notice that upgrade is not listed as an administrative task. Já que os recursos são alocados quando o serviço for fornecido, a mudança para uma camada diferente exige um novo serviço.Because resources are allocated when the service is provisioned, moving to a different tier requires a new service. Veja Criar um serviço do Azure Search para obter detalhes.For details, see Create an Azure Search service.

Dica

Procurando ajuda sobre como analisar o desempenho de tráfego ou consulta de pesquisa? Ganhe informações sobre volume de consulta, quais termos as pessoas devem procurar, e quão bem sucedidos são os resultados de pesquisa em orientar clientes para documentos específicos no seu índice. Para obter orientações, consulte Análise De Tráfego De Pesquisa Para Azure Search, Monitorar as métricas de uso e consulta, e Desempenho e otimização.

Direitos de administradorAdministrator rights

O provisionamento ou encerramento do serviço em si podem ser feitos por um administrador ou coadministrador de assinatura do Azure.Provisioning or decommissioning the service itself can be done by an Azure subscription administrator or co-administrator.

Em um serviço, qualquer pessoa com acesso à URL do serviço e uma chave de API de administração tem acesso de leitura-gravação para o serviço.Within a service, anyone with access to the service URL and an admin api-key has read-write access to the service. Acesso de leitura-gravação fornece a capacidade de adicionar, excluir ou modificar objetos de servidor, incluindo chaves de API, índices, indexadores, fontes de dados, agendas e atribuições de função, conforme implementados por meio de funções definidas pelo RBAC.Read-write access provides the ability to add, delete, or modify server objects, including api-keys, indexes, indexers, data sources, schedules, and role assignments as implemented through RBAC-defined roles.

Todas as interações do usuário com o Azure Search se enquadram em um destes modos: acesso de leitura e gravação para o serviço (direitos de administrador) ou acesso somente de leitura ao serviço (direitos de consulta).All user interaction with Azure Search falls within one of these modes: read-write access to the service (administrator rights), or read-only access to the service (query rights). Para obter mais informações, consulte Gerenciar as chaves de api.For more information, see Manage the api-keys.

Log e informações do sistemaLogging and system information

O Azure Search não expõe os arquivos de log para um serviço individual por meio do portal ou interfaces programáticas.Azure Search does not expose log files for an individual service either through the portal or programmatic interfaces. Na camada Básica e acima, a Microsoft monitora todos os serviços do Azure Search para disponibilidade de 99,9% por contratos de nível de serviço (SLA).At the Basic tier and above, Microsoft monitors all Azure Search services for 99.9% availability per service level agreements (SLA). Se o serviço estiver lento ou a taxa de transferência de solicitação estiver abaixo dos limites de SLA, as equipes de suporte analisam os arquivos de log disponíveis para resolver o problema.If the service is slow or request throughput falls below SLA thresholds, support teams review the log files available to them and address the issue.

Em termos de informações gerais sobre o serviço, você pode obter informações das seguintes maneiras:In terms of general information about your service, you can obtain information in the following ways:

Monitorar o uso de recursosMonitor resource usage

No painel, o monitoramento de recursos é limitado às informações mostradas no painel de serviço e a algumas métricas que você pode obter ao consultar o serviço.In the dashboard, resource monitoring is limited to the information shown in the service dashboard and a few metrics that you can obtain by querying the service. No painel do serviço, na seção Uso, é possível determinar rapidamente se os níveis de recurso da partição estão adequados para o seu aplicativo.On the service dashboard, in the Usage section, you can quickly determine whether partition resource levels are adequate for your application.

Usando a API REST do Serviço Search, você pode obter uma contagem dos documentos e índices:Using the Search Service REST API, you can get a count on documents and indexes programmatically:

Recuperação de desastre e interrupções de serviçoDisaster recovery and service outages

Embora possamos recuperar seus dados, o Azure Search não fornece failover instantâneo do serviço se há uma interrupção no cluster ou no nível do datacenter.Although we can salvage your data, Azure Search does not provide instant failover of the service if there is an outage at the cluster or data center level. Se um cluster falhar no datacenter, a equipe de operações detectará e trabalhará para restaurar o serviço.If a cluster fails in the data center, the operations team will detect and work to restore service. Haverá tempo de inatividade durante a restauração do serviço.You will experience downtime during service restoration. É possível solicitar créditos de serviço para compensar a indisponibilidade do serviço de acordo com o SLA (Contrato de Nível de Serviço).You can request service credits to compensate for service unavailability per the Service Level Agreement (SLA).

Se o serviço contínuo for necessário em caso de falhas catastróficas fora do controle da Microsoft, você poderá provisionar um serviço adicional em outra região e implementar uma estratégia de replicação geográfica para garantir que os índices seja totalmente redundantes em todos os serviços.If continuous service is required in the event of catastrophic failures outside of Microsoft’s control, you could provision an additional service in a different region and implement a geo-replication strategy to ensure indexes are fully redundant across all services.

Os clientes que usam indexadores para popular e atualizar índices podem lidar com a recuperação de desastre por meio de indexadores específicos à geografia utilizando a mesma fonte de dados.Customers who use indexers to populate and refresh indexes can handle disaster recovery through geo-specific indexers leveraging the same data source. Dois serviços em regiões diferentes, cada um executando um indexador, poderiam indexar da mesma fonte de dados para obter redundância geográfica.Two services in different regions, each running an indexer, could index from the same data source to achieve geo-redundancy. Se você estiver indexando fontes de dados que também são com redundância geográfica, lembre-se de que a indexadores do Azure Search só podem executar a indexação incremental de réplicas primárias.If you are indexing from data sources that are also geo-redundant, be aware that Azure Search indexers can only perform incremental indexing from primary replicas. Em um evento de failover, verifique se você apontou novamente o indexador para a nova réplica primária.In a failover event, be sure to re-point the indexer to the new primary replica.

Se você não usar indexadores, você usará o código do aplicativo para enviar objetos e dados por push para diferentes serviços de pesquisa em paralelo.If you do not use indexers, you would use your application code to push objects and data to different search services in parallel. Para obter mais informações, consulte Desempenho e otimização no Azure Search.For more information, see Performance and optimization in Azure Search.

Backup e restauraçãoBackup and restore

Como o Azure Search não é uma solução de armazenamento de dados primário, não fornecemos um mecanismo formal de backup e restauração de autoatendimento.Because Azure Search is not a primary data storage solution, we do not provide a formal mechanism for self-service backup and restore. O código do aplicativo usado para criar e popular um índice é a opção de restauração de fato, caso você exclua um índice por engano.Your application code used for creating and populating an index is the de facto restore option if you delete an index by mistake.

Para recompilar um índice, exclua-o (supondo que ele exista), recrie o índice no serviço e recarregue-o recuperando dados do armazenamento de dados primário.To rebuild an index, you would delete it (assuming it exists), recreate the index in the service, and reload by retrieving data from your primary data store. Como alternativa, você poderá contatar o atendimento ao cliente para recuperar índices, caso haja uma interrupção regional.Alternatively, you can reach out to customer support to salvage indexes if there is a regional outage.

Expandir ou reduzirScale up or down

Todo serviço de pesquisa começa com um mínimo de uma réplica e uma partição.Every search service starts with a minimum of one replica and one partition. Se você se inscreveu um camada que fornece recursos dedicados, clique no bloco ESCALA no painel de serviço para ajustar o uso de recursos.If you signed up for a tier that provides dedicated resources, click the SCALE tile in the service dashboard to adjust resource usage.

Quando você adiciona capacidade por meio de qualquer recurso, o serviço as utiliza automaticamente.When you add capacity through either resource, the service uses them automatically. Não será necessária nenhuma outra medida de sua parte, mas haverá um breve atraso antes que ocorra o impacto do novo serviço.No further action is required on your part, but there is a slight delay before the impact of the new resource is realized. Pode levar 15 minutos ou mais para provisionar recursos adicionais.It can take 15 minutes or more to provision additional resources.

Adicionar réplicasAdd replicas

O aumento de QPS (consultas por segundo) ou o alcance da alta disponibilidade são feitos adicionando réplicas.Increasing queries per second (QPS) or achieving high availability is done by adding replicas. Cada réplica tem uma cópia de um índice, de modo que adicionar mais uma réplica se traduz em mais um índice que pode ser usado para atender às solicitações de consulta.Each replica has one copy of an index, so adding one more replica translates to one more index available for handling service query requests. Um mínimo de 3 réplicas são necessários para alta disponibilidade (consulte Planejamento de capacidade para obter detalhes).A minimum of 3 replicas are required for high availability (see Capacity Planning for details).

Um serviço de pesquisa com mais réplicas é capaz de balancear a carga das solicitações de consulta em um número maior de índices.A search service having more replicas can load balance query requests over a larger number of indexes. Em um determinado nível de volume de consultas, a produtividade das consultas será maior quando houver mais cópias do índice disponíveis para atender à solicitação.Given a level of query volume, query throughput is going to be faster when there are more copies of the index available to service the request. Caso esteja ocorrendo latência nas consultas, você pode esperar um impacto positivo quando as réplicas adicionais entrarem em atividade.If you are experiencing query latency, you can expect a positive impact on performance once the additional replicas are online.

Embora a produtividade das consultas aumente conforme você adiciona réplicas, ela não necessariamente dobra ou triplica conforme você adiciona réplicas ao seu serviço.Although query throughput goes up as you add replicas, it does not precisely double or triple as you add replicas to your service. Todos os aplicativos de pesquisa estão sujeitos a fatores externos que podem afetar o desempenho das consultas.All search applications are subject to external factors that can impinge on query performance. Consultas complexas e latência da rede são dois fatores que contribuem para variações nos tempos de resposta das consultas.Complex queries and network latency are two factors that contribute to variations in query response times.

Adicionar partiçõesAdd partitions

A maioria dos aplicativos de serviço possui uma necessidade integrada de mais réplicas em vez de partições.Most service applications have a built-in need for more replicas rather than partitions. Nos casos em que seja necessária uma contagem maior de documentos, é possível adicionar partições se você se inscreveu no serviço Standard.For those cases where an increased document count is required, you can add partitions if you signed up for Standard service. A camada Básica não fornece partições adicionais.Basic tier does not provide for additional partitions.

Na camada Standard, as partições são adicionadas em múltiplos de 12 (especificamente, 1, 2, 3, 4, 6 ou 12).At the Standard tier, partitions are added in multiples of 12 (specifically, 1, 2, 3, 4, 6, or 12). Isso é um artefato de fragmentação.This is an artifact of sharding. Um índice é criado em 12 fragmentos, que podem todos ser armazenados em 1 partição ou divididos igualmente em 2, 3, 4, 6 ou 12 partições (um fragmento por partição).An index is created in 12 shards, which can all be stored on 1 partition or equally divided into 2, 3, 4, 6, or 12 partitions (one shard per partition).

Remover réplicasRemove replicas

Após períodos de grandes volumes de consulta, você poderá reduzir réplicas quando as cargas de pesquisa tiverem se normalizado (por exemplo, após as vendas de final de ano).After periods of high query volumes, you can reduce replicas after search query loads have normalized (for example, after holiday sales are over).

Para fazer isso, mova o controle deslizante de réplicas para um número mais baixo.To do this, move the replica slider back to a lower number. Não são necessárias mais medidas de sua parte.There are no further steps required on your part. Reduzir o número de réplicas libera máquinas virtuais no datacenter.Lowering the replica count relinquishes virtual machines in the data center. Suas operações de consulta e ingestão de dados passarão a ser executadas em menos VMs do que antes.Your query and data ingestion operations will now run on fewer VMs than before. O limite mínimo é uma réplica.The minimum limit is one replica.

Remover partiçõesRemove partitions

Em contraste com a remoção de réplicas, que não requer nenhum esforço extra da sua parte, você pode precisar tomar algumas medidas se estiver usando armazenamento a mais que pode ser reduzido.In contrast with removing replicas, which requires no extra effort on your part, you might have some work to do if you are using more storage than can be reduced. Por exemplo, se a sua solução estiver usando três partições, fazendo o downsizing de uma ou duas partições gerará um erro se o novo espaço de armazenamento é menor do que o necessário.For example, if your solution is using three partitions, downsizing to one or two partitions will generate an error if the new storage space is less than required. Como é de se esperar, suas opções são excluir índices ou documentos dentro de um índice associado para liberar espaço ou manter a configuração atual.As you might expect, your choices are to delete indexes or documents within an associated index to free up space, or keep the current configuration.

Não há um método de detecção que informe quais fragmentos de índices estão armazenados em quais partições.There is no detection method that tells you which index shards are stored on specific partitions. Cada partição fornece cerca de 25 GB de armazenamento, de modo que você precisará reduzir o armazenamento para um tamanho que possa ser acomodado pelo número de partições que possui.Each partition provides approximately 25 GB in storage, so you will need to reduce storage to a size that can be accommodated by the number of partitions you have. Caso queira reverter para uma partição, os 12 fragmentos precisarão se encaixar.If you want to revert to one partition, all 12 shards will need to fit.

Para se planejar para o futuro, talvez você queira conferir o armazenamento (usando Obter Estatísticas do Índice) para ver o quanto você realmente usou.To help with future planning, you might want to check storage (using Get Index Statistics) to see how much you actually used.

Melhores práticas para escala e implantaçãoBest practices on scale and deployment

Este vídeo de 30 minutos examina as práticas recomendadas para cenários de implantação avançados, incluindo cargas de trabalho distribuídas geograficamente.This 30-minute video reviews best practices for advanced deployment scenarios, including geo-distributed workloads. Você também pode consultar Desempenho e otimização no Azure Search para páginas de ajuda que abrangem os mesmos pontos.You can also see Performance and optimization in Azure Search for help pages that cover the same points.

Próximas etapasNext steps

Depois de compreender os conceitos por trás de administração do serviço, considere o uso do PowerShell para automatizar tarefas.Once you understand the concepts behind service administration, consider using PowerShell to automate tasks.

Também é recomendável examinar o artigo de desempenho e otimização.We also recommend reviewing the performance and optimization article.

Outra recomendação é assistir ao vídeo mencionado na seção anterior.Another recommendation is to watch the video noted in the previous section. Ele fornece uma cobertura mais profunda das técnicas mencionadas nesta seção.It provides deeper coverage of the techniques mentioned in this section.