Belgeler

  • Makale

Azure Cosmos DB , belge, grafik ve anahtar-değer veri modellerini destekleyen genel olarak dağıtılmış çok modelli bir veritabanıdır. Bu bölümdeki içerik, REST aracılığıyla SQL API'sini kullanarak belge kaynaklarını oluşturmaya, sorgulamaya ve yönetmeye yöneliktir.

Belge kaynağı, Azure Cosmos DB kaynak modelinde tarafından docs temsil edilir. Belge, JSON biçiminde kullanıcı tanımlı içeriklerden oluşur. Kullanıcılar, gerekli kimlik özelliğinin yanı sıra içerik için rastgele öğeleri, yapıları ve hiyerarşileri tanımlayabilir. Id öğesi, kullanıcı tarafından ayarlanabilir ve 255 karakteri aşmaması gereken benzersiz bir dizedir. Bir koleksiyonda rastgele JSON belgeleri ekleyebilir, değiştirebilir, silebilir, okuyabilir, numaralandırabilir ve sorgulayabilirsiniz.

Azure Cosmos DB, bir koleksiyondaki belgeler üzerinde sorgulamayı desteklemek için herhangi bir şema veya ikincil dizin gerektirmez. Varsayılan olarak, belgeler otomatik olarak ve tutarlı bir şekilde dizinlenir, böylece belge oluşturulur oluşturulmaz sorgulanabilir hale gelir.

  • Belgeler koleksiyonlar içinde depolanır. Koleksiyonlar hakkında daha fazla bilgi için bkz. Koleksiyonlar.
  • Belge bir veya daha fazla ek içerebilir. Ekler hakkında daha fazla bilgi için bkz. Ekler.
  • Belgelere kullanıcı erişimi izinler aracılığıyla yönetilebilir. İzinler hakkında daha fazla bilgi için bkz. İzinler.

Bu örnek JSON belgesi, bir koleksiyondaki bir volkanın girişini gösterir. Giriş volkan adını, jeo-uzamsal verileri içeren konum bilgilerini ve _rid, _ts, _self, _etag ve _attachments gibi sistem tanımlı öğeleri içerir.

{  
  "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/"  
}
Özellik Açıklama
id Gereklidir. Bu bir kullanıcı ayarlanabilir özelliğidir. Belgeyi tanımlayan benzersiz addır; başka bir ifadeyle, mantıksal bölüm içinde aynı kimliği paylaşan iki belge yoktur. Bölüm ve kimlik, veritabanındaki bir öğeyi benzersiz olarak tanımlar. Kimlik alanı 255 karakteri aşmamalıdır.
_Kurtulmak Sistem tarafından oluşturulan bir özelliktir. Kaynak kimliği (_rid), kaynak modelinde kaynak yığını başına da hiyerarşik olan benzersiz bir tanımlayıcıdır. Belge kaynağının yerleştirilmesi ve gezinti için uygulama tarafından kullanılır.
_Ts Sistem tarafından oluşturulan bir özelliktir. Kaynağın son güncelleştirilen zaman damgasını belirtir. Değer bir zaman damgasıdır.
_Kendini Sistem tarafından oluşturulan bir özelliktir. Kaynak için benzersiz adreslenebilir URI'dir.
_Etag İyimser eşzamanlılık denetimi için gereken kaynak etiketini belirten sistem tarafından oluşturulan bir özelliktir.
_Ekleri Ekler kaynağı için adreslenebilir yolu belirten sistem tarafından oluşturulan bir özelliktir.

Görevler

Belgelerle aşağıdaki görevleri gerçekleştirebilirsiniz:

Ayrıca Bkz.