Criar um serviço de Azure Search no portalCreate an Azure Search service in the portal

O Azure Search é um recurso independente usado para conectar uma experiência de pesquisa a aplicativos personalizados.Azure Search is a standalone resource used to plug in a search experience in custom apps. Embora o Azure Search seja integrado com facilidade a outros serviços do Azure, você também poderá usá-lo por si só, com aplicativos em servidores de rede ou com o software em execução em outras plataformas de nuvem.Although Azure Search integrates easily with other Azure services, you can also use it by itself, with apps on network servers, or with software running on other cloud platforms.

Neste artigo, saiba como criar um recurso do Azure Search no portal do Azure.In this article, learn how to create an Azure Search resource in the Azure portal.

GIF animadoAnimated GIF

Prefere o PowerShell?Prefer PowerShell? Use o modelo de serviço do Azure Resource Manager.Use the Azure Resource Manager service template. Para obter ajuda para começar a usá-lo, confira Manage Azure Search with PowerShell (Gerenciar o Azure Search com o PowerShell).For help with getting started, see Manage Azure Search with PowerShell.

Assinar (gratuito ou pago)Subscribe (free or paid)

Abra uma conta gratuita do Azure e use créditos gratuitos para experimentar serviços pagos do Azure.Open a free Azure account and use free credits to try out paid Azure services. Depois que os créditos forem usados, mantenha a conta e continue a usar os serviços do Azure gratuitos, como os sites.After credits are used up, keep the account and continue to use free Azure services, such as Websites. Seu cartão de crédito nunca será cobrado, a menos que você altere explicitamente suas configurações, solicitando esse tipo de cobrança.Your credit card is never charged unless you explicitly change your settings and ask to be charged.

Alternativamente, você pode ativar os benefícios de assinante MSDN.Alternatively, activate MSDN subscriber benefits. Todos os meses, uma assinatura do MSDN lhe oferece créditos que podem ser usados para serviços pagos do Azure.An MSDN subscription gives you credits every month you can use for paid Azure services.

  1. Entre no Portal do Azure.Sign in to the Azure portal.
  2. Clique no sinal de adição ("+ Criar Recurso") no canto superior esquerdo.Click the plus sign ("+ Create Resource") in the top-left corner.
  3. Use a barra de pesquisa para localizar "Azure Search" ou navegue para o recurso por meio de Web > Azure Search.Use the search bar to find "Azure Search" or navigate to the resource through Web > Azure Search.

Navegar até um recurso do Azure SearchNavigate to an Azure Search resource

Nome do serviço e o ponto de extremidade da URLName the service and URL endpoint

Um nome de serviço é parte do ponto de extremidade da URL na qual as chamadas à API são emitidas: https://your-service-name.search.windows.net.A service name is part of the URL endpoint against which API calls are issued: https://your-service-name.search.windows.net. Digite o nome do serviço no campo URL.Enter your service name in the URL field.

Por exemplo, caso deseje que o ponto de extremidade seja https://my-app-name-01.search.windows.net, insira my-app-name-01.For example, if you want the endpoint to be https://my-app-name-01.search.windows.net, you would enter my-app-name-01.

Requisitos de nome de serviço:Service name requirements:

  • Ele deve ser exclusivo dentro do namespace search.windows.netIt must be unique within the search.windows.net namespace
  • Dois a 60 caracteres de comprimento2 and 60 characters in length
  • Use letras minúsculas, dígitos ou traços ("-")Use lowercase letters, digits, or dashes ("-")
  • Evite traços ("-") nos 2 primeiros caracteres ou o último caractereAvoid dashes ("-") in the first 2 characters or as the last single character
  • Sem traços consecutivos ("--") em nenhum lugarNo consecutive dashes ("--") anywhere

Selecionar uma assinaturaSelect a subscription

Se você tiver mais de uma assinatura, escolha uma que também tenha serviços de armazenamento de arquivos ou dados.If you have more than one subscription, choose one that also has data or file storage services. O Azure Search pode detectar automaticamente o armazenamento de Tabelas e Blobs do Azure, o Banco de Dados SQL e o Azure Cosmos DB para indexação por meio de indexadores, mas apenas para os serviços na mesma assinatura.Azure Search can autodetect Azure Table and Blob storage, SQL Database, and Azure Cosmos DB for indexing via indexers, but only for services in the same subscription.

Selecionar um grupo de recursosSelect a resource group

Um grupo de recursos é uma coleção de serviços e recursos do Azure que são usados juntos.A resource group is a collection of Azure services and resources used together. Por exemplo, se você estiver usando a Azure Search para indexar um banco de dados SQL, esses dois serviços deverão fazer parte do mesmo grupo de recursos.For example, if you are using Azure Search to index a SQL database, then both services should be part of the same resource group.

Se você não estiver combinando recursos em um único grupo ou se os grupos de recursos existentes estiverem preenchidos com recursos usados em soluções não relacionadas, crie um grupo de recursos apenas para o recurso do Azure Search.If you aren't combining resources into a single group, or if existing resource groups are filled with resources used in unrelated solutions, create a new resource group just for your Azure Search resource.

Dica

Excluir um grupo de recursos também exclui os serviços dentro dele.Deleting a resource group also deletes the services within it. Para projetos de protótipo utilizando vários serviços, colocar todos eles no mesmo grupo de recursos facilita a limpeza depois da conclusão do projeto.For prototype projects utilizing multiple services, putting all of them in the same resource group makes cleanup easier after the project is over.

Selecione um localSelect a location

Como um serviço do Azure, a Azure Search pode ser hospedado em datacenters em todo o mundo.As an Azure service, Azure Search can be hosted in datacenters around the world. Os preços podem variar de acordo com a geografia.Prices can differ by geography.

Se você estiver indexando dados fornecidos por outro serviço do Azure (Armazenamento do Azure, Azure Cosmos DB, Banco de Dados SQL do Azure), crie seu serviço Azure Search na mesma região para evitar encargos de largura de banda.If you are indexing data provided by another Azure service (Azure storage, Azure Cosmos DB, Azure SQL Database), create your Azure Search service in the same region to avoid bandwidth charges. Não há encargos para dados de saída quando os serviços estão na mesma região.There are no charges for outbound data when services are in the same region.

Se estiver usando enriquecimentos de IA da pesquisa cognitiva, crie seu serviço na mesma região que seu recurso dos Serviços Cognitivos.If you are using cognitive search AI enrichments, create your service in the same region as your Cognitive Services resource. A colocalização de serviços é um requisito do enriquecimento de IA.Co-location of services is a requirement for AI enrichment.

Selecionar um tipo de preço (SKU)Select a pricing tier (SKU)

O Azure Search é oferecido em vários tipos de preço no momento: Gratuito, Básico ou Padrão.Azure Search is currently offered in multiple pricing tiers: Free, Basic, or Standard. Cada tipo tem sua própria capacidade e limites.Each tier has its own capacity and limits. Confira Escolher um tipo de preço ou SKU para obter orientações.See Choose a pricing tier or SKU for guidance.

Geralmente, o Standard é escolhido para cargas de trabalho de produção, mas a maioria dos clientes começa com o serviço Gratuito.Standard is usually chosen for production workloads, but most customers start with the Free service.

A camada de preços não pode ser alterada depois que o serviço é criado.A pricing tier cannot be changed once the service is created. Se você precisar de um nível superior ou inferior mais tarde, você precisa recriar o serviço.If you need a higher or lower tier later, you have to re-create the service.

Criar seu serviçoCreate your service

Lembre-se de fixar o seu serviço no painel para acesso fácil sempre que você entrar.Remember to pin your service to the dashboard for easy access whenever you sign in.

Fixar no painelPin to the dashboard

Obter uma chave e um ponto de extremidade de URLGet a key and URL endpoint

Com poucas exceções, o uso do novo serviço requer que você forneça o ponto de extremidade de URL e uma chave de API de autorização.With few exceptions, using your new service requires that you provide the URL endpoint and an authorization api-key. Guias de início rápido, tutoriais como Explorar APIs REST do Azure Search (Postman) e Como usar o Azure Search do .NET, exemplos e um código personalizado precisam de um ponto de extremidade e de uma chave para serem executados no recurso específico.Quickstarts, tutorials such as Explore Azure Search REST APIs (Postman) and How to use Azure Search from .NET, samples, and custom code all need an endpoint and key to run on your particular resource.

  1. Na página de visão geral do serviço, localize e copie o ponto de extremidade de URL do lado direito da página.In the service overview page, locate and copy the URL endpoint on the right side of the page.

    Página de visão geral do serviço com o ponto de extremidade de URLService overview page with URL endpoint

  2. No painel de navegação esquerdo, selecione Chaves e, em seguida, copie uma das chaves de administração (elas são equivalentes).In the left navigation pane, select Keys and then copy either one of the admin keys (they are equivalent). As chaves de API do administrador são necessárias para criar, atualizar e excluir objetos em seu serviço.Admin api-keys are required for creating, updating, and deleting objects on your service.

    Página de chaves mostrando chaves primárias e secundáriasKeys page showing primary and secondary keys

Um ponto de extremidade e uma chave não são necessários para tarefas baseadas no portal.An endpoint and key are not needed for portal-based tasks. O portal já está vinculado ao recuso do Azure Search com direitos de administrador.The portal is already linked to your Azure Search resource with admin rights. Para obter um tutorial do portal, comece com Tutorial: Importar, indexar e consultar no Azure Search.For a portal tutorial, start with Tutorial: Import, index, and query in Azure Search.

Dimensione seu serviçoScale your service

Pode levar alguns minutos para criar um serviço (15 minutos ou mais dependendo da camada).It can take a few minutes to create a service (15 minutes or more depending on the tier). Depois que o serviço é fornecido, você pode dimensioná-lo para atender às suas necessidades.After your service is provisioned, you can scale it to meet your needs. Com a escolha do tipo Standard para o serviço do Azure Search, você pode dimensionar o serviço em duas dimensões: réplicas e partições.Because you chose the Standard tier for your Azure Search service, you can scale your service in two dimensions: replicas and partitions. Com a escolha do tipo Básico, você pode apenas adicionar réplicas.Had you chosen the Basic tier, you can only add replicas. Se você provisionou o serviço gratuito, o dimensionamento não estará disponível.If you provisioned the free service, scale is not available.

As partições permitem que o seu serviço armazene e pesquise mais documentos.Partitions allow your service to store and search through more documents.

Réplicas permitem que seu serviço lide com uma carga maior de consultas de pesquisa.Replicas allow your service to handle a higher load of search queries.

A adição de recursos aumenta sua fatura mensal.Adding resources increases your monthly bill. A calculadora de preços pode ajudá-lo a entender as implicações de cobrança de adição de recursos.The pricing calculator can help you understand the billing ramifications of adding resources. Lembre-se de que você pode ajustar os recursos com base na carga.Remember that you can adjust resources based on load. Por exemplo, você pode aumentar os recursos para criar um índice inicial completo e reduzir recursos posteriormente para um nível mais adequado para indexação incremental.For example, you might increase resources to create a full initial index, and then reduce resources later to a level more appropriate for incremental indexing.

  1. Vá até a folha de serviço de pesquisa no Portal do Azure.Go to your search service page in the Azure portal.
  2. No painel de navegação esquerdo, selecione Configurações > Escala.In the left-navigation pane, select Settings > Scale.
  3. Use a barra deslizante para adicionar recursos de qualquer tipo.Use the slidebar to add resources of either type.

Adicionar capacidadeAdd capacity

Observação

Cada camada tem diferentes limites do número total de Unidades de Pesquisa permitidas em um único serviço (Réplicas * Partições = Total de Unidades de Pesquisa).Each tier has different limits on the total number of Search Units allowed in a single service (Replicas * Partitions = Total Search Units).

Quando adicionar um segundo serviçoWhen to add a second service

A maioria dos clientes usa apenas um serviço provisionado em uma camada que fornece o equilíbrio certo de recursos.Most customers use just one service provisioned at a tier providing the right balance of resources. Um serviço pode hospedar vários índices, sujeito aos limites máximos na camada selecionada, com cada índice isolado do outro.One service can host multiple indexes, subject to the maximum limits of the tier you select, with each index isolated from another. No Azure Search, as solicitações podem ser direcionadas somente para um índice, minimizando a possibilidade de recuperação de dados acidental ou intencional de outros índices no mesmo serviço.In Azure Search, requests can only be directed to one index, minimizing the chance of accidental or intentional data retrieval from other indexes in the same service.

Embora a maioria dos clientes use apenas um serviço, a redundância de serviço poderá ser necessária se os requisitos operacionais incluírem o seguinte:Although most customers use just one service, service redundancy might be necessary if operational requirements include the following:

  • Recuperação de desastre (interrupção do datacenter).Disaster recovery (data center outage). O Azure Search não fornece failover instantâneo caso ocorra uma interrupção.Azure Search does not provide instant failover in the event of an outage. Para obter recomendações e diretrizes, consulte Administração de serviço.For recommendations and guidance, see Service administration.
  • Sua investigação de modelagem de multilocação determinou que serviços adicionais são o design ideal.Your investigation of multi-tenancy modeling has determined that additional services is the optimal design. Para obter mais informações, consulte Design para multilocação.For more information, see Design for multi-tenancy.
  • Para aplicativos implantados globalmente, é possível exigir uma instância do Azure Search em várias regiões para minimizar a latência de tráfego internacional do aplicativo.For globally deployed applications, you might require an instance of Azure Search in multiple regions to minimize latency of your application’s international traffic.

Observação

No Azure Search, não é possível segregar cargas de trabalho de indexação e de consulta; portanto, você nunca criará vários serviços para cargas de trabalho segregadas.In Azure Search, you cannot segregate indexing and querying workloads; thus, you would never create multiple services for segregated workloads. Um índice sempre é consultado no serviço em que foi criado (não é possível criar um índice em um serviço e copiá-lo para outro).An index is always queried on the service in which it was created (you cannot create an index in one service and copy it to another).

Um segundo serviço não é necessário para alta disponibilidade.A second service is not required for high availability. A alta disponibilidade para consultas é obtida ao usar duas ou mais réplicas no mesmo serviço.High availability for queries is achieved when you use 2 or more replicas in the same service. Atualizações de réplica são sequenciais, o que significa que, pelo menos, uma está operacional quando uma atualização de serviço é distribuída. Para obter mais informações sobre tempo de atividade, consulte Contratos de Nível de Serviço.Replica updates are sequential, which means at least one is operational when a service update is rolled out. For more information about uptime, see Service Level Agreements.

Próximas etapasNext steps

Depois de provisionar um serviço Azure Search, continue no portal para criar seu primeiro índice.After provisioning an Azure Search service, you can continue in the portal to create your first index.