Documenti

  • Articolo

Azure Cosmos DB è un database multimodello distribuito a livello globale che supporta i modelli di dati document, graph e key-value. Il contenuto di questa sezione consiste nel creare, eseguire query e gestire le risorse del documento usando l'API SQL tramite REST.

La risorsa documento è rappresentata dal docs modello di risorse di Azure Cosmos DB. Un documento è costituito da contenuto definito dall'utente in formato JSON. Oltre alla proprietà ID richiesta, gli utenti possono definire eventuali elementi, strutture e gerarchie arbitrarie per il contenuto. L'elemento ID è una stringa univoca che è impostata dall'utente e non deve superare i 255 caratteri. È possibile inserire, sostituire, eliminare, leggere, enumerare ed eseguire query in documenti JSON arbitrari in una raccolta.

Azure Cosmos DB non richiede alcun schema o indici secondari per supportare l'esecuzione di query su documenti in una raccolta. Per impostazione predefinita, i documenti vengono indicizzati automaticamente e indicizzati in modo coerente, rendendo quindi un documento eseguibile non appena viene creato.

  • I documenti vengono archiviati all'interno di raccolte. Per altre informazioni sulle raccolte, vedere Raccolte.
  • Un documento può contenere uno o più allegati. Per altre informazioni sugli allegati, vedere Allegati.
  • L'accesso utente ai documenti può essere gestito tramite autorizzazioni. Per altre informazioni sulle autorizzazioni, vedere Autorizzazioni.

Questo documento JSON di esempio mostra la voce di un vulcano in una raccolta. La voce include il nome del vulcano, le informazioni sulla posizione, inclusi i dati geospaziali e gli elementi definiti dal sistema, ad esempio _rid, _ts, _self, _etag e _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/"  
}
Proprietà Descrizione
id Obbligatorio. È una proprietà impostabile dall'utente. È il nome univoco che identifica il documento, ovvero nessun documento condivide lo stesso ID all'interno di una partizione logica. La partizione e l'ID identificano in modo univoco un elemento nel database. Il campo ID non deve superare i 255 caratteri.
_rid Si tratta di una proprietà generata dal sistema. L'ID risorsa (_rid) è un identificatore univoco che è anche gerarchico per ogni stack di risorse nel modello di risorsa. Viene usato internamente per il posizionamento e l'esplorazione della risorsa documento.
_Ts Si tratta di una proprietà generata dal sistema. Indica il timestamp dell'ultimo aggiornamento della risorsa. Il valore è un timestamp.
_stesso Si tratta di una proprietà generata dal sistema. URI indirizzabile univoco per la risorsa.
_Etag Si tratta di una proprietà generata dal sistema che specifica l'etag della risorsa necessaria per il controllo di concorrenza ottimistica.
_Allegati Si tratta di una proprietà generata dal sistema che specifica il percorso indirizzabile per la risorsa allegati.

Attività

È possibile eseguire le attività seguenti con documenti:

Vedere anche