Table Service-statisztikák lekérése

Cikk
08/05/2023

A Get Table Service Stats művelet lekéri az Azure Table Storage replikációval kapcsolatos statisztikáit. Csak a másodlagos hely végpontján érhető el, ha az olvasási hozzáférés georedundáns replikációja engedélyezve van a tárfiókhoz.

Kérés

A Get Table Service Stats kérelem a következőképpen hozható létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount nevet a tárfiók nevére, és vegye figyelembe, hogy a -secondary utótagra van szükség:

Metódus	Kérés URI-ja	HTTP-verzió
GET	`https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats`	HTTP/1.1

Megjegyzés

Az URI-nak mindig tartalmaznia kell egy perjel karaktert (/), amely elválasztja a gazdagépnevet az URI elérési útjától és lekérdezési részeitől. Ebben a műveletben az URI elérési útja üres.

URI-paraméterek

A kérelem URI-ja a következő további paramétereket határozhatja meg:

Paraméter	Leírás
`Timeout`	Választható. A `timeout` paraméter másodpercben van kifejezve.

Kérésfejlécek

A szükséges és nem kötelező kérésfejléceket az alábbi táblázatban ismertetjük:

Kérelem fejléce	Leírás
`Authorization`	Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba.
`Date or x-ms-date`	Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérések engedélyezése az Azure Storage-ba.
`x-ms-version`	Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
`x-ms-client-request-id`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kib-os (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: [Az Azure Table Storage monitorozása.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset

Állapotkód

A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza. Ha olyan másodlagos helyvégponton hívja meg, amely nincs engedélyezve a másodlagos olvasáshoz, a 403-at (nem megfelelő fiókengedélyek) tartalmazó HTTP-állapotkódot adja vissza.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmaz. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	Description
`x-ms-request-id`	Egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
`x-ms-version`	A művelet válaszhoz használt verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
`Date`	A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi.
`x-ms-client-request-id`	A kérések és a hozzájuk tartozó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a `x-ms-client-request-id` fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a `x-ms-client-request-id` fejléc nem szerepel a kérelemben, az nem jelenik meg a válaszban.

Választörzs

A válasz törzsének formátuma a következő:

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

A választörzs elemeit a következő táblázat ismerteti:

Válaszfejléc Description

Status A másodlagos hely állapota. Lehetséges értékek:

- live: Azt jelzi, hogy a másodlagos hely aktív és működőképes.
- bootstrap: Azt jelzi, hogy az elsődleges helyről a másodlagos helyre történő kezdeti szinkronizálás folyamatban van. Ez általában akkor fordul elő, ha a replikáció először engedélyezve van.
- nem érhető el: Azt jelzi, hogy a másodlagos hely átmenetileg nem érhető el.

LastSyncTime UTC dátum/idő érték, a másodpercig. Az értéket megelőző összes elsődleges írás garantáltan elérhető lesz a másodlagos írási műveletekhez. Előfordulhat, hogy az elsődleges írások ezt az időpontot követően nem érhetők el olvasásra.

Az érték üres lehet, ha LastSyncTime nem érhető el. Ez akkor fordulhat elő, ha a replikáció állapota bootstrap vagy nem érhető el.

Bár a georeplikáció folyamatosan engedélyezve van, az LastSyncTime eredmény a szolgáltatás néhány percenként frissülő gyorsítótárazott értékét tükrözheti.

Válaszfejléc	Description
`Status`	A másodlagos hely állapota. Lehetséges értékek: - live: Azt jelzi, hogy a másodlagos hely aktív és működőképes. - bootstrap: Azt jelzi, hogy az elsődleges helyről a másodlagos helyre történő kezdeti szinkronizálás folyamatban van. Ez általában akkor fordul elő, ha a replikáció először engedélyezve van. - nem érhető el: Azt jelzi, hogy a másodlagos hely átmenetileg nem érhető el.
`LastSyncTime`	UTC dátum/idő érték, a másodpercig. Az értéket megelőző összes elsődleges írás garantáltan elérhető lesz a másodlagos írási műveletekhez. Előfordulhat, hogy az elsődleges írások ezt az időpontot követően nem érhetők el olvasásra. Az érték üres lehet, ha `LastSyncTime` nem érhető el. Ez akkor fordulhat elő, ha a replikáció állapota bootstrap vagy nem érhető el. Bár a georeplikáció folyamatosan engedélyezve van, az `LastSyncTime` eredmény a szolgáltatás néhány percenként frissülő gyorsítótárazott értékét tükrözheti.

Engedélyezés

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

A georedundáns replikációval az Azure Storage két helyen tartja tartósan az adatokat. Az Azure Storage mindkét helyen folyamatosan fenntartja az adatok több kifogástalan állapotú replikáját.

Az adatok olvasási, létrehozási, frissítési vagy törlési helye az elsődleges tárfiók helye. Az elsődleges hely abban a régióban található, amely akkor van kiválasztva, ha a klasszikus Azure Management Azure-portálon (például az USA északi középső régióján) keresztül hoz létre fiókot.

Az adatok replikálásának helye a másodlagos hely. A másodlagos hely egy olyan régióban található, amely automatikusan földrajzilag párosítva van az elsődleges régióval. Az írásvédett hozzáférés a másodlagos helyről érhető el, ha az olvasási hozzáférés georedundáns replikációja engedélyezve van a tárfiókban.

További információ az olvasási hozzáférés georedundáns replikációjáról: Adatredundancia.

Ha olvasási műveletre vonatkozó kérést szeretne létrehozni a másodlagos végponton, fűzze hozzá a -secondary parancsot a Table Storage-ból olvasáshoz használt URI-fióknévhez. A Lekérdezési entitások művelet másodlagos URI-ja például hasonló lesz a következőhöz: https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>').

Mintakérés és válasz

A műveletre vonatkozó mintakérés a Get Table Service Stats következő:

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

A kérést a rendszer a következő fejlécekkel küldi el:

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

Az állapotkód és a válaszfejlécek a következőképpen lesznek visszaadva:

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

A válasz a következő XML-törzset tartalmazza:

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

Lásd még

A fiók műveletei (Table Service)