Získání statistik služby Table Service

Článek
08/05/2023

Operace Get Table Service Stats načte statistiky související s replikací pro Azure Table Storage. Je k dispozici pouze v sekundárním koncovém bodu umístění, pokud je pro účet úložiště povolená geograficky redundantní replikace s přístupem pro čtení.

Žádost

Požadavek Get Table Service Stats může být vytvořen následujícím způsobem. Doporučujeme použít https. Nahraďte myaccount názvem vašeho účtu úložiště a všimněte si, že je vyžadována přípona -secondary :

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	`https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats`	HTTP/1.1

Poznámka

Identifikátor URI musí vždy obsahovat znak lomítka (/), aby se název hostitele oddělil od části cesty a dotazu identifikátoru URI. V této operaci je část cesty identifikátoru URI prázdná.

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry:

Parametr	Popis
`Timeout`	Nepovinný parametr. Parametr `timeout` je vyjádřen v sekundách.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

Hlavička požadavku	Popis
`Authorization`	Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`Date or x-ms-date`	Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`x-ms-version`	Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu [Monitorování služby Azure Table Storage.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK). Když se volá na sekundárním koncovém bodu umístění, který nemá povolené sekundární čtení, vrátí stavový kód HTTP 403 (Nedostatečná oprávnění účtu).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď obsahuje také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi	Description
`x-ms-request-id`	Jedinečně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
`x-ms-version`	Určuje verzi operace, která byla použita pro odpověď. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`Date`	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
`x-ms-client-request-id`	Dá se použít k řešení potíží s požadavky a jejich odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě `x-ms-client-request-id` hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička `x-ms-client-request-id` v požadavku není, nebude v odpovědi.

Text odpovědi

Text odpovědi má následující formát:

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

Prvky textu odpovědi jsou popsané v následující tabulce:

Hlavička odpovědi Description

Status Stav sekundárního umístění. Možné hodnoty:

- live: Označuje, že sekundární umístění je aktivní a funkční.
- bootstrap: Označuje, že probíhá počáteční synchronizace z primárního umístění do sekundárního umístění. K tomu obvykle dochází při prvním povolení replikace.
- nedostupné: Označuje, že sekundární umístění je dočasně nedostupné.

LastSyncTime Hodnota data a času UTC na sekundu. U všech primárních zápisů, které předcházejí této hodnotě, je zaručeno, že budou k dispozici pro operace čtení v sekundárním zápisu. Primární zápisy po tomto bodu v čase můžou nebo nemusí být pro čtení k dispozici.

Pokud je hodnota nedostupná, může být prázdná LastSyncTime . K tomu může dojít v případě, že je stav replikace bootstrap nebo není k dispozici.

Přestože je geografická replikace nepřetržitě povolená, LastSyncTime výsledek může odrážet hodnotu uloženou v mezipaměti ze služby, která se aktualizuje každých několik minut.

Hlavička odpovědi	Description
`Status`	Stav sekundárního umístění. Možné hodnoty: - live: Označuje, že sekundární umístění je aktivní a funkční. - bootstrap: Označuje, že probíhá počáteční synchronizace z primárního umístění do sekundárního umístění. K tomu obvykle dochází při prvním povolení replikace. - nedostupné: Označuje, že sekundární umístění je dočasně nedostupné.
`LastSyncTime`	Hodnota data a času UTC na sekundu. U všech primárních zápisů, které předcházejí této hodnotě, je zaručeno, že budou k dispozici pro operace čtení v sekundárním zápisu. Primární zápisy po tomto bodu v čase můžou nebo nemusí být pro čtení k dispozici. Pokud je hodnota nedostupná, může být prázdná `LastSyncTime` . K tomu může dojít v případě, že je stav replikace bootstrap nebo není k dispozici. Přestože je geografická replikace nepřetržitě povolená, `LastSyncTime` výsledek může odrážet hodnotu uloženou v mezipaměti ze služby, která se aktualizuje každých několik minut.

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Díky geograficky redundantní replikaci azure storage trvale udržuje vaše data ve dvou umístěních. V obou umístěních Azure Storage neustále udržuje několik replik dat, které jsou v pořádku.

Umístění, kde čtete, vytváříte, aktualizujete nebo odstraňujete data, je primární umístění účtu úložiště. Primární umístění existuje v oblasti, kterou zvolíte při vytváření účtu prostřednictvím portálu Azure Management Azure Classic (například USA – středosever).

Umístění, do kterého se data replikují, je sekundární umístění. Sekundární umístění se nachází v oblasti, která je automaticky geograficky spárovaná s primární oblastí. Přístup jen pro čtení je k dispozici ze sekundárního umístění, pokud je pro váš účet úložiště povolená geograficky redundantní replikace s přístupem pro čtení .

Další informace o geograficky redundantní replikaci s přístupem pro čtení najdete v tématu Redundance dat.

Pokud chcete vytvořit požadavek na operaci čtení pro sekundární koncový bod, připojte k názvu účtu v identifikátoru URI, který používáte ke čtení ze služby Table Storage, parametr -secondary . Například sekundární identifikátor URI pro operaci Entity dotazu bude podobný https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>')jako .

Ukázkový požadavek a odpověď

Následuje ukázkový požadavek pro Get Table Service Stats operaci:

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

Požadavek se odešle s následujícími hlavičkami:

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

Stavový kód a hlavičky odpovědi se vrátí takto:

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

Odpověď obsahuje následující text 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>

Viz také

Operace s účtem (Table Service)