[Attachments]

  • [アーティクル]

Azure Cosmos DB は、ドキュメント、グラフ、cassandra、テーブル データ モデルをサポートするグローバル分散マルチモデル データベースです。 このセクションの内容は、REST 経由で SQL API を使用して添付ファイル リソースを管理するための内容です。

添付ファイルは、外部 BLOB またはメディア ファイルの参照と関連付けられているメタデータを含む特殊なドキュメントです。

開発者は以下のいずれかを選択できます。

  • Azure Cosmos DB によって管理される添付ファイル メディア/BLOB または
  • OneDrive、Dropbox などの外部 BLOB サービス プロバイダーに保存します。添付ファイルの参照メタデータを Azure Cosmos DB に格納します。

添付ファイル リソースは、 Azure Cosmos DB REST リソース モデルの添付ファイルによって表されます。 添付ファイル リソースには固定スキーマがあります。 生のメディアの保存場所に関係なく、次のプロパティが必要です。

次の例は、ドキュメント添付ファイルの JSON 構造を示しています。

{    
   "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"  
}
プロパティ 説明
id 必須。 これはユーザー設定可能なプロパティです。 添付ファイルを識別する一意の名前です。つまり、同じドキュメントに対して同じ ID を共有する 2 つの添付ファイルはありません。 ID は 255 文字以内にする必要があります。
contentType 必須。 これはユーザー設定可能なプロパティです。 添付ファイルのコンテンツの種類を示します。 添付ファイルのビットを本文として送信すると、Cosmos DB は ヘッダーに設定された型に をContent-Type設定contentTypeします。
Media 必須。 これは、添付ファイルが存在する URL リンクまたはファイル パスです。
_rid これは、システムによって生成されるプロパティです。 リソース ID (_rid) は、リソース モデル上のリソース スタックごとに階層化された一意識別子です。 添付ファイル リソースの配置およびナビゲーションのために内部的に使用されます。
_ts これは、システムによって生成されるプロパティです。 リソースの最終更新タイムスタンプを示します。 値は、タイムスタンプです。
_self これは、システムによって生成されるプロパティです。 リソースの一意のアドレス指定が可能な URI です。
_etag これは、オプティミスティック コンカレンシー制御に必要なリソース etag を指定するシステム生成プロパティです。

共通の応答ヘッダー

添付ファイルに関連するすべての応答に共通の情報を次に示します。

ヘッダー 説明
x-ms-max-media-storage-usage-mb Cosmos DB 添付ファイル ストレージを使用して生メディアを格納する場合、このヘッダーには、アカウントに割り当てられた添付ファイル ストレージ クォータの合計が表示されます。
x-ms-media-storage-usage-mb Cosmos DB 添付ファイル ストレージを使用して生メディアを格納する場合、このヘッダーには、使用されている現在の添付ファイル ストレージが表示されます。

タスク

添付ファイルを使用して、次のタスクを実行できます。

添付ファイルの内容はインデックス付けも検索もできません。添付ファイル リソースのプロパティはインデックス付けされ、検索可能です。

これらの操作は 、Documents の操作と似ています。 ドキュメントに対して操作を実行する代わりに、特定のドキュメントの添付ファイル リソース パスに対して実行されます。 そのため、各操作について深く掘り下げて説明することはしません。 代わりに、次のセクションでは、生メディアの投稿とメタデータのみの投稿で添付ファイルを作成する方法について説明します。

参照