Udostępnij za pośrednictwem

Załączniki

  • Artykuł

Azure Cosmos DB to globalnie rozproszona wielomodelowa baza danych, która obsługuje modele danych dokumentów, grafów, cassandra i tabel. Zawartość w tej sekcji służy do zarządzania zasobami załączników przy użyciu interfejsu API SQL za pośrednictwem interfejsu REST.

Załączniki to specjalne dokumenty zawierające odwołania i skojarzone metadane z zewnętrznym plikiem obiektów blob lub multimediów.

Deweloperzy mogą wybrać następujące możliwości:

  • Nośnik załączników/obiekt blob zarządzany przez usługę Azure Cosmos DB lub
  • Zapisz go za pomocą zewnętrznego dostawcy usług obiektów blob, takiego jak OneDrive, Dropbox itp. i przechowuj metadane referencyjne dla załącznika w usłudze Azure Cosmos DB.

Zasób załącznika jest reprezentowany przez załączniki w modelu zasobów REST usługi Azure Cosmos DB. Zasób załącznika ma stały schemat. Niezależnie od tego, gdzie są przechowywane nieprzetworzone nośniki, wymagane są następujące właściwości.

Poniższy przykład ilustruje konstrukcję JSON załącznika dokumentu.

{    
   "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"  
}
Właściwość Opis
id Wymagane. Jest to właściwość ustawiana przez użytkownika. Jest to unikatowa nazwa identyfikująca załącznik, czyli nie ma dwóch załączników współużytkujących ten sam identyfikator dla tego samego dokumentu. Identyfikator nie może przekraczać 255 znaków.
contentType Wymagane. Jest to właściwość ustawiana przez użytkownika. Określa typ zawartości załącznika. Podczas przesyłania bitów załącznika jako treści usługa Cosmos DB ustawia contentType typ ustawiony w nagłówku Content-Type .
Media Wymagane. Jest to link adresu URL lub ścieżka pliku, w której znajduje się załącznik.
_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 i nawigacji zasobu załącznika.
_ts Jest to właściwość wygenerowana przez system. Określa ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu.
_self 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 kontroli współbieżności.

Typowe nagłówki odpowiedzi

Następujące informacje są wspólne dla wszystkich odpowiedzi związanych z załącznikami:

Nagłówek Opis
x-ms-max-media-storage-usage-mb W przypadku używania magazynu załączników usługi Cosmos DB do przechowywania nieprzetworzonych multimediów ten nagłówek przedstawia łączny przydział przydziału magazynu załączników przydzielonych dla konta.
x-ms-media-storage-usage-mb W przypadku używania magazynu załączników usługi Cosmos DB do przechowywania nieprzetworzonych multimediów w tym nagłówku jest wyświetlany bieżący używany magazyn załączników.

Zadania

Te zadania można wykonywać za pomocą załączników:

Zawartość załącznika nie jest indeksowana ani przeszukiwalna; właściwości zasobu załącznika są indeksowane i można je przeszukiwać.

Te operacje są podobne do tych dla dokumentów. Zamiast wykonywać operacje względem dokumentów, są one wykonywane względem ścieżki zasobu załączników w określonym dokumencie. W związku z tym pominiemy opracowanie każdej z operacji. Zamiast tego w następnej sekcji omówimy sposób tworzenia załącznika z nieprzetworzonym publikowaniem multimediów i publikowaniem tylko metadanych.

Zobacz też