Partíciókulcs-tartományok lekérése

  • Cikk

GET Egy adott gyűjtemény pkranges gyermekerőforrásán végzett műveletek lekéri a gyűjtemény partíciókulcs-tartományainak listáját.

Megjegyzés

Ezek az API-referenciacikkek bemutatják, hogyan hozhat létre erőforrásokat az Azure Cosmos DB adatsík API-val. Az adatsík API-val olyan alapvető beállításokat konfigurálhat, mint például az indexelési szabályzat, a partíciókulcsok ugyanúgy, mint a Cosmos DB SDK-k esetében. Ha teljes körű szolgáltatástámogatásra van szüksége az összes Azure Cosmos DB-erőforráshoz, javasoljuk, hogy használja a Cosmos DB erőforrás-szolgáltatót.

Kérés

Metódus Kérés URI-ja Leírás
GET https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/pkranges Vegye figyelembe, hogy az az {databaseaccount} előfizetése alatt létrehozott Azure Cosmos DB-fiók neve. Az {db-id} adatbázis azonosítója és a {coll-id} érték a gyűjtemény azonosítója.

Fejlécek

Az összes Cosmos DB-kérés által használt fejlécekhez tekintse meg az Azure Cosmos DB REST-kérések gyakori fejléceit .

Törzs

Nincsenek.

Reagálás

A gyűjtemény partíciókulcs-tartományainak listáját adja vissza.

Fejlécek

Az összes Cosmos DB-válasz által visszaadott fejlécekhez tekintse meg az Azure Cosmos DB REST-válaszfejléceit .

Állapotkódok

Az alábbi táblázat a művelet által visszaadott gyakori állapotkódokat sorolja fel. Az állapotkódok teljes listáját lásd: HTTP-állapotkódok.

HTTP-állapotkód Leírás
200 Ok A művelet sikeres volt.
404 Nem található A gyűjtemény nem található.

Törzs

Tulajdonság Leírás
id Ez a gyűjteményt azonosító egyedi név.
_rid Ez egy rendszer által létrehozott tulajdonság. Az erőforrás-azonosító (_rid) egy egyedi azonosító, amely szintén hierarchikus az erőforrásmodell erőforrás-vermén. Belsőleg használják az engedélyerőforrás elhelyezésére és navigációjára.
_ts Ez egy rendszer által létrehozott tulajdonság. Meghatározza az erőforrás utolsó frissített időbélyegét. Az érték egy időbélyeg.
_self Ez egy rendszer által létrehozott tulajdonság. Ez az erőforrás egyedi címezhető URI-ja.
_etag Ez egy rendszer által létrehozott tulajdonság, amely az optimista egyidejűség-vezérléshez szükséges erőforrást etag jelöli.
PartitionKeyRanges Ez a gyűjtemény partíciókulcs-tartományainak listája. Ez a fejléc növekményes olvasásához x-ms-documentdb-partitionkeyrangeid használható.

A PartitionKeyRanges tulajdonságai

Tulajdonság Leírás
id

A partíciókulcs-tartomány azonosítója. Ez egy stabil és egyedi azonosító minden gyűjteményben.

A dokumentumokat partíciókulcs-tartomány szerint lehet olvasni.
maxExclusive A partíciókulcs-tartomány maximális partíciókulcs-kivonatának értéke. Belső használatra.
minInclusive A partíciókulcs-tartomány minimális partíciókulcs-kivonatának értéke. Belső használatra.

Példa

A partíciókulcs-tartományok lekéréséhez kérje le az pkranges erőforrást egy gyűjteményen belül. A következő kérés például lekéri a gyűjtemény partíciókulcs-tartományainak serverlogs listáját:

    GET https://querydemo.documents.azure.com/dbs/bigdb/colls/serverlogs/pkranges HTTP/1.1
    x-ms.date: 04/20/2021
    authorization: type%3dmaster%26ver%3d1.0%26sig%3dEConYmRgDExu6q%2bZ8GjfUGOH0AcOx%2behkancw3LsGQ8%3d
    x-ms-consistency-level: Session
    x-ms-version: 2016-07-11
    Accept: application/json
    Host: querydemo.documents.azure.com

Ez a kérés a partíciókulcs-tartományok metaadatait tartalmazó alábbi választ adja vissza:

    HTTP/1.1 200 Ok
    Content-Type: application/json
    x-ms-item-count: 25
    x-ms-schemaversion: 1.1
    Date: Tue, 15 Nov 2016 07:26:51 GMT

    {
       "_rid":"qYcAAPEvJBQ=",
       "PartitionKeyRanges":[
          {
             "_rid":"qYcAAPEvJBQCAAAAAAAAUA==",
             "id":"0",
             "_etag":"\"00002800-0000-0000-0000-580ac4ea0000\"",
             "minInclusive":"",
             "maxExclusive":"05C1CFFFFFFFF8",
             "_self":"dbs\/qYcAAA==\/colls\/qYcAAPEvJBQ=\/pkranges\/qYcAAPEvJBQCAAAAAAAAUA==\/",
             "_ts":1477100776
          },
          ...
       ],
       "_count": 25
    }

Lásd még: