Pobieranie statystyk usługi Table Service

Artykuł
08/05/2023

Operacja Get Table Service Stats pobiera statystyki powiązane z replikacją dla usługi Azure Table Storage. Jest ona dostępna tylko w punkcie końcowym lokalizacji pomocniczej, gdy dla konta magazynu jest włączona replikacja geograficznie nadmiarowa dostępu do odczytu.

Żądanie

Żądanie Get Table Service Stats może być skonstruowane w następujący sposób. Zalecamy korzystanie z protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu i zwróć uwagę, że sufiks -secondary jest wymagany:

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
GET	`https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats`	HTTP/1.1

Uwaga

Identyfikator URI musi zawsze zawierać znak ukośnika (/), aby oddzielić nazwę hosta od części ścieżki i zapytania identyfikatora URI. W tej operacji część ścieżki identyfikatora URI jest pusta.

Parametry identyfikatora URI

Dla identyfikatora URI żądania można określić następujące dodatkowe parametry:

Parametr	Opis
`Timeout`	Opcjonalny. Parametr jest wyrażony `timeout` w sekundach.

Nagłówki żądań

Wymagane i opcjonalne nagłówki żądań zostały opisane w poniższej tabeli:

Nagłówek żądania	Opis
`Authorization`	Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
`Date or x-ms-date`	Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
`x-ms-version`	Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla usług Azure Storage.
`x-ms-client-request-id`	Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB) rejestrowanym w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz [Monitorowanie usługi Azure Table Storage.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi

Kod stanu

Pomyślna operacja zwraca kod stanu 200 (OK). Po wywołaniu punktu końcowego lokalizacji pomocniczej, który nie jest włączony dla odczytu pomocniczego, zwraca kod stanu HTTP 403 (Niewystarczające uprawnienia konta).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź zawiera również dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
`x-ms-request-id`	Unikatowo identyfikuje wykonane żądanie i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
`x-ms-version`	Określa wersję operacji, która została użyta dla odpowiedzi. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla usług Azure Storage.
`Date`	Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
`x-ms-client-request-id`	Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi im odpowiedziami. Wartość tego nagłówka jest równa wartości `x-ms-client-request-id` nagłówka, jeśli jest obecna w żądaniu, a wartość zawiera nie więcej niż 1024 widoczne znaki ASCII. `x-ms-client-request-id` Jeśli nagłówek nie znajduje się w żądaniu, nie będzie on obecny w odpowiedzi.

Treść odpowiedzi

Format treści odpowiedzi jest następujący:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>        
      <Status>live|bootstrap|unavailable</Status>  
      <LastSyncTime>sync-time|<empty></LastSyncTime>  
  </GeoReplication>  
</StorageServiceStats>

Elementy treści odpowiedzi opisano w poniższej tabeli:

Nagłówek odpowiedzi Opis

Status Stan lokalizacji pomocniczej. Możliwe wartości:

- live: wskazuje, że lokalizacja pomocnicza jest aktywna i działa.
- bootstrap: wskazuje, że początkowa synchronizacja z lokalizacji podstawowej do lokalizacji pomocniczej jest w toku. Zwykle występuje to, gdy replikacja jest włączona po raz pierwszy.
- niedostępne: wskazuje, że lokalizacja pomocnicza jest tymczasowo niedostępna.

LastSyncTime Wartość daty/godziny UTC do sekundy. Wszystkie podstawowe zapisy, które poprzedzają tę wartość, muszą być dostępne dla operacji odczytu w pomocniczym zapisie. Zapisy podstawowe po tym punkcie w czasie mogą być dostępne dla operacji odczytu lub mogą nie być dostępne.

Wartość może być pusta, jeśli LastSyncTime jest niedostępna. Może się tak zdarzyć, jeśli stan replikacji to bootstrap lub niedostępny.

Mimo że replikacja geograficzna jest stale włączona, LastSyncTime wynik może odzwierciedlać buforowaną wartość z usługi, która jest odświeżona co kilka minut.

Nagłówek odpowiedzi	Opis
`Status`	Stan lokalizacji pomocniczej. Możliwe wartości: - live: wskazuje, że lokalizacja pomocnicza jest aktywna i działa. - bootstrap: wskazuje, że początkowa synchronizacja z lokalizacji podstawowej do lokalizacji pomocniczej jest w toku. Zwykle występuje to, gdy replikacja jest włączona po raz pierwszy. - niedostępne: wskazuje, że lokalizacja pomocnicza jest tymczasowo niedostępna.
`LastSyncTime`	Wartość daty/godziny UTC do sekundy. Wszystkie podstawowe zapisy, które poprzedzają tę wartość, muszą być dostępne dla operacji odczytu w pomocniczym zapisie. Zapisy podstawowe po tym punkcie w czasie mogą być dostępne dla operacji odczytu lub mogą nie być dostępne. Wartość może być pusta, jeśli `LastSyncTime` jest niedostępna. Może się tak zdarzyć, jeśli stan replikacji to bootstrap lub niedostępny. Mimo że replikacja geograficzna jest stale włączona, `LastSyncTime` wynik może odzwierciedlać buforowaną wartość z usługi, która jest odświeżona co kilka minut.

Autoryzacja

Tylko właściciel konta może wywołać tę operację.

Uwagi

Dzięki replikacji geograficznie nadmiarowej usługa Azure Storage utrzymuje dane trwale w dwóch lokalizacjach. W obu lokalizacjach usługa Azure Storage stale utrzymuje wiele replik w dobrej kondycji danych.

Lokalizacja, w której odczytujesz, utworzysz, zaktualizujesz lub usuniesz dane, jest podstawową lokalizacją konta magazynu. Lokalizacja podstawowa istnieje w wybranym regionie podczas tworzenia konta za pośrednictwem klasycznego portalu Azure Management (na przykład Północno-środkowe stany USA).

Lokalizacja, do której są replikowane dane, to lokalizacja pomocnicza . Lokalizacja pomocnicza znajduje się w regionie automatycznie sparowanym geograficznie z regionem podstawowym. Dostęp tylko do odczytu jest dostępny z lokalizacji pomocniczej, jeśli dla konta magazynu włączono replikację geograficznie nadmiarową z dostępem do odczytu .

Aby uzyskać więcej informacji na temat replikacji geograficznie nadmiarowej z dostępem do odczytu, zobacz Nadmiarowość danych.

Aby skonstruować żądanie operacji odczytu względem pomocniczego punktu końcowego, dołącz parametr -secondary do nazwy konta w identyfikatorze URI używanym do odczytu z usługi Table Storage. Na przykład pomocniczy identyfikator URI dla operacji Jednostki zapytania będzie podobny do https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>').

Przykładowe żądanie i odpowiedź

Poniżej przedstawiono przykładowe żądanie dla Get Table Service Stats operacji:

GET http://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats HTTP/1.1

Żądanie jest wysyłane z następującymi nagłówkami:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT  
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=

Kod stanu i nagłówki odpowiedzi są zwracane w następujący sposób:

HTTP/1.1 200 OK  
Content-Type: application/xml  
Date: Wed, 23 Oct 2013 22:08:54 GMT  
x-ms-version: 2013-08-15  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0

Odpowiedź zawiera następującą treść XML:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>  
      <Status>live</Status>  
      <LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>        
  </GeoReplication>  
</StorageServiceStats>

Zobacz też

Operacje na koncie (usługa Table Service)