Administracja usługi dla platformy Azure Wyszukiwanie poznawcze w Azure PortalService administration for Azure Cognitive Search in the Azure portal

Azure Wyszukiwanie poznawcze to w pełni zarządzana usługa wyszukiwania oparta na chmurze służąca do tworzenia bogatego środowiska wyszukiwania w aplikacjach niestandardowych.Azure Cognitive Search is a fully managed, cloud-based search service used for building a rich search experience into custom apps. W tym artykule omówiono zadania administracyjne usługi, które można wykonać w Azure Portal dla usługi wyszukiwania, która została już zainicjowana.This article covers the service administration tasks that you can perform in the Azure portal for a search service that you've already provisioned. Administrowanie usługami jest lekkie przez projektowanie, ograniczone do następujących zadań:Service administration is lightweight by design, limited to the following tasks:

  • Zarządzanie dostępem do kluczy API-Keys używanych na potrzeby dostępu do odczytu lub zapisu do usługi.Manage access to the api-keys used for read or write access to your service.
  • Dostosuj pojemność usługi, zmieniając alokację partycji i replik.Adjust service capacity by changing the allocation of partitions and replicas.
  • Monitoruj użycie zasobów względem maksymalnych limitów warstwy usług.Monitor resource usage, relative to maximum limits of your service tier.

Należy zauważyć, że uaktualnienie nie jest wymienione jako zadanie administracyjne.Notice that upgrade is not listed as an administrative task. Ponieważ zasoby są alokowane po aprowizacji usługi, przeniesienie do innej warstwy wymaga nowej usługi.Because resources are allocated when the service is provisioned, moving to a different tier requires a new service. Aby uzyskać szczegółowe informacje, zobacz Tworzenie usługi Azure wyszukiwanie poznawcze.For details, see Create an Azure Cognitive Search service.

Możesz monitorować wolumin zapytań i inne metryki oraz korzystać z tych szczegółowych informacji, aby dostosować usługę do krótszych czasów odpowiedzi.You can monitor query volume and other metrics, and use those insights to adjust your service for faster response times. Aby uzyskać więcej informacji, zobacz monitorowanie metryk użycia i kwerendy oraz wydajność i optymalizację.For more information, see Monitor usage and query metrics and Performance and optimization.

Prawa administratoraAdministrator rights

Inicjowanie obsługi administracyjnej lub likwidowanie samej usługi może odbywać się przez administratora subskrypcji platformy Azure lub współadministratora.Provisioning or decommissioning the service itself can be done by an Azure subscription administrator or co-administrator.

W ramach usługi każda osoba mająca dostęp do adresu URL usługi i klucza API administratora ma dostęp do odczytu i zapisu do usługi.Within a service, anyone with access to the service URL and an admin api-key has read-write access to the service. Dostęp do odczytu i zapisu umożliwia dodawanie, usuwanie i modyfikowanie obiektów serwera, w tym klucze API, indeksy, indeksatory, źródła danych, harmonogramy i przypisania ról, które są implementowane za pomocą ról zdefiniowanychprzez funkcję 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.

Wszystkie interakcje użytkownika z usługą Azure Wyszukiwanie poznawcze mieszczą się w jednym z następujących trybów: dostęp do odczytu i zapisu do usługi (prawa administratora) lub dostęp tylko do odczytu do usługi (uprawnienia zapytania).All user interaction with Azure Cognitive Search falls within one of these modes: read-write access to the service (administrator rights), or read-only access to the service (query rights). Aby uzyskać więcej informacji, zobacz Zarządzanie kluczami interfejsu API.For more information, see Manage the api-keys.

Rejestrowanie i informacje o systemieLogging and system information

Usługa Azure Wyszukiwanie poznawcze nie uwidacznia plików dziennika dla pojedynczej usługi za pomocą portalu ani interfejsów programistycznych.Azure Cognitive Search does not expose log files for an individual service either through the portal or programmatic interfaces. W warstwie Podstawowa i powyżej firma Microsoft monitoruje wszystkie usługi Wyszukiwanie poznawcze platformy Azure pod kątem dostępności na 99,9% według umów dotyczących poziomu usług (SLA).At the Basic tier and above, Microsoft monitors all Azure Cognitive Search services for 99.9% availability per service level agreements (SLA). Jeśli usługa działa wolno lub żądanie przepływności spadnie poniżej progów SLA, zespoły pomocy technicznej Przejrzyj pliki dziennika dostępne dla nich i rozwiąż problem.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.

W zakresie ogólnych informacji o usłudze możesz uzyskać informacje w następujący sposób:In terms of general information about your service, you can obtain information in the following ways:

Monitorowanie użycia zasobówMonitor resource usage

Na pulpicie nawigacyjnym monitorowanie zasobów jest ograniczone do informacji wyświetlanych na pulpicie nawigacyjnym usługi i kilku metryk, które można uzyskać, wykonując zapytania dotyczące usługi.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. Na pulpicie nawigacyjnym usługi, w sekcji użycie, można szybko określić, czy poziomy zasobów partycji są odpowiednie dla aplikacji.On the service dashboard, in the Usage section, you can quickly determine whether partition resource levels are adequate for your application. Możesz zainicjować obsługę zasobów zewnętrznych, takich jak monitorowanie platformy Azure, jeśli chcesz przechwytywać i utrwalać zarejestrowane zdarzenia.You can provision external resources, such as Azure monitoring, if you want to capture and persist logged events. Aby uzyskać więcej informacji, zobacz monitorowanie platformy Azure wyszukiwanie poznawcze.For more information, see Monitoring Azure Cognitive Search.

Korzystając z interfejsu API REST usługi Search, można programowo uzyskać liczbę dokumentów i indeksów:Using the search service REST API, you can get a count on documents and indexes programmatically:

Odzyskiwanie po awarii i awaria usługiDisaster recovery and service outages

Mimo że możemy odzyskać Twoje dane, usługa Azure Wyszukiwanie poznawcze nie zapewnia natychmiastowej pracy w trybie failover w przypadku wystąpienia awarii w klastrze lub na poziomie centrum danych.Although we can salvage your data, Azure Cognitive Search does not provide instant failover of the service if there is an outage at the cluster or data center level. Jeśli klaster ulegnie awarii w centrum danych, zespół operacyjny wykryje i zacznie działać do przywracania usługi.If a cluster fails in the data center, the operations team will detect and work to restore service. Podczas przywracania usługi możesz zażądać kredytów na korzystanie z usługi, aby wyrównać niedostępność usługi na Umowa dotycząca poziomu usług (SLA).You will experience downtime during service restoration, but you can request service credits to compensate for service unavailability per the Service Level Agreement (SLA).

Jeśli ciągła usługa jest wymagana w przypadku wystąpienia awarii poza kontrolą firmy Microsoft, można zainicjować obsługę administracyjną dodatkowej usługi w innym regionie i wdrożyć strategię replikacji geograficznej w celu zapewnienia, że indeksy są w pełni nadmiarowe dla wszystkich usług.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.

Klienci używający indeksatorów do wypełniania i odświeżania indeksów mogą obsługiwać odzyskiwanie po awarii za pomocą indeksatorów specyficznych dla lokalizacji geograficznych wykorzystujących to samo źródło danych.Customers who use indexers to populate and refresh indexes can handle disaster recovery through geo-specific indexers leveraging the same data source. Dwie usługi w różnych regionach, z których każdy uruchamia indeksator, może indeksować to samo źródło danych w celu zapewnienia nadmiarowości geograficznej.Two services in different regions, each running an indexer, could index the same data source to achieve geo-redundancy. W przypadku indeksowania ze źródeł danych, które są również geograficznie nadmiarowe, należy pamiętać, że indeksatory usługi Azure Wyszukiwanie poznawcze mogą wykonywać tylko indeksowanie przyrostowe (Scalanie aktualizacji z nowych, zmodyfikowanych lub usuniętych dokumentów) z replik podstawowych.If you are indexing from data sources that are also geo-redundant, be aware that Azure Cognitive Search indexers can only perform incremental indexing (merging updates from new, modified, or deleted documents) from primary replicas. W przypadku zdarzenia trybu failover Pamiętaj, aby ponownie wskazać indeksator do nowej repliki podstawowej.In a failover event, be sure to re-point the indexer to the new primary replica.

Jeśli nie używasz indeksatorów, użyj kodu aplikacji do wypychania obiektów i danych do różnych usług wyszukiwania równolegle.If you do not use indexers, you would use your application code to push objects and data to different search services in parallel. Aby uzyskać więcej informacji, zobacz wydajność i optymalizacja na platformie Azure wyszukiwanie poznawcze.For more information, see Performance and optimization in Azure Cognitive Search.

Tworzenie kopii zapasowej i przywracanieBackup and restore

Ponieważ platforma Azure Wyszukiwanie poznawcze nie jest podstawowym rozwiązaniem do przechowywania danych, firma Microsoft nie udostępnia formalnego mechanizmu tworzenia kopii zapasowych i przywracania samoobsługowego.Because Azure Cognitive Search is not a primary data storage solution, we do not provide a formal mechanism for self-service backup and restore. Można jednak użyć przykładowego kodu do przywracania kopii zapasowej w ramach tego przykładowego repozytorium platformy Azure wyszukiwanie poznawcze .NET , aby utworzyć kopię zapasową definicji indeksu i migawki do serii plików JSON, a następnie użyć tych plików do przywrócenia indeksu, w razie potrzeby.However, you can use the index-backup-restore sample code in this Azure Cognitive Search .NET sample repo to backup your index definition and snapshot to a series of JSON files, and then use these files to restore the index, if needed. To narzędzie umożliwia również przenoszenie indeksów między warstwami usług.This tool can also move indexes between service tiers.

W przeciwnym razie kod aplikacji używany do tworzenia i wypełniania indeksu jest opcją przywracania de facto w przypadku usunięcia indeksu przez pomyłkę.Otherwise, your application code used for creating and populating an index is the de facto restore option if you delete an index by mistake. Aby ponownie skompilować indeks, należy go usunąć (przy założeniu, że istnieje), ponownie utworzyć indeks w usłudze i załadować ponownie przez pobranie danych z podstawowego magazynu danych.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.

Skalowanie w górę lub w dółScale up or down

Każda usługa wyszukiwania jest uruchamiana z co najmniej jedną repliką i jedną partycją.Every search service starts with a minimum of one replica and one partition. Jeśli zarejestrowano się w celu uzyskania warstwy zapewniającej zasoby dedykowane, kliknij kafelek skalowanie na pulpicie nawigacyjnym usługi, aby dostosować użycie zasobów.If you signed up for a tier that provides dedicated resources, click the SCALE tile in the service dashboard to adjust resource usage.

Po dodaniu pojemności za pośrednictwem dowolnego zasobu usługa korzysta z nich automatycznie.When you add capacity through either resource, the service uses them automatically. W Twojej części nie są wymagane żadne dalsze działania, ale istnieje niewielkie opóźnienie przed zrealizowaniem nowego zasobu.No further action is required on your part, but there is a slight delay before the impact of the new resource is realized. Udostępnienie dodatkowych zasobów może potrwać 15 minut lub dłużej.It can take 15 minutes or more to provision additional resources.

Dodaj replikiAdd replicas

Rosnące zapytania na sekundę (zapytań) lub osiąganie wysokiej dostępności są wykonywane przez dodanie replik.Increasing queries per second (QPS) or achieving high availability is done by adding replicas. Każda replika ma jedną kopię indeksu, więc dodanie jednej repliki tłumaczy do jednego indeksu dostępnego do obsługi żądań zapytań usługi.Each replica has one copy of an index, so adding one more replica translates to one more index available for handling service query requests. Do wysokiej dostępności są wymagane co najmniej 3 repliki (zobacz Planowanie pojemności , aby uzyskać szczegółowe informacje).A minimum of 3 replicas are required for high availability (see Capacity Planning for details).

Usługa wyszukiwania mająca więcej replik może równoważyć obciążenie żądaniami zapytań w większej liczbie indeksów.A search service having more replicas can load balance query requests over a larger number of indexes. Uwzględniając poziom woluminu zapytania, przepływność zapytań jest szybsza, gdy istnieje więcej kopii indeksu dostępnych do obsługi żądania.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. Jeśli występują opóźnienia zapytań, można spodziewać się pozytywnego wpływu na wydajność, gdy dodatkowe repliki są w trybie online.If you are experiencing query latency, you can expect a positive impact on performance once the additional replicas are online.

Mimo że przepływność zapytań jest dodawana podczas dodawania replik, nie jest ona dokładnie podwójna ani potrójna podczas dodawania replik do usługi.Although query throughput goes up as you add replicas, it does not precisely double or triple as you add replicas to your service. Wszystkie aplikacje wyszukiwania podlegają zewnętrznym czynnikom, które mogą wykonywać pingowanie względem wydajności zapytań.All search applications are subject to external factors that can impinge on query performance. Złożone zapytania i opóźnienia sieci to dwa czynniki, które przyczyniają się do wahań czasów odpowiedzi na zapytanie.Complex queries and network latency are two factors that contribute to variations in query response times.

Dodawanie partycjiAdd partitions

Większość aplikacji usługi ma wbudowaną potrzebę tworzenia większej liczby replik, a nie partycji.Most service applications have a built-in need for more replicas rather than partitions. W przypadku, gdy jest wymagana większa liczba dokumentów, można dodać partycje, jeśli utworzono konto w usłudze Standard.For those cases where an increased document count is required, you can add partitions if you signed up for Standard service. Warstwa Podstawowa nie zapewnia dodatkowych partycji.Basic tier does not provide for additional partitions.

W warstwie Standardowa partycje są dodawane w wielokrotnościach 12 (w odróżnieniu od 1, 2, 3, 4, 6 lub 12).At the Standard tier, partitions are added in multiples of 12 (specifically, 1, 2, 3, 4, 6, or 12). To jest artefakt fragmentowania.This is an artifact of sharding. Indeks jest tworzony w 12 fragmentów, który może być przechowywany na 1 partycji lub równo podzielony na 2, 3, 4, 6 lub 12 partycji (jedną fragmentu na partycję).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).

Usuwanie replikRemove replicas

Po upływie okresów dużych ilości zapytań można użyć suwaka, aby zmniejszyć liczbę replik po ukończeniu obciążeń zapytań wyszukiwania.After periods of high query volumes, you can use the slider to reduce replicas after search query loads have normalized (for example, after holiday sales are over). W Twojej części nie są wymagane żadne dalsze czynności.There are no further steps required on your part. Zmniejszenie liczby replik zwalnia maszyny wirtualne w centrum danych.Lowering the replica count relinquishes virtual machines in the data center. Wykonywanie zapytań i operacji pozyskiwania danych zostanie teraz uruchomione na mniejszej liczbie maszyn wirtualnych niż wcześniej.Your query and data ingestion operations will now run on fewer VMs than before. Minimalnym wymaganiem jest jedna replika.The minimum requirement is one replica.

Usuwanie partycjiRemove partitions

W przeciwieństwie do usuwania replik, które nie wymagają żadnych dodatkowych nakładów pracy, może być konieczne wykonanie pewnych zadań w przypadku używania większej ilości miejsca niż można je zmniejszyć.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. Na przykład jeśli Twoje rozwiązanie używa trzech partycji, downsizing do jednej lub dwóch partycji wygeneruje błąd, jeśli nowe miejsce do magazynowania jest mniejsze niż wymagane do hostowania Twojego indeksu.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 for hosting your index. Jak można się spodziewać, wybrane opcje polegają na usunięciu indeksów lub dokumentów w skojarzonym indeksie, aby zwolnić miejsce lub zachować bieżącą konfigurację.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.

Nie ma metody wykrywania informującej, który indeks fragmentów jest przechowywany w określonych partycjach.There is no detection method that tells you which index shards are stored on specific partitions. Każda partycja zapewnia około 25 GB miejsca w magazynie, dlatego należy zmniejszyć ilość miejsca w magazynie do rozmiaru, który można obsłużyć przez liczbę posiadanych partycji.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. Jeśli chcesz przywrócić jedną partycję, należy dopasować wszystkie 12 fragmentów.If you want to revert to one partition, all 12 shards will need to fit.

Aby ułatwić planowanie w przyszłości, warto sprawdzić magazyn (przy użyciu statystyk Get index), aby zobaczyć, ile faktycznie używasz.To help with future planning, you might want to check storage (using Get Index Statistics) to see how much you actually used.

Następne krokiNext steps

Po zrozumieniu koncepcji związanych z administracją usługi należy rozważyć użycie programu PowerShell w celu zautomatyzowania zadań.Once you understand the concepts behind service administration, consider using PowerShell to automate tasks.

Zalecamy również przejrzenie artykułu dotyczącego wydajności i optymalizacji.We also recommend reviewing the performance and optimization article.