Dokumenty

  • Artykuł

Usługa Azure Cosmos DB to globalnie rozproszona wielomodelowa baza danych, która obsługuje modele danych dokumentów, grafów i klucz-wartość. Zawartość tej sekcji służy do tworzenia, wykonywania zapytań i zarządzania zasobami dokumentów przy użyciu interfejsu API SQL za pośrednictwem interfejsu API REST.

Zasób dokumentu jest reprezentowany przez docs model zasobów usługi Azure Cosmos DB. Dokument składa się z zawartości zdefiniowanej przez użytkownika w formacie JSON. Oprócz wymaganej właściwości ID użytkownicy mogą definiować dowolne elementy, struktury i hierarchie zawartości. Element ID jest unikatowym ciągiem, który jest ustawiany przez użytkownika i nie może przekraczać 255 znaków. W kolekcji można wstawiać, zastępować, usuwać, odczytywać, wyliczać i wykonywać zapytania względem dowolnych dokumentów JSON.

Usługa Azure Cosmos DB nie wymaga żadnego schematu ani indeksów pomocniczych w celu obsługi wykonywania zapytań dotyczących dokumentów w kolekcji. Domyślnie dokumenty są automatycznie i indeksowane w spójny sposób, dzięki czemu dokument można wykonywać zapytania zaraz po jego utworzeniu.

  • Dokumenty są przechowywane w kolekcjach. Aby uzyskać więcej informacji na temat kolekcji, zobacz Kolekcje.
  • Dokument może zawierać co najmniej jeden załącznik. Aby uzyskać więcej informacji na temat załączników, zobacz Załączniki.
  • Dostęp użytkowników do dokumentów można zarządzać za pomocą uprawnień. Aby uzyskać więcej informacji na temat uprawnień, zobacz Uprawnienia.

Ten przykładowy dokument JSON przedstawia wpis wulkanu w kolekcji. Wpis zawiera nazwę wulkanu, informacje o lokalizacji, w tym dane geoprzestrzenne oraz zdefiniowane elementy systemu, takie jak _rid, _ts, _self, _etag i _attachments.

{  
  "Volcano Name": "Agua de Pau",  
  "Country": "Portugal",  
  "Region": "Azores",  
  "Location": {  
    "type": "Point",  
    "coordinates": [  
      -25.47,  
      37.77  
    ]  
  },  
  "Elevation": 947,  
  "Type": "Stratovolcano",  
  "Status": "Historical",  
  "Last Known Eruption": "Last known eruption from 1500-1699, inclusive",  
  "id": "d44c94b6-81f8-4b27-4970-f79b149529d3",  
  "_rid": "Sl8fALN4sw4BAAAAAAAAAA==",  
  "_ts": 1448049512,  
  "_self": "dbs/Sl8fAA==/colls/Sl8fALN4sw4=/docs/Sl8fALN4sw4BAAAAAAAAAA==/",  
  "_etag": "\"0000443f-0000-0000-0000-564f7b680000\"",  
  "_attachments": "attachments/"  
}
Właściwość Opis
id Wymagane. Jest to właściwość ustawiana przez użytkownika. Jest to unikatowa nazwa, która identyfikuje dokument, czyli żadne dwa dokumenty nie mają tego samego identyfikatora w partycji logicznej. Partycja i identyfikator jednoznacznie identyfikuje element w bazie danych. Pole identyfikatora nie może przekraczać 255 znaków.
_Rid Jest to właściwość wygenerowana przez system. Identyfikator zasobu (_rid) to unikatowy identyfikator, który jest również hierarchiczny dla stosu zasobów w modelu zasobów. Jest on używany wewnętrznie do umieszczania zasobu dokumentu i nawigacji po nim.
_Ts Jest to właściwość wygenerowana przez system. Określa ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu.
_Własny Jest to właściwość wygenerowana przez system. Jest to unikatowy adresowy identyfikator URI zasobu.
_Etag Jest to właściwość wygenerowana przez system, która określa tag zasobu wymagany do optymistycznej kontrolki współbieżności.
_Załączniki Jest to właściwość wygenerowana przez system, która określa ścieżkę adresową zasobu załączników.

Zadania

Za pomocą dokumentów można wykonywać następujące zadania:

Zobacz też