次の方法で共有


Microsoft.DocumentDB データベースアカウント/sqlデータベース/コンテナー 2025-11-01-preview

Bicep リソース定義

databaseAccounts/sqlDatabases/containers リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2025-11-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    options: {
      autoscaleSettings: {
        maxThroughput: int
      }
      throughput: int
    }
    resource: {
      analyticalStorageTtl: int
      clientEncryptionPolicy: {
        includedPaths: [
          {
            clientEncryptionKeyId: 'string'
            encryptionAlgorithm: 'string'
            encryptionType: 'string'
            path: 'string'
          }
        ]
        policyFormatVersion: int
      }
      computedProperties: [
        {
          name: 'string'
          query: 'string'
        }
      ]
      conflictResolutionPolicy: {
        conflictResolutionPath: 'string'
        conflictResolutionProcedure: 'string'
        mode: 'string'
      }
      createMode: 'string'
      dataMaskingPolicy: {
        excludedPaths: [
          {
            path: 'string'
          }
        ]
        includedPaths: [
          {
            length: int
            path: 'string'
            startPosition: int
            strategy: 'string'
          }
        ]
        isPolicyEnabled: bool
      }
      defaultTtl: int
      fullTextPolicy: {
        defaultLanguage: 'string'
        fullTextPaths: [
          {
            language: 'string'
            path: 'string'
          }
        ]
      }
      id: 'string'
      indexingPolicy: {
        automatic: bool
        compositeIndexes: [
          [
            {
              order: 'string'
              path: 'string'
            }
          ]
        ]
        excludedPaths: [
          {
            path: 'string'
          }
        ]
        fullTextIndexes: [
          {
            path: 'string'
          }
        ]
        includedPaths: [
          {
            indexes: [
              {
                dataType: 'string'
                kind: 'string'
                precision: int
              }
            ]
            path: 'string'
          }
        ]
        indexingMode: 'string'
        spatialIndexes: [
          {
            path: 'string'
            types: [
              'string'
            ]
          }
        ]
        vectorIndexes: [
          {
            indexingSearchListSize: int
            path: 'string'
            quantizationByteSize: int
            type: 'string'
            vectorIndexShardKey: [
              'string'
            ]
          }
        ]
      }
      materializedViewDefinition: {
        definition: 'string'
        sourceCollectionId: 'string'
        throughputBucketForBuild: int
      }
      materializedViews: [
        {
          id: 'string'
          _rid: 'string'
        }
      ]
      materializedViewsProperties: {
        throughputBucketForBuild: int
      }
      partitionKey: {
        kind: 'string'
        paths: [
          'string'
        ]
        version: int
      }
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
        restoreWithTtlDisabled: bool
      }
      uniqueKeyPolicy: {
        uniqueKeys: [
          {
            paths: [
              'string'
            ]
          }
        ]
      }
      vectorEmbeddingPolicy: {
        vectorEmbeddings: [
          {
            dataType: 'string'
            dimensions: int
            distanceFunction: 'string'
            path: 'string'
          }
        ]
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

名前 Description 価値
ID リソースの ID。 ManagedServiceIdentity
位置 リソースが属するリソース グループの場所。 文字列
名前 リソース名 string (必須)
Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「親リソースの外部 子リソース」を参照してください。
種類のリソースのシンボリック名: databaseAccounts/sqlDatabases
プロパティ Azure Cosmos DB コンテナーを作成および更新するためのプロパティ。 SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (必須)
tags リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

Autoscale設定

名前 Description 価値
最大スループット リソースをスケールアップできる最大スループットを表します。 整数 (int)

クライアント暗号化含まれるパス

名前 Description 価値
clientEncryptionKeyId (クライアント暗号化キー ID) パスの暗号化に使用するクライアント暗号化キーの識別子。 string (必須)
encryptionAlgorithm 使用される暗号化アルゴリズム。 例: AEAD_AES_256_CBC_HMAC_SHA256。 string (必須)
暗号化タイプ 実行する暗号化の種類。 例 : 決定論的、ランダム化。 string (必須)
パス 暗号化する必要があるパス。 string (必須)

クライアント暗号化ポリシー

名前 Description 価値
includedパス パス固有の設定と共に暗号化が必要な項目のパス。 ClientEncryptionIncludedPath[] (必須)
policyFormatVersion (ポリシーフォーマットバージョン) クライアント暗号化ポリシー定義のバージョン。 サポートされているバージョンは 1 と 2 です。 バージョン 2 では、ID とパーティション キーパスの暗号化がサポートされています。 int

Constraints:
最小値 = 1
最大値 = 2 (必須)

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

名前 Description 価値

コンポジットパス

名前 Description 価値
順序 複合パスの並べ替え順序。 「昇順」
「降順」
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

コンピューテッドプロパティ

名前 Description 価値
名前 計算されたプロパティの名前 (例: "cp_lowerName" 文字列
クエリ 計算されたプロパティの値を評価するクエリ (例: "SELECT VALUE LOWER(c.name) FROM c" 文字列

ConflictResolutionPolicy (競合解決ポリシー)

名前 Description 価値
conflictResolutionPath (英語) LastWriterWins モードの場合の競合解決パス。 文字列
conflictResolutionProcedure カスタム モードの場合の競合を解決する手順。 文字列
mode 競合解決モードを示します。 'Custom'
「ラストライターウィンズ」

コンテナパーティションキー

名前 Description 価値
kind パーティション分割に使用されるアルゴリズムの種類を示します。 MultiHash の場合、コンテナーの作成では複数のパーティション キー (最大 3 つ) がサポートされます 「ハッシュ」
「マルチハッシュ」
「範囲」
パス コンテナー内のどのデータをパーティション分割できるかを使用するパスの一覧 string[]
バージョン パーティション キー定義のバージョンを示します int

Constraints:
最小値 = 1
最大値 = 2

CreateUpdateOptionsまたはSqlContainerGetPropertiesOptions

名前 Description 価値
自動スケール設定 自動スケール設定を指定します。 注: スループットまたは自動scaleSettingsは必須ですが、両方は必要ありません。 Autoscale設定
スループット 1 秒あたりの要求ユニット数。 たとえば、"throughput": 10000 です。 整数 (int)

データマスキングポリシー

名前 Description 価値
excludedPaths (除外パス) マスキングから除外する JSON パスのリスト。 DataMaskingPolicyExcludedPathsItem[]
includedパス マスキングポリシーに含めるJSONパスのリスト。 DataMaskingPolicyIncludedPathsItem[]
isPolicy有効 データマスキングポリシーが有効になっているかどうかを示すフラグ。 ブール (bool)

DataMaskingPolicyExcludedPathsItem (データマスキングポリシーExcludedPathsItem)

名前 Description 価値
パス マスキングから除外する JSON パス (例: "/id")。 string (必須)

DataMaskingPolicyIncludedPathsItem (データマスキングポリシーを含むパス項目)

名前 Description 価値
length マスクする部分文字列の長さ (該当する場合)。 整数 (int)
パス マスキングを適用する JSON パス (例: "/contact/phones")。 string (必須)
スタートポジション 部分文字列マスキングの開始位置 (該当する場合)。 整数 (int)
strategy 適用するマスキング戦略(例:「MaskSubstring」)。 文字列

除外パス

名前 Description 価値
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

FullTextIndexPath (フルテキストインデックスパス)

名前 Description 価値
パス ドキュメント内のフルテキスト フィールドへのパス。 string (必須)

フルテキストパス

名前 Description 価値
言語 文書内のフルテキスト フィールドの言語。 文字列
パス ドキュメント内のフルテキスト フィールドへのパス。 string (必須)

フルテキストポリシー

名前 Description 価値
デフォルト言語 フルテキスト パスの既定の言語。 文字列
フルテキストパス フルテキスト パスの一覧 フルテキストパス[]

インクルードパス

名前 Description 価値
索引 このパスのインデックスの一覧 インデックス[]
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

Indexes

名前 Description 価値
データタイプ インデックス作成の動作が適用されるデータ型。 'ラインストリング'
「マルチポリゴン」
'数値'
「ポイント」
「ポリゴン」
'文字列'
kind インデックスの種類を示します。 「ハッシュ」
「範囲」
「空間的」
精度 インデックスの有効桁数。 -1 は最大有効桁数です。 整数 (int)

インデックス作成ポリシー

名前 Description 価値
自動 インデックス作成ポリシーが自動かどうかを示します ブール (bool)
コンポジットインデックス 複合パス リストの一覧 コンポジットパス[][]
excludedPaths (除外パス) インデックス作成から除外するパスの一覧 ExcludedPath[] を する
fullTextインデックス フルテキストインデックス作成に含めるパスのリスト FullTextIndexPath[]
includedパス インデックス作成に含めるパスの一覧 含まれるパス[]
インデックスモード(indexingMode) インデックス作成モードを示します。 「一貫性」
「怠惰」
'none'
空間インデックス 空間の詳細の一覧 SpatialSpec[]
vectorIndexes(ベクトルインデックス) ベクター インデックス作成に含めるパスの一覧 ベクターインデックス[]

ManagedServiceIdentity

名前 Description 価値
リソースに使用される ID の種類。 型 'SystemAssigned,UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、サービスからすべての ID を削除します。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。 ManagedServiceIdentityUserAssignedIdentities の

ManagedServiceIdentityUserAssignedIdentities

名前 Description 価値

MaterializedViewDefinition (マテリアライズドビュー定義)

名前 Description 価値
定義 定義は、ソース コンテナーからデータをフェッチして具体化されたビュー コンテナーにデータを取り込むのに使用される SQL クエリである必要があります。 string (必須)
sourceCollectionId (ソースコレクションID) 具体化されたビューが作成されるソース コンテナーの名前。 string (必須)
throughputBucketForBuild (スループットバケットフォービルド) ターゲットコンテナの具体化されたビュー操作に割り当てられたスループットバケット。 整数 (int)

MaterializedView詳細

名前 Description 価値
id 具体化されたコンテナーの ID フィールド。 文字列
_rid 具体化されたコンテナーの_ridフィールド。 文字列

MaterializedViewsプロパティ

名前 Description 価値
throughputBucketForBuild (スループットバケットフォービルド) ソースコンテナの具体化されたビュー操作に割り当てられたスループットバケット。 整数 (int)

リソース復元パラメーター

名前 Description 価値
restoreSource 復元を開始する必要がある復元可能なデータベース アカウントの ID。 例: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} 文字列
restoreTimestampInUtc アカウントを復元する必要がある時間 (ISO-8601 形式)。 文字列
restoreWithTtlDisabled (英語) 復元が成功した時点で、復元されたアカウントに Time-To-Live を無効にするかどうかを指定します。 ブール (bool)

SpatialSpec (空間スペック)

名前 Description 価値
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列
パスの空間型の一覧 次のいずれかを含む文字列配列:
'ラインストリング'
「マルチポリゴン」
「ポイント」
「ポリゴン」

SqlContainerCreateUpdatePropertiesまたはSqlContainerGetProperties

名前 Description 価値
オプション 要求に適用するオプションのキーと値のペア。 これは、要求と共に送信されたヘッダーに対応します。 CreateUpdateOptionsOrSqlContainerGetPropertiesOptions の
リソース コンテナーの標準 JSON 形式 SqlContainerResourceOrSqlContainerGetPropertiesResource (必須)

SqlContainerResourceまたはSqlContainerGetPropertiesResource

名前 Description 価値
analyticalStorageTtl 分析 TTL。 整数 (int)
クライアント暗号化ポリシー コンテナーのクライアント暗号化ポリシー。 クライアント暗号化ポリシー
computedプロパティ 計算プロパティの一覧 計算済みプロパティ[]
conflictResolutionPolicy(コンフリクトレゾリューションポリシー) コンテナーの競合解決ポリシー。 ConflictResolutionPolicy (競合解決ポリシー)
createMode リソースの作成モードを示す列挙型。 デフォルト
'Restore'
データマスキングポリシー {{dataMaskingPolicy} コンテナーのデータ・マスキング・ポリシー。 データマスキングポリシー
デフォルトTtl 既定の有効期間 整数 (int)
フルテキストポリシー コンテナーの FullText ポリシー。 フルテキストポリシー
id Cosmos DB SQL コンテナーの名前 string (必須)
インデックスポリシー(いんでっくすいんぐ インデックス作成ポリシーの構成。 既定では、コンテナー内のすべてのドキュメント パスに対してインデックス作成が自動的に行われます。 インデックス作成ポリシー
materializedViewDefinition 具体化されたビューを定義するための構成。 これは、具体化されたビュー コンテナーを作成する場合にのみ指定する必要があります。 MaterializedViewDefinition (マテリアライズドビュー定義)
materializedビュー コンテナーで定義された具体化されたビュー。 MaterializedViewDetails[]
materializedViewsプロパティ マテリアライズドビューソースコンテナーに定義されたプロパティ。 MaterializedViewsプロパティ
partitionKey 複数のパーティションにデータをパーティション分割するために使用するパーティション キーの構成 コンテナパーティションキー
restoreParameters 復元に関する情報を示すパラメーター リソース復元パラメーター
uniqueKeyPolicy (ユニークキーポリシー) Azure Cosmos DB サービス内のコレクション内のドキュメントに対する一意性制約を指定するための一意キー ポリシー構成。 ユニークキーポリシー
vectorEmbeddingPolicy (ベクトル埋め込みポリシー) コンテナーのベクター埋め込みポリシー。 VectorEmbeddingPolicy の

タグ

名前 Description 価値

ユニークキー

名前 Description 価値
パス パスの一覧は、Azure Cosmos DB サービスのドキュメントごとに一意である必要があります string[]

ユニークキーポリシー

名前 Description 価値
uniqueKeys(ユニークキー) Azure Cosmos DB サービスのコレクション内のドキュメントに一意性制約を適用する一意キーの一覧。 ユニークキー[]

ベクトル埋め込み

名前 Description 価値
データタイプ ベクターのデータ型を示します。 'float16'
'float32'
'int8'
'uint8' (必須)
dimensions ベクトル内の次元の数。 int (必須)
distance関数 ベクトル間の距離計算に使用する距離関数。 「コサイン」
'ドット製品'
'euclidean' (必須)
パス ドキュメント内のベクター フィールドへのパス。 string (必須)

VectorEmbeddingPolicy (英語)

名前 Description 価値
ベクトル埋め込み ベクター埋め込みの一覧 ベクター埋め込み[]

ベクトルインデックス

名前 Description 価値
インデックス検索リストサイズ これは、最適化プロセスの一環として DiskANN インデックスを構築する際に格納される近似隣接の候補リストのサイズです。 値を大きくすると、待機時間が犠牲になっても再現率が向上する可能性があります。 これは、diskANN ベクトルインデックスタイプにのみ適用されます。 int

Constraints:
最小値 = 25
最大値 = 500
パス ドキュメント内のベクター フィールドへのパス。 string (必須)
量子化バイトサイズ ベクトルの積量子化に使用されるバイト数。 値を大きくすると、待ち時間が犠牲になりますが、ベクトル検索の再現率が向上します。 これは、quantizedFlat および diskANN ベクトルインデックス型にのみ適用されます。 int

Constraints:
最小値 = 4
ベクターのインデックス型。 現在、フラット、diskANN、およびクオンタイズフラットがサポートされています。 'diskANN'
「フラット」
'quantizedFlat' (必須)
vectorIndexShardKey (ベクトルインデックスシャードキー) ベクトルインデックスのシャードキーの配列。 これは、quantizedFlat および diskANN ベクトルインデックス型にのみ適用されます。 string[]

使用例

Azure クイック スタートのサンプル

Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル Description
分析ストアを使用した Azure Cosmos DB アカウント SQL API このテンプレートは、分析ストアで構成されたデータベースとコンテナーを使用して、Core (SQL) API 用の Azure Cosmos アカウントを作成します。
Free レベルの Azure Cosmos DB アカウントを作成する このテンプレートは、共有スループットとコンテナーを持つデータベースを使用して、SQL API 用の Free レベルの Azure Cosmos DB アカウントを作成します。
Core (SQL) API 用の Azure Cosmos DB アカウントを作成する このテンプレートでは、他の複数のオプションを含むスループットを持つデータベースとコンテナーを使用して、コア (SQL) API 用の Azure Cosmos アカウントを作成します。
自動スケーリングを使用して Azure Cosmos DB アカウント SQL API を作成する このテンプレートでは、他の複数のオプションを使用して、自動スケーリング スループットを使用するデータベースとコンテナーを使用して、Core (SQL) API 用の Azure Cosmos アカウントを作成します。
Azure Cosmos DB Core (SQL) API ストアド プロシージャを作成する このテンプレートでは、Core (SQL) API 用の Azure Cosmos DB アカウントと、ストアド プロシージャ、トリガー、およびユーザー定義関数を含むコンテナーが作成されます。
Container Apps を使用して Dapr マイクロサービス アプリを作成する Container Apps を使用して Dapr マイクロサービス アプリを作成します。
Container Apps を使用して Dapr pub-sub servicebus アプリを作成します Container Apps を使用して Dapr pub-sub servicebus アプリを作成します。
Cosmos DB 接続を使用して Azure Data Explorer DB をデプロイする Cosmos DB 接続を使用して Azure Data Explorer DB をデプロイします。

ARM テンプレート リソース定義

databaseAccounts/sqlDatabases/containers リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
  "apiVersion": "2025-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "options": {
      "autoscaleSettings": {
        "maxThroughput": "int"
      },
      "throughput": "int"
    },
    "resource": {
      "analyticalStorageTtl": "int",
      "clientEncryptionPolicy": {
        "includedPaths": [
          {
            "clientEncryptionKeyId": "string",
            "encryptionAlgorithm": "string",
            "encryptionType": "string",
            "path": "string"
          }
        ],
        "policyFormatVersion": "int"
      },
      "computedProperties": [
        {
          "name": "string",
          "query": "string"
        }
      ],
      "conflictResolutionPolicy": {
        "conflictResolutionPath": "string",
        "conflictResolutionProcedure": "string",
        "mode": "string"
      },
      "createMode": "string",
      "dataMaskingPolicy": {
        "excludedPaths": [
          {
            "path": "string"
          }
        ],
        "includedPaths": [
          {
            "length": "int",
            "path": "string",
            "startPosition": "int",
            "strategy": "string"
          }
        ],
        "isPolicyEnabled": "bool"
      },
      "defaultTtl": "int",
      "fullTextPolicy": {
        "defaultLanguage": "string",
        "fullTextPaths": [
          {
            "language": "string",
            "path": "string"
          }
        ]
      },
      "id": "string",
      "indexingPolicy": {
        "automatic": "bool",
        "compositeIndexes": [
          [
            {
              "order": "string",
              "path": "string"
            }
          ]
        ],
        "excludedPaths": [
          {
            "path": "string"
          }
        ],
        "fullTextIndexes": [
          {
            "path": "string"
          }
        ],
        "includedPaths": [
          {
            "indexes": [
              {
                "dataType": "string",
                "kind": "string",
                "precision": "int"
              }
            ],
            "path": "string"
          }
        ],
        "indexingMode": "string",
        "spatialIndexes": [
          {
            "path": "string",
            "types": [ "string" ]
          }
        ],
        "vectorIndexes": [
          {
            "indexingSearchListSize": "int",
            "path": "string",
            "quantizationByteSize": "int",
            "type": "string",
            "vectorIndexShardKey": [ "string" ]
          }
        ]
      },
      "materializedViewDefinition": {
        "definition": "string",
        "sourceCollectionId": "string",
        "throughputBucketForBuild": "int"
      },
      "materializedViews": [
        {
          "id": "string",
          "_rid": "string"
        }
      ],
      "materializedViewsProperties": {
        "throughputBucketForBuild": "int"
      },
      "partitionKey": {
        "kind": "string",
        "paths": [ "string" ],
        "version": "int"
      },
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string",
        "restoreWithTtlDisabled": "bool"
      },
      "uniqueKeyPolicy": {
        "uniqueKeys": [
          {
            "paths": [ "string" ]
          }
        ]
      },
      "vectorEmbeddingPolicy": {
        "vectorEmbeddings": [
          {
            "dataType": "string",
            "dimensions": "int",
            "distanceFunction": "string",
            "path": "string"
          }
        ]
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

名前 Description 価値
apiVersion API のバージョン 「2025-11-01-プレビュー」
ID リソースの ID。 ManagedServiceIdentity
位置 リソースが属するリソース グループの場所。 文字列
名前 リソース名 string (必須)
プロパティ Azure Cosmos DB コンテナーを作成および更新するためのプロパティ。 SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (必須)
tags リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください
リソースの種類 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers'

Autoscale設定

名前 Description 価値
最大スループット リソースをスケールアップできる最大スループットを表します。 整数 (int)

クライアント暗号化含まれるパス

名前 Description 価値
clientEncryptionKeyId (クライアント暗号化キー ID) パスの暗号化に使用するクライアント暗号化キーの識別子。 string (必須)
encryptionAlgorithm 使用される暗号化アルゴリズム。 例: AEAD_AES_256_CBC_HMAC_SHA256。 string (必須)
暗号化タイプ 実行する暗号化の種類。 例 : 決定論的、ランダム化。 string (必須)
パス 暗号化する必要があるパス。 string (必須)

クライアント暗号化ポリシー

名前 Description 価値
includedパス パス固有の設定と共に暗号化が必要な項目のパス。 ClientEncryptionIncludedPath[] (必須)
policyFormatVersion (ポリシーフォーマットバージョン) クライアント暗号化ポリシー定義のバージョン。 サポートされているバージョンは 1 と 2 です。 バージョン 2 では、ID とパーティション キーパスの暗号化がサポートされています。 int

Constraints:
最小値 = 1
最大値 = 2 (必須)

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

名前 Description 価値

コンポジットパス

名前 Description 価値
順序 複合パスの並べ替え順序。 「昇順」
「降順」
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

コンピューテッドプロパティ

名前 Description 価値
名前 計算されたプロパティの名前 (例: "cp_lowerName" 文字列
クエリ 計算されたプロパティの値を評価するクエリ (例: "SELECT VALUE LOWER(c.name) FROM c" 文字列

ConflictResolutionPolicy (競合解決ポリシー)

名前 Description 価値
conflictResolutionPath (英語) LastWriterWins モードの場合の競合解決パス。 文字列
conflictResolutionProcedure カスタム モードの場合の競合を解決する手順。 文字列
mode 競合解決モードを示します。 'Custom'
「ラストライターウィンズ」

コンテナパーティションキー

名前 Description 価値
kind パーティション分割に使用されるアルゴリズムの種類を示します。 MultiHash の場合、コンテナーの作成では複数のパーティション キー (最大 3 つ) がサポートされます 「ハッシュ」
「マルチハッシュ」
「範囲」
パス コンテナー内のどのデータをパーティション分割できるかを使用するパスの一覧 string[]
バージョン パーティション キー定義のバージョンを示します int

Constraints:
最小値 = 1
最大値 = 2

CreateUpdateOptionsまたはSqlContainerGetPropertiesOptions

名前 Description 価値
自動スケール設定 自動スケール設定を指定します。 注: スループットまたは自動scaleSettingsは必須ですが、両方は必要ありません。 Autoscale設定
スループット 1 秒あたりの要求ユニット数。 たとえば、"throughput": 10000 です。 整数 (int)

データマスキングポリシー

名前 Description 価値
excludedPaths (除外パス) マスキングから除外する JSON パスのリスト。 DataMaskingPolicyExcludedPathsItem[]
includedパス マスキングポリシーに含めるJSONパスのリスト。 DataMaskingPolicyIncludedPathsItem[]
isPolicy有効 データマスキングポリシーが有効になっているかどうかを示すフラグ。 ブール (bool)

DataMaskingPolicyExcludedPathsItem (データマスキングポリシーExcludedPathsItem)

名前 Description 価値
パス マスキングから除外する JSON パス (例: "/id")。 string (必須)

DataMaskingPolicyIncludedPathsItem (データマスキングポリシーを含むパス項目)

名前 Description 価値
length マスクする部分文字列の長さ (該当する場合)。 整数 (int)
パス マスキングを適用する JSON パス (例: "/contact/phones")。 string (必須)
スタートポジション 部分文字列マスキングの開始位置 (該当する場合)。 整数 (int)
strategy 適用するマスキング戦略(例:「MaskSubstring」)。 文字列

除外パス

名前 Description 価値
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

FullTextIndexPath (フルテキストインデックスパス)

名前 Description 価値
パス ドキュメント内のフルテキスト フィールドへのパス。 string (必須)

フルテキストパス

名前 Description 価値
言語 文書内のフルテキスト フィールドの言語。 文字列
パス ドキュメント内のフルテキスト フィールドへのパス。 string (必須)

フルテキストポリシー

名前 Description 価値
デフォルト言語 フルテキスト パスの既定の言語。 文字列
フルテキストパス フルテキスト パスの一覧 フルテキストパス[]

インクルードパス

名前 Description 価値
索引 このパスのインデックスの一覧 インデックス[]
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

Indexes

名前 Description 価値
データタイプ インデックス作成の動作が適用されるデータ型。 'ラインストリング'
「マルチポリゴン」
'数値'
「ポイント」
「ポリゴン」
'文字列'
kind インデックスの種類を示します。 「ハッシュ」
「範囲」
「空間的」
精度 インデックスの有効桁数。 -1 は最大有効桁数です。 整数 (int)

インデックス作成ポリシー

名前 Description 価値
自動 インデックス作成ポリシーが自動かどうかを示します ブール (bool)
コンポジットインデックス 複合パス リストの一覧 コンポジットパス[][]
excludedPaths (除外パス) インデックス作成から除外するパスの一覧 ExcludedPath[] を する
fullTextインデックス フルテキストインデックス作成に含めるパスのリスト FullTextIndexPath[]
includedパス インデックス作成に含めるパスの一覧 含まれるパス[]
インデックスモード(indexingMode) インデックス作成モードを示します。 「一貫性」
「怠惰」
'none'
空間インデックス 空間の詳細の一覧 SpatialSpec[]
vectorIndexes(ベクトルインデックス) ベクター インデックス作成に含めるパスの一覧 ベクターインデックス[]

ManagedServiceIdentity

名前 Description 価値
リソースに使用される ID の種類。 型 'SystemAssigned,UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、サービスからすべての ID を削除します。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。 ManagedServiceIdentityUserAssignedIdentities の

ManagedServiceIdentityUserAssignedIdentities

名前 Description 価値

MaterializedViewDefinition (マテリアライズドビュー定義)

名前 Description 価値
定義 定義は、ソース コンテナーからデータをフェッチして具体化されたビュー コンテナーにデータを取り込むのに使用される SQL クエリである必要があります。 string (必須)
sourceCollectionId (ソースコレクションID) 具体化されたビューが作成されるソース コンテナーの名前。 string (必須)
throughputBucketForBuild (スループットバケットフォービルド) ターゲットコンテナの具体化されたビュー操作に割り当てられたスループットバケット。 整数 (int)

MaterializedView詳細

名前 Description 価値
id 具体化されたコンテナーの ID フィールド。 文字列
_rid 具体化されたコンテナーの_ridフィールド。 文字列

MaterializedViewsプロパティ

名前 Description 価値
throughputBucketForBuild (スループットバケットフォービルド) ソースコンテナの具体化されたビュー操作に割り当てられたスループットバケット。 整数 (int)

リソース復元パラメーター

名前 Description 価値
restoreSource 復元を開始する必要がある復元可能なデータベース アカウントの ID。 例: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} 文字列
restoreTimestampInUtc アカウントを復元する必要がある時間 (ISO-8601 形式)。 文字列
restoreWithTtlDisabled (英語) 復元が成功した時点で、復元されたアカウントに Time-To-Live を無効にするかどうかを指定します。 ブール (bool)

SpatialSpec (空間スペック)

名前 Description 価値
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列
パスの空間型の一覧 次のいずれかを含む文字列配列:
'ラインストリング'
「マルチポリゴン」
「ポイント」
「ポリゴン」

SqlContainerCreateUpdatePropertiesまたはSqlContainerGetProperties

名前 Description 価値
オプション 要求に適用するオプションのキーと値のペア。 これは、要求と共に送信されたヘッダーに対応します。 CreateUpdateOptionsOrSqlContainerGetPropertiesOptions の
リソース コンテナーの標準 JSON 形式 SqlContainerResourceOrSqlContainerGetPropertiesResource (必須)

SqlContainerResourceまたはSqlContainerGetPropertiesResource

名前 Description 価値
analyticalStorageTtl 分析 TTL。 整数 (int)
クライアント暗号化ポリシー コンテナーのクライアント暗号化ポリシー。 クライアント暗号化ポリシー
computedプロパティ 計算プロパティの一覧 計算済みプロパティ[]
conflictResolutionPolicy(コンフリクトレゾリューションポリシー) コンテナーの競合解決ポリシー。 ConflictResolutionPolicy (競合解決ポリシー)
createMode リソースの作成モードを示す列挙型。 デフォルト
'Restore'
データマスキングポリシー {{dataMaskingPolicy} コンテナーのデータ・マスキング・ポリシー。 データマスキングポリシー
デフォルトTtl 既定の有効期間 整数 (int)
フルテキストポリシー コンテナーの FullText ポリシー。 フルテキストポリシー
id Cosmos DB SQL コンテナーの名前 string (必須)
インデックスポリシー(いんでっくすいんぐ インデックス作成ポリシーの構成。 既定では、コンテナー内のすべてのドキュメント パスに対してインデックス作成が自動的に行われます。 インデックス作成ポリシー
materializedViewDefinition 具体化されたビューを定義するための構成。 これは、具体化されたビュー コンテナーを作成する場合にのみ指定する必要があります。 MaterializedViewDefinition (マテリアライズドビュー定義)
materializedビュー コンテナーで定義された具体化されたビュー。 MaterializedViewDetails[]
materializedViewsプロパティ マテリアライズドビューソースコンテナーに定義されたプロパティ。 MaterializedViewsプロパティ
partitionKey 複数のパーティションにデータをパーティション分割するために使用するパーティション キーの構成 コンテナパーティションキー
restoreParameters 復元に関する情報を示すパラメーター リソース復元パラメーター
uniqueKeyPolicy (ユニークキーポリシー) Azure Cosmos DB サービス内のコレクション内のドキュメントに対する一意性制約を指定するための一意キー ポリシー構成。 ユニークキーポリシー
vectorEmbeddingPolicy (ベクトル埋め込みポリシー) コンテナーのベクター埋め込みポリシー。 VectorEmbeddingPolicy の

タグ

名前 Description 価値

ユニークキー

名前 Description 価値
パス パスの一覧は、Azure Cosmos DB サービスのドキュメントごとに一意である必要があります string[]

ユニークキーポリシー

名前 Description 価値
uniqueKeys(ユニークキー) Azure Cosmos DB サービスのコレクション内のドキュメントに一意性制約を適用する一意キーの一覧。 ユニークキー[]

ベクトル埋め込み

名前 Description 価値
データタイプ ベクターのデータ型を示します。 'float16'
'float32'
'int8'
'uint8' (必須)
dimensions ベクトル内の次元の数。 int (必須)
distance関数 ベクトル間の距離計算に使用する距離関数。 「コサイン」
'ドット製品'
'euclidean' (必須)
パス ドキュメント内のベクター フィールドへのパス。 string (必須)

VectorEmbeddingPolicy (英語)

名前 Description 価値
ベクトル埋め込み ベクター埋め込みの一覧 ベクター埋め込み[]

ベクトルインデックス

名前 Description 価値
インデックス検索リストサイズ これは、最適化プロセスの一環として DiskANN インデックスを構築する際に格納される近似隣接の候補リストのサイズです。 値を大きくすると、待機時間が犠牲になっても再現率が向上する可能性があります。 これは、diskANN ベクトルインデックスタイプにのみ適用されます。 int

Constraints:
最小値 = 25
最大値 = 500
パス ドキュメント内のベクター フィールドへのパス。 string (必須)
量子化バイトサイズ ベクトルの積量子化に使用されるバイト数。 値を大きくすると、待ち時間が犠牲になりますが、ベクトル検索の再現率が向上します。 これは、quantizedFlat および diskANN ベクトルインデックス型にのみ適用されます。 int

Constraints:
最小値 = 4
ベクターのインデックス型。 現在、フラット、diskANN、およびクオンタイズフラットがサポートされています。 'diskANN'
「フラット」
'quantizedFlat' (必須)
vectorIndexShardKey (ベクトルインデックスシャードキー) ベクトルインデックスのシャードキーの配列。 これは、quantizedFlat および diskANN ベクトルインデックス型にのみ適用されます。 string[]

使用例

Azure クイックスタート テンプレート

このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。

Template Description
分析ストアを使用した Azure Cosmos DB アカウント SQL API

Azure に展開する
このテンプレートは、分析ストアで構成されたデータベースとコンテナーを使用して、Core (SQL) API 用の Azure Cosmos アカウントを作成します。
Free レベルの Azure Cosmos DB アカウントを作成する

Azure に展開する
このテンプレートは、共有スループットとコンテナーを持つデータベースを使用して、SQL API 用の Free レベルの Azure Cosmos DB アカウントを作成します。
Core (SQL) API 用の Azure Cosmos DB アカウントを作成する

Azure に展開する
このテンプレートでは、他の複数のオプションを含むスループットを持つデータベースとコンテナーを使用して、コア (SQL) API 用の Azure Cosmos アカウントを作成します。
自動スケーリングを使用して Azure Cosmos DB アカウント SQL API を作成する

Azure に展開する
このテンプレートでは、他の複数のオプションを使用して、自動スケーリング スループットを使用するデータベースとコンテナーを使用して、Core (SQL) API 用の Azure Cosmos アカウントを作成します。
Azure Cosmos DB Core (SQL) API ストアド プロシージャを作成する

Azure に展開する
このテンプレートでは、Core (SQL) API 用の Azure Cosmos DB アカウントと、ストアド プロシージャ、トリガー、およびユーザー定義関数を含むコンテナーが作成されます。
Container Apps を使用して Dapr マイクロサービス アプリを作成する

Azure に展開する
Container Apps を使用して Dapr マイクロサービス アプリを作成します。
Container Apps を使用して Dapr pub-sub servicebus アプリを作成します

Azure に展開する
Container Apps を使用して Dapr pub-sub servicebus アプリを作成します。
Cosmos DB 接続を使用して Azure Data Explorer DB をデプロイする

Azure に展開する
Cosmos DB 接続を使用して Azure Data Explorer DB をデプロイします。

Terraform (AzAPI プロバイダー) リソース定義

databaseAccounts/sqlDatabases/containers リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2025-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        analyticalStorageTtl = int
        clientEncryptionPolicy = {
          includedPaths = [
            {
              clientEncryptionKeyId = "string"
              encryptionAlgorithm = "string"
              encryptionType = "string"
              path = "string"
            }
          ]
          policyFormatVersion = int
        }
        computedProperties = [
          {
            name = "string"
            query = "string"
          }
        ]
        conflictResolutionPolicy = {
          conflictResolutionPath = "string"
          conflictResolutionProcedure = "string"
          mode = "string"
        }
        createMode = "string"
        dataMaskingPolicy = {
          excludedPaths = [
            {
              path = "string"
            }
          ]
          includedPaths = [
            {
              length = int
              path = "string"
              startPosition = int
              strategy = "string"
            }
          ]
          isPolicyEnabled = bool
        }
        defaultTtl = int
        fullTextPolicy = {
          defaultLanguage = "string"
          fullTextPaths = [
            {
              language = "string"
              path = "string"
            }
          ]
        }
        id = "string"
        indexingPolicy = {
          automatic = bool
          compositeIndexes = [
            [
              {
                order = "string"
                path = "string"
              }
            ]
          ]
          excludedPaths = [
            {
              path = "string"
            }
          ]
          fullTextIndexes = [
            {
              path = "string"
            }
          ]
          includedPaths = [
            {
              indexes = [
                {
                  dataType = "string"
                  kind = "string"
                  precision = int
                }
              ]
              path = "string"
            }
          ]
          indexingMode = "string"
          spatialIndexes = [
            {
              path = "string"
              types = [
                "string"
              ]
            }
          ]
          vectorIndexes = [
            {
              indexingSearchListSize = int
              path = "string"
              quantizationByteSize = int
              type = "string"
              vectorIndexShardKey = [
                "string"
              ]
            }
          ]
        }
        materializedViewDefinition = {
          definition = "string"
          sourceCollectionId = "string"
          throughputBucketForBuild = int
        }
        materializedViews = [
          {
            id = "string"
            _rid = "string"
          }
        ]
        materializedViewsProperties = {
          throughputBucketForBuild = int
        }
        partitionKey = {
          kind = "string"
          paths = [
            "string"
          ]
          version = int
        }
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
          restoreWithTtlDisabled = bool
        }
        uniqueKeyPolicy = {
          uniqueKeys = [
            {
              paths = [
                "string"
              ]
            }
          ]
        }
        vectorEmbeddingPolicy = {
          vectorEmbeddings = [
            {
              dataType = "string"
              dimensions = int
              distanceFunction = "string"
              path = "string"
            }
          ]
        }
      }
    }
  }
}

プロパティ値

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

名前 Description 価値
ID リソースの ID。 ManagedServiceIdentity
位置 リソースが属するリソース グループの場所。 文字列
名前 リソース名 string (必須)
parent_id このリソースの親であるリソースの ID。 種類のリソースの ID: databaseAccounts/sqlDatabases
プロパティ Azure Cosmos DB コンテナーを作成および更新するためのプロパティ。 SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (必須)
tags リソース タグ タグ名と値のディクショナリ。
リソースの種類 "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2025-11-01-preview"

Autoscale設定

名前 Description 価値
最大スループット リソースをスケールアップできる最大スループットを表します。 整数 (int)

クライアント暗号化含まれるパス

名前 Description 価値
clientEncryptionKeyId (クライアント暗号化キー ID) パスの暗号化に使用するクライアント暗号化キーの識別子。 string (必須)
encryptionAlgorithm 使用される暗号化アルゴリズム。 例: AEAD_AES_256_CBC_HMAC_SHA256。 string (必須)
暗号化タイプ 実行する暗号化の種類。 例 : 決定論的、ランダム化。 string (必須)
パス 暗号化する必要があるパス。 string (必須)

クライアント暗号化ポリシー

名前 Description 価値
includedパス パス固有の設定と共に暗号化が必要な項目のパス。 ClientEncryptionIncludedPath[] (必須)
policyFormatVersion (ポリシーフォーマットバージョン) クライアント暗号化ポリシー定義のバージョン。 サポートされているバージョンは 1 と 2 です。 バージョン 2 では、ID とパーティション キーパスの暗号化がサポートされています。 int

Constraints:
最小値 = 1
最大値 = 2 (必須)

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

名前 Description 価値

コンポジットパス

名前 Description 価値
順序 複合パスの並べ替え順序。 「昇順」
「降順」
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

コンピューテッドプロパティ

名前 Description 価値
名前 計算されたプロパティの名前 (例: "cp_lowerName" 文字列
クエリ 計算されたプロパティの値を評価するクエリ (例: "SELECT VALUE LOWER(c.name) FROM c" 文字列

ConflictResolutionPolicy (競合解決ポリシー)

名前 Description 価値
conflictResolutionPath (英語) LastWriterWins モードの場合の競合解決パス。 文字列
conflictResolutionProcedure カスタム モードの場合の競合を解決する手順。 文字列
mode 競合解決モードを示します。 'Custom'
「ラストライターウィンズ」

コンテナパーティションキー

名前 Description 価値
kind パーティション分割に使用されるアルゴリズムの種類を示します。 MultiHash の場合、コンテナーの作成では複数のパーティション キー (最大 3 つ) がサポートされます 「ハッシュ」
「マルチハッシュ」
「範囲」
パス コンテナー内のどのデータをパーティション分割できるかを使用するパスの一覧 string[]
バージョン パーティション キー定義のバージョンを示します int

Constraints:
最小値 = 1
最大値 = 2

CreateUpdateOptionsまたはSqlContainerGetPropertiesOptions

名前 Description 価値
自動スケール設定 自動スケール設定を指定します。 注: スループットまたは自動scaleSettingsは必須ですが、両方は必要ありません。 Autoscale設定
スループット 1 秒あたりの要求ユニット数。 たとえば、"throughput": 10000 です。 整数 (int)

データマスキングポリシー

名前 Description 価値
excludedPaths (除外パス) マスキングから除外する JSON パスのリスト。 DataMaskingPolicyExcludedPathsItem[]
includedパス マスキングポリシーに含めるJSONパスのリスト。 DataMaskingPolicyIncludedPathsItem[]
isPolicy有効 データマスキングポリシーが有効になっているかどうかを示すフラグ。 ブール (bool)

DataMaskingPolicyExcludedPathsItem (データマスキングポリシーExcludedPathsItem)

名前 Description 価値
パス マスキングから除外する JSON パス (例: "/id")。 string (必須)

DataMaskingPolicyIncludedPathsItem (データマスキングポリシーを含むパス項目)

名前 Description 価値
length マスクする部分文字列の長さ (該当する場合)。 整数 (int)
パス マスキングを適用する JSON パス (例: "/contact/phones")。 string (必須)
スタートポジション 部分文字列マスキングの開始位置 (該当する場合)。 整数 (int)
strategy 適用するマスキング戦略(例:「MaskSubstring」)。 文字列

除外パス

名前 Description 価値
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

FullTextIndexPath (フルテキストインデックスパス)

名前 Description 価値
パス ドキュメント内のフルテキスト フィールドへのパス。 string (必須)

フルテキストパス

名前 Description 価値
言語 文書内のフルテキスト フィールドの言語。 文字列
パス ドキュメント内のフルテキスト フィールドへのパス。 string (必須)

フルテキストポリシー

名前 Description 価値
デフォルト言語 フルテキスト パスの既定の言語。 文字列
フルテキストパス フルテキスト パスの一覧 フルテキストパス[]

インクルードパス

名前 Description 価値
索引 このパスのインデックスの一覧 インデックス[]
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列

Indexes

名前 Description 価値
データタイプ インデックス作成の動作が適用されるデータ型。 'ラインストリング'
「マルチポリゴン」
'数値'
「ポイント」
「ポリゴン」
'文字列'
kind インデックスの種類を示します。 「ハッシュ」
「範囲」
「空間的」
精度 インデックスの有効桁数。 -1 は最大有効桁数です。 整数 (int)

インデックス作成ポリシー

名前 Description 価値
自動 インデックス作成ポリシーが自動かどうかを示します ブール (bool)
コンポジットインデックス 複合パス リストの一覧 コンポジットパス[][]
excludedPaths (除外パス) インデックス作成から除外するパスの一覧 ExcludedPath[] を する
fullTextインデックス フルテキストインデックス作成に含めるパスのリスト FullTextIndexPath[]
includedパス インデックス作成に含めるパスの一覧 含まれるパス[]
インデックスモード(indexingMode) インデックス作成モードを示します。 「一貫性」
「怠惰」
'none'
空間インデックス 空間の詳細の一覧 SpatialSpec[]
vectorIndexes(ベクトルインデックス) ベクター インデックス作成に含めるパスの一覧 ベクターインデックス[]

ManagedServiceIdentity

名前 Description 価値
リソースに使用される ID の種類。 型 'SystemAssigned,UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、サービスからすべての ID を削除します。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。 ManagedServiceIdentityUserAssignedIdentities の

ManagedServiceIdentityUserAssignedIdentities

名前 Description 価値

MaterializedViewDefinition (マテリアライズドビュー定義)

名前 Description 価値
定義 定義は、ソース コンテナーからデータをフェッチして具体化されたビュー コンテナーにデータを取り込むのに使用される SQL クエリである必要があります。 string (必須)
sourceCollectionId (ソースコレクションID) 具体化されたビューが作成されるソース コンテナーの名前。 string (必須)
throughputBucketForBuild (スループットバケットフォービルド) ターゲットコンテナの具体化されたビュー操作に割り当てられたスループットバケット。 整数 (int)

MaterializedView詳細

名前 Description 価値
id 具体化されたコンテナーの ID フィールド。 文字列
_rid 具体化されたコンテナーの_ridフィールド。 文字列

MaterializedViewsプロパティ

名前 Description 価値
throughputBucketForBuild (スループットバケットフォービルド) ソースコンテナの具体化されたビュー操作に割り当てられたスループットバケット。 整数 (int)

リソース復元パラメーター

名前 Description 価値
restoreSource 復元を開始する必要がある復元可能なデータベース アカウントの ID。 例: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} 文字列
restoreTimestampInUtc アカウントを復元する必要がある時間 (ISO-8601 形式)。 文字列
restoreWithTtlDisabled (英語) 復元が成功した時点で、復元されたアカウントに Time-To-Live を無効にするかどうかを指定します。 ブール (bool)

SpatialSpec (空間スペック)

名前 Description 価値
パス インデックス作成の動作が適用されるパス。 インデックス パスは通常、ルートで始まり、ワイルドカード (/path/*) で終わる 文字列
パスの空間型の一覧 次のいずれかを含む文字列配列:
'ラインストリング'
「マルチポリゴン」
「ポイント」
「ポリゴン」

SqlContainerCreateUpdatePropertiesまたはSqlContainerGetProperties

名前 Description 価値
オプション 要求に適用するオプションのキーと値のペア。 これは、要求と共に送信されたヘッダーに対応します。 CreateUpdateOptionsOrSqlContainerGetPropertiesOptions の
リソース コンテナーの標準 JSON 形式 SqlContainerResourceOrSqlContainerGetPropertiesResource (必須)

SqlContainerResourceまたはSqlContainerGetPropertiesResource

名前 Description 価値
analyticalStorageTtl 分析 TTL。 整数 (int)
クライアント暗号化ポリシー コンテナーのクライアント暗号化ポリシー。 クライアント暗号化ポリシー
computedプロパティ 計算プロパティの一覧 計算済みプロパティ[]
conflictResolutionPolicy(コンフリクトレゾリューションポリシー) コンテナーの競合解決ポリシー。 ConflictResolutionPolicy (競合解決ポリシー)
createMode リソースの作成モードを示す列挙型。 デフォルト
'Restore'
データマスキングポリシー {{dataMaskingPolicy} コンテナーのデータ・マスキング・ポリシー。 データマスキングポリシー
デフォルトTtl 既定の有効期間 整数 (int)
フルテキストポリシー コンテナーの FullText ポリシー。 フルテキストポリシー
id Cosmos DB SQL コンテナーの名前 string (必須)
インデックスポリシー(いんでっくすいんぐ インデックス作成ポリシーの構成。 既定では、コンテナー内のすべてのドキュメント パスに対してインデックス作成が自動的に行われます。 インデックス作成ポリシー
materializedViewDefinition 具体化されたビューを定義するための構成。 これは、具体化されたビュー コンテナーを作成する場合にのみ指定する必要があります。 MaterializedViewDefinition (マテリアライズドビュー定義)
materializedビュー コンテナーで定義された具体化されたビュー。 MaterializedViewDetails[]
materializedViewsプロパティ マテリアライズドビューソースコンテナーに定義されたプロパティ。 MaterializedViewsプロパティ
partitionKey 複数のパーティションにデータをパーティション分割するために使用するパーティション キーの構成 コンテナパーティションキー
restoreParameters 復元に関する情報を示すパラメーター リソース復元パラメーター
uniqueKeyPolicy (ユニークキーポリシー) Azure Cosmos DB サービス内のコレクション内のドキュメントに対する一意性制約を指定するための一意キー ポリシー構成。 ユニークキーポリシー
vectorEmbeddingPolicy (ベクトル埋め込みポリシー) コンテナーのベクター埋め込みポリシー。 VectorEmbeddingPolicy の

タグ

名前 Description 価値

ユニークキー

名前 Description 価値
パス パスの一覧は、Azure Cosmos DB サービスのドキュメントごとに一意である必要があります string[]

ユニークキーポリシー

名前 Description 価値
uniqueKeys(ユニークキー) Azure Cosmos DB サービスのコレクション内のドキュメントに一意性制約を適用する一意キーの一覧。 ユニークキー[]

ベクトル埋め込み

名前 Description 価値
データタイプ ベクターのデータ型を示します。 'float16'
'float32'
'int8'
'uint8' (必須)
dimensions ベクトル内の次元の数。 int (必須)
distance関数 ベクトル間の距離計算に使用する距離関数。 「コサイン」
'ドット製品'
'euclidean' (必須)
パス ドキュメント内のベクター フィールドへのパス。 string (必須)

VectorEmbeddingPolicy (英語)

名前 Description 価値
ベクトル埋め込み ベクター埋め込みの一覧 ベクター埋め込み[]

ベクトルインデックス

名前 Description 価値
インデックス検索リストサイズ これは、最適化プロセスの一環として DiskANN インデックスを構築する際に格納される近似隣接の候補リストのサイズです。 値を大きくすると、待機時間が犠牲になっても再現率が向上する可能性があります。 これは、diskANN ベクトルインデックスタイプにのみ適用されます。 int

Constraints:
最小値 = 25
最大値 = 500
パス ドキュメント内のベクター フィールドへのパス。 string (必須)
量子化バイトサイズ ベクトルの積量子化に使用されるバイト数。 値を大きくすると、待ち時間が犠牲になりますが、ベクトル検索の再現率が向上します。 これは、quantizedFlat および diskANN ベクトルインデックス型にのみ適用されます。 int

Constraints:
最小値 = 4
ベクターのインデックス型。 現在、フラット、diskANN、およびクオンタイズフラットがサポートされています。 'diskANN'
「フラット」
'quantizedFlat' (必須)
vectorIndexShardKey (ベクトルインデックスシャードキー) ベクトルインデックスのシャードキーの配列。 これは、quantizedFlat および diskANN ベクトルインデックス型にのみ適用されます。 string[]

使用例

Terraformサンプル

Cosmos DB アカウント内に SQL コンテナーをデプロイする基本的な例。

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "databaseAccount" {
  type      = "Microsoft.DocumentDB/databaseAccounts@2021-10-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "GlobalDocumentDB"
    properties = {
      capabilities = [
      ]
      consistencyPolicy = {
        defaultConsistencyLevel = "BoundedStaleness"
        maxIntervalInSeconds    = 10
        maxStalenessPrefix      = 200
      }
      databaseAccountOfferType           = "Standard"
      defaultIdentity                    = "FirstPartyIdentity"
      disableKeyBasedMetadataWriteAccess = false
      disableLocalAuth                   = false
      enableAnalyticalStorage            = false
      enableAutomaticFailover            = false
      enableFreeTier                     = false
      enableMultipleWriteLocations       = false
      ipRules = [
      ]
      isVirtualNetworkFilterEnabled = false
      locations = [
        {
          failoverPriority = 0
          isZoneRedundant  = false
          locationName     = "West Europe"
        },
      ]
      networkAclBypass = "None"
      networkAclBypassResourceIds = [
      ]
      publicNetworkAccess = "Enabled"
      virtualNetworkRules = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "sqlDatabase" {
  type      = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2021-10-15"
  parent_id = azapi_resource.databaseAccount.id
  name      = var.resource_name
  body = {
    properties = {
      options = {
        throughput = 400
      }
      resource = {
        id = var.resource_name
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "container" {
  type      = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-04-15"
  parent_id = azapi_resource.sqlDatabase.id
  name      = var.resource_name
  body = {
    properties = {
      options = {
      }
      resource = {
        id = "test-containerWest Europe"
        partitionKey = {
          kind = "Hash"
          paths = [
            "/definition",
          ]
        }
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}