Delen via

Documenten

  • Artikel

Azure Cosmos DB is een wereldwijd gedistribueerde database met meerdere modellen die ondersteuning biedt voor de document-, grafiek- en sleutelwaardegegevensmodellen. De inhoud in deze sectie is bedoeld voor het maken, opvragen en beheren van documentresources met behulp van de SQL API via REST.

De documentresource wordt vertegenwoordigd door docs in het Azure Cosmos DB-resourcemodel. Een document bestaat uit door de gebruiker gedefinieerde inhoud in JSON-indeling. Afgezien van de vereiste id-eigenschap, kunnen gebruikers willekeurige elementen, structuren en hiërarchieën voor de inhoud definiëren. Het id-element is een unieke tekenreeks die door de gebruiker kan worden ingesteld en die niet langer mag zijn dan 255 tekens. U kunt willekeurige JSON-documenten invoegen, vervangen, verwijderen, lezen, inventariseren en query's uitvoeren in een verzameling.

Azure Cosmos DB vereist geen schema of secundaire indexen om het uitvoeren van query's op documenten in een verzameling te ondersteunen. Documenten worden standaard automatisch en op een consistente manier geïndexeerd, waardoor er op een document query's kunnen worden uitgevoerd zodra het is gemaakt.

  • Documenten worden opgeslagen in verzamelingen. Zie Verzamelingen voor meer informatie over verzamelingen.
  • Een document kan een of meer bijlagen bevatten. Zie Bijlagen voor meer informatie over bijlagen.
  • Gebruikerstoegang tot documenten kan worden beheerd via machtigingen. Zie Machtigingen voor meer informatie over machtigingen.

Dit JSON-voorbeelddocument toont de vermelding voor een vulkaan in een verzameling. De vermelding bevat de naam van de vulkaan, locatiegegevens, inclusief georuimtelijke gegevens en door het systeem gedefinieerde elementen, zoals _rid, _ts, _self, _etag en _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/"  
}
Eigenschap Beschrijving
id Vereist. Het is een eigenschap die door de gebruiker kan worden ingesteld. Het is de unieke naam die het document identificeert, dat wil gezegd dat geen twee documenten dezelfde id delen binnen een logische partitie. Partitie en id identificeren een item in de database op unieke wijze. Het id-veld mag niet langer zijn dan 255 tekens.
_Ontdoen Het is een door het systeem gegenereerde eigenschap. De resource-id (_rid) is een unieke id die ook hiërarchisch is per resourcestack in het resourcemodel. De id wordt intern gebruikt voor het plaatsen van en navigeren naar de documentresource.
_Ts Het is een door het systeem gegenereerde eigenschap. Hiermee wordt de tijdstempel van de resource voor het laatst bijgewerkt. De waarde is een tijdstempel.
_Zelf Het is een door het systeem gegenereerde eigenschap. Dit is de unieke adresseerbare URI voor de resource.
_etag Het is een door het systeem gegenereerde eigenschap die de resource-etag aangeeft die is vereist voor optimistisch gelijktijdigheidsbeheer.
_Bijlagen Het is een door het systeem gegenereerde eigenschap die het adresseerbare pad voor de resource bijlagen aangeeft.

Taken

U kunt de volgende taken uitvoeren met documenten:

Zie ook