Ekler

  • Makale

Azure Cosmos DB , belge, grafik, cassandra ve tablo 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 ek kaynaklarını yönetmeye yöneliktir.

Ekler, dış blob veya medya dosyasıyla ilişkili meta verileri ve başvuruları içeren özel belgelerdir.

Geliştiriciler şu seçenekleri belirleyebilir:

  • Azure Cosmos DB tarafından yönetilen ek medyası/blobu veya
  • OneDrive, Dropbox vb. gibi bir dış blob hizmeti sağlayıcısıyla depolayın. ve ek için başvuru meta verilerini Azure Cosmos DB'de depolayın.

Ek kaynağı, Azure Cosmos DB REST kaynak modelindeki eklerle temsil edilir. Ek kaynağının sabit bir şeması var. Ham medyanın nerede depolandığına bakılmaksızın, aşağıdaki özellikler gereklidir.

Aşağıdaki örnekte belge ekinin JSON yapısı gösterilmektedir.

{    
   "id":"image13d65101-90c4-4c2a-a423-fbf221c73233",  
   "contentType":"image/jpg",  
   "media":"www.bing.com",  
   "_rid":"rnYYAMVFUAUBAAAAAAAAAEC+LNM=",  
   "_ts":1408056025,  
   "_self":"dbs\/rnYYAA==\/colls\/rnYYAMVFUAU=\/docs\/rnYYAMVFUAUBAAAAAAAAAA==\/attachments\/rnYYAMVFUAUBAAAAAAAAAEC+LNM=",  
   "_etag":"00002a00-0000-0000-0000-53ed3ad90000"  
}
Özellik Açıklama
id Gereklidir. Bu bir kullanıcı ayarlanabilir özelliğidir. Eki tanımlayan benzersiz addır; başka bir ifadeyle, aynı belge için aynı kimliği paylaşan iki ek yoktur. Kimlik 255 karakteri aşmamalıdır.
contentType Gereklidir. Bu bir kullanıcı ayarlanabilir özelliğidir. Ekin içerik türünü belirtir. Ek bitlerini gövde olarak gönderirken, Cosmos DB üst bilgide Content-Type ayarlanan türe ayarlarcontentType.
Media Gereklidir. Bu, ekin bulunduğu URL bağlantısı veya dosya yoludur.
_rid 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. Ek kaynağının yerleştirilmesi ve gezinmesi için dahili olarak 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.
_self 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.

Ortak yanıt üst bilgileri

Aşağıdaki bilgiler eklerle ilgili tüm yanıtlarda ortaktır:

Üst bilgi Description
x-ms-max-media-storage-usage-mb Ham medyayı depolamak için Cosmos DB ek depolama alanı kullanılırken, bu üst bilgi hesap için ayrılan toplam ek depolama kotasını gösterir.
x-ms-media-storage-usage-mb Ham medyayı depolamak için Cosmos DB ek depolama alanı kullanılırken, bu üst bilgi kullanılan geçerli ek depolama alanını gösterir.

Görevler

Bu görevleri eklerle gerçekleştirebilirsiniz:

Ek içeriği dizine alınmaz veya aranamaz; ek kaynağı özellikleri dizine eklenir ve aranabilir.

Bu işlemler Belgeler'e benzer. İşlemleri belgelere karşı gerçekleştirmek yerine, belirli bir belgenin altındaki ekler kaynak yolunda gerçekleştirilir. Bu nedenle, işlemlerin her birini detaylandırmayı atlayacağız. Bunun yerine, bir sonraki bölümde ham medya gönderme ve yalnızca meta veri gönderme ile ek oluşturmayı ele alacaktır.

Ayrıca Bkz.