你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.DocumentDB databaseAccounts/sqlDatabases/containers

• 最新
• 2024-12-01-preview
• 2024-11-15
• 2024-09-01-preview
• 2024-08-15
• 2024-05-15
• 2024-05-15-preview
• 2024-02-15-preview
• 2023-11-15
• 2023-11-15-preview
• 2023-09-15
• 2023-09-15-preview
• 2023-04-15
• 2023-03-15
• 2023-03-15-preview
• 2023-03-01-preview
• 2022-11-15
• 2022-11-15-preview
• 2022-08-15
• 2022-08-15-preview
• 2022-05-15
• 2022-05-15-preview
• 2022-02-15-preview
• 2021-11-15-preview
• 2021-10-15
• 2021-10-15-preview
• 2021-07-01-preview
• 2021-06-15
• 2021-05-15
• 2021-04-15
• 2021-04-01-preview
• 2021-03-15
• 2021-03-01-preview
• 2021-01-15
• 2020-09-01
• 2020-06-01-preview
• 2020-04-01
• 2020-03-01
• 2019-12-12
• 2019-08-01

Bicep 资源定义

可以使用目标操作部署 databaseAccounts/sqlDatabases/containers 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2024-12-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'
      defaultTtl: int
      id: 'string'
      indexingPolicy: {
        automatic: bool
        compositeIndexes: [
          [
            {
              order: 'string'
              path: 'string'
            }
          ]
        ]
        excludedPaths: [
          {
            path: 'string'
          }
        ]
        includedPaths: [
          {
            indexes: [
              {
                dataType: 'string'
                kind: 'string'
                precision: int
              }
            ]
            path: 'string'
          }
        ]
        indexingMode: 'string'
        spatialIndexes: [
          {
            path: 'string'
            types: [
              'string'
            ]
          }
        ]
        vectorIndexes: [
          {
            path: 'string'
            type: 'string'
          }
        ]
      }
      materializedViewDefinition: {
        definition: 'string'
        sourceCollectionId: 'string'
      }
      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'
  }
}

属性值

AutoscaleSettings

名字	描述	价值
maxThroughput	表示最大吞吐量，资源可以纵向扩展。	int

ClientEncryptionIncludedPath

名字	描述	价值
clientEncryptionKeyId	用于加密路径的客户端加密密钥的标识符。	string （必需）
encryptionAlgorithm	将使用的加密算法。 例如 - AEAD_AES_256_CBC_HMAC_SHA256。	string （必需）
encryptionType	要执行的加密类型。 例如 - 确定性、随机化。	string （必需）
路径	需要加密的路径。	string （必需）

ClientEncryptionPolicy

名字	描述	价值
includedPaths	需要加密的项的路径以及特定于路径的设置。	ClientEncryptionIncludedPath[] （必需）
policyFormatVersion	客户端加密策略定义的版本。 支持的版本为 1 和 2。 版本 2 支持 ID 和分区密钥路径加密。	int 约束： 最小值 = 1 最大值 = 2 （必需）

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

名字	描述	价值

CompositePath

名字	描述	价值
次序	复合路径的排序顺序。	“ascending” “descending”
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

ComputedProperty

名字	描述	价值
名字	计算属性的名称，例如 -“cp_lowerName”	字符串
查询	计算计算属性的值的查询，例如 - “SELECT VALUE LOWER（c.name） FROM c”	字符串

ConflictResolutionPolicy

名字	描述	价值
conflictResolutionPath	LastWriterWins 模式下的冲突解决路径。	字符串
conflictResolutionProcedure	解决自定义模式冲突的过程。	字符串
模式	指示冲突解决模式。	“Custom” “LastWriterWins”

ContainerPartitionKey

名字	描述	价值
类	指示用于分区的算法类型。 对于 MultiHash，容器创建支持多个分区键（最多三个最大值）	“Hash” “MultiHash” “Range”
路径	使用容器中的数据可以分区的路径列表	string[]
版本	指示分区键定义的版本	int 约束： 最小值 = 1 最大值 = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

名字	描述	价值
autoscaleSettings	指定自动缩放设置。 注意：需要吞吐量或自动缩放设置，但不需要两者。	AutoscaleSettings
吞吐量	每秒请求单位数。 例如，“throughput”：10000。	int

ExcludedPath

名字	描述	价值
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

IncludedPath

名字	描述	价值
指标	此路径的索引列表	索引[]
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

指标

名字	描述	价值
dataType	为其应用索引行为的数据类型。	“LineString” “MultiPolygon” “Number” “Point” “Polygon” “String”
类	指示索引的类型。	“Hash” “Range” “Spatial”
精度	索引的精度。 -1 是最大精度。	int

IndexingPolicy

名字	描述	价值
自动	指示索引策略是否自动	bool
compositeIndexes	复合路径列表列表	CompositePath[][]
excludedPaths	要从索引中排除的路径列表	ExcludedPath[]
includedPaths	要包含在索引中的路径列表	IncludedPath[]
indexingMode	指示索引模式。	“一致” “懒惰” “none”
spatialIndexes	空间细节列表	SpatialSpec[]
vectorIndexes	要包含在矢量索引中的路径列表	VectorIndex[]

ManagedServiceIdentity

名字	描述	价值
类型	用于资源的标识类型。 类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将从服务中删除任何标识。	“None” “SystemAssigned” “SystemAssigned，UserAssigned” “UserAssigned”
userAssignedIdentities	与资源关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。	ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

名字	描述	价值

MaterializedViewDefinition

名字	描述	价值
定义	定义应该是一个 SQL 查询，该查询将用于从源容器提取数据以填充到具体化视图容器中。	string （必需）
sourceCollectionId	将创建具体化视图的源容器的名称。	string （必需）

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

名字	描述	价值
身份	资源的标识。	ManagedServiceIdentity
位置	资源所属的资源组的位置。	字符串
名字	资源名称	string （必需）
父母	在 Bicep 中，可以为子资源指定父资源。 仅当子资源在父资源外部声明时，才需要添加此属性。 有关详细信息，请参阅 父资源外部的子资源。	类型资源的符号名称：databaseAccounts/sqlDatabases
性能	用于创建和更新 Azure Cosmos DB 容器的属性。	SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties（必需）
标签	资源标记	标记名称和值的字典。 请参阅模板 中的 标记

ResourceRestoreParameters

名字	描述	价值
restoreSource	必须从中启动还原的可还原数据库帐户的 ID。 例如：/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}	字符串
restoreTimestampInUtc	帐户必须还原到的时间（ISO-8601 格式）。	字符串
restoreWithTtlDisabled	指定还原的帐户是否在成功还原时禁用时间To-Live。	bool

SpatialSpec

名字	描述	价值
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串
类型	路径的空间类型列表	包含任一项的字符串数组： “LineString” “MultiPolygon” “Point” “Polygon”

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

名字	描述	价值
选项	要为请求应用的选项的键值对。 这对应于随请求一起发送的标头。	CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
资源	容器的标准 JSON 格式	SqlContainerResourceOrSqlContainerGetPropertiesResource（必需）

SqlContainerResourceOrSqlContainerGetPropertiesResource

名字	描述	价值
分析StorageTtl	分析 TTL。	int
clientEncryptionPolicy	容器的客户端加密策略。	ClientEncryptionPolicy
computedProperties	计算属性列表	ComputedProperty[]
conflictResolutionPolicy	容器的冲突解决策略。	ConflictResolutionPolicy
createMode	用于指示资源创建模式的枚举。	“Default” “还原”
defaultTtl	默认生存时间	int
id	Cosmos DB SQL 容器的名称	string （必需）
indexingPolicy	索引策略的配置。 默认情况下，容器中所有文档路径的索引都是自动的	IndexingPolicy
materializedViewDefinition	用于定义具体化视图的配置。 这必须仅用于创建具体化视图容器。	MaterializedViewDefinition
partitionKey	要用于将数据分区到多个分区的分区键的配置	ContainerPartitionKey
restoreParameters	指示有关还原的信息的参数	ResourceRestoreParameters
uniqueKeyPolicy	用于在 Azure Cosmos DB 服务中的集合中指定文档的唯一性约束的唯一键策略配置。	UniqueKeyPolicy
vectorEmbeddingPolicy	容器的向量嵌入策略。	VectorEmbeddingPolicy

标签

名字	描述	价值

UniqueKey

名字	描述	价值
路径	路径列表对于 Azure Cosmos DB 服务中的每个文档必须是唯一的	string[]

UniqueKeyPolicy

名字	描述	价值
uniqueKeys	在 Azure Cosmos DB 服务中对集合中的文档强制实施唯一性约束的唯一键列表。	UniqueKey[]

VectorEmbedding

名字	描述	价值
dataType	指示矢量的数据类型。	“float32” “int8” “uint8”（必需）
尺寸	矢量中的维度数。	int （必需）
distanceFunction	用于矢量之间的距离计算的距离函数。	“余弦” “dotproduct” “euclidean”（必需）
路径	文档中矢量字段的路径。	string （必需）

VectorEmbeddingPolicy

名字	描述	价值
vectorEmbeddings	矢量嵌入列表	VectorEmbedding[]

VectorIndex

名字	描述	价值
路径	文档中矢量字段的路径。	string （必需）
类型	矢量的索引类型。 目前支持平面、diskANN 和 quantizedFlat。	“diskANN” “flat” “quantizedFlat”（必需）

快速入门示例

以下快速入门示例部署此资源类型。

Bicep 文件	描述
使用分析存储 Azure Cosmos DB 帐户 SQL API	此模板为 Core （SQL） API 创建一个 Azure Cosmos 帐户，其中包含配置了分析存储的数据库和容器。
创建免费层 Azure Cosmos DB 帐户	此模板使用具有共享吞吐量和容器的数据库为 SQL API 创建免费层 Azure Cosmos DB 帐户。
为 Core （SQL） API 创建 Azure Cosmos DB 帐户	此模板创建一个 Azure Cosmos 帐户，用于 Core （SQL） API，其中包含具有多个其他选项的吞吐量的数据库和容器。
使用自动缩放 创建 Azure Cosmos DB 帐户 SQL API	此模板为 Core （SQL） API 创建一个 Azure Cosmos 帐户，该帐户包含具有多个其他选项的自动缩放吞吐量的数据库和容器。
创建 Azure Cosmos DB Core （SQL） API 存储过程	此模板创建一个用于 Core （SQL） API 的 Azure Cosmos DB 帐户，以及一个包含存储过程、触发器和用户定义的函数的容器。
使用容器应用创建 Dapr 微服务应用	使用容器应用创建 Dapr 微服务应用。
使用容器应用创建 Dapr pub-sub servicebus 应用	使用容器应用创建 Dapr pub-sub servicebus 应用。
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB	使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。

ARM 模板资源定义

可以使用目标操作部署 databaseAccounts/sqlDatabases/containers 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
  "apiVersion": "2024-12-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",
      "defaultTtl": "int",
      "id": "string",
      "indexingPolicy": {
        "automatic": "bool",
        "compositeIndexes": [
          [
            {
              "order": "string",
              "path": "string"
            }
          ]
        ],
        "excludedPaths": [
          {
            "path": "string"
          }
        ],
        "includedPaths": [
          {
            "indexes": [
              {
                "dataType": "string",
                "kind": "string",
                "precision": "int"
              }
            ],
            "path": "string"
          }
        ],
        "indexingMode": "string",
        "spatialIndexes": [
          {
            "path": "string",
            "types": [ "string" ]
          }
        ],
        "vectorIndexes": [
          {
            "path": "string",
            "type": "string"
          }
        ]
      },
      "materializedViewDefinition": {
        "definition": "string",
        "sourceCollectionId": "string"
      },
      "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"
  }
}

属性值

AutoscaleSettings

名字	描述	价值
maxThroughput	表示最大吞吐量，资源可以纵向扩展。	int

ClientEncryptionIncludedPath

名字	描述	价值
clientEncryptionKeyId	用于加密路径的客户端加密密钥的标识符。	string （必需）
encryptionAlgorithm	将使用的加密算法。 例如 - AEAD_AES_256_CBC_HMAC_SHA256。	string （必需）
encryptionType	要执行的加密类型。 例如 - 确定性、随机化。	string （必需）
路径	需要加密的路径。	string （必需）

ClientEncryptionPolicy

名字	描述	价值
includedPaths	需要加密的项的路径以及特定于路径的设置。	ClientEncryptionIncludedPath[] （必需）
policyFormatVersion	客户端加密策略定义的版本。 支持的版本为 1 和 2。 版本 2 支持 ID 和分区密钥路径加密。	int 约束： 最小值 = 1 最大值 = 2 （必需）

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

名字	描述	价值

CompositePath

名字	描述	价值
次序	复合路径的排序顺序。	“ascending” “descending”
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

ComputedProperty

名字	描述	价值
名字	计算属性的名称，例如 -“cp_lowerName”	字符串
查询	计算计算属性的值的查询，例如 - “SELECT VALUE LOWER（c.name） FROM c”	字符串

ConflictResolutionPolicy

名字	描述	价值
conflictResolutionPath	LastWriterWins 模式下的冲突解决路径。	字符串
conflictResolutionProcedure	解决自定义模式冲突的过程。	字符串
模式	指示冲突解决模式。	“Custom” “LastWriterWins”

ContainerPartitionKey

名字	描述	价值
类	指示用于分区的算法类型。 对于 MultiHash，容器创建支持多个分区键（最多三个最大值）	“Hash” “MultiHash” “Range”
路径	使用容器中的数据可以分区的路径列表	string[]
版本	指示分区键定义的版本	int 约束： 最小值 = 1 最大值 = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

名字	描述	价值
autoscaleSettings	指定自动缩放设置。 注意：需要吞吐量或自动缩放设置，但不需要两者。	AutoscaleSettings
吞吐量	每秒请求单位数。 例如，“throughput”：10000。	int

ExcludedPath

名字	描述	价值
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

IncludedPath

名字	描述	价值
指标	此路径的索引列表	索引[]
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

指标

名字	描述	价值
dataType	为其应用索引行为的数据类型。	“LineString” “MultiPolygon” “Number” “Point” “Polygon” “String”
类	指示索引的类型。	“Hash” “Range” “Spatial”
精度	索引的精度。 -1 是最大精度。	int

IndexingPolicy

名字	描述	价值
自动	指示索引策略是否自动	bool
compositeIndexes	复合路径列表列表	CompositePath[][]
excludedPaths	要从索引中排除的路径列表	ExcludedPath[]
includedPaths	要包含在索引中的路径列表	IncludedPath[]
indexingMode	指示索引模式。	“一致” “懒惰” “none”
spatialIndexes	空间细节列表	SpatialSpec[]
vectorIndexes	要包含在矢量索引中的路径列表	VectorIndex[]

ManagedServiceIdentity

名字	描述	价值
类型	用于资源的标识类型。 类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将从服务中删除任何标识。	“None” “SystemAssigned” “SystemAssigned，UserAssigned” “UserAssigned”
userAssignedIdentities	与资源关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。	ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

名字	描述	价值

MaterializedViewDefinition

名字	描述	价值
定义	定义应该是一个 SQL 查询，该查询将用于从源容器提取数据以填充到具体化视图容器中。	string （必需）
sourceCollectionId	将创建具体化视图的源容器的名称。	string （必需）

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

名字	描述	价值
apiVersion	API 版本	'2024-12-01-preview'
身份	资源的标识。	ManagedServiceIdentity
位置	资源所属的资源组的位置。	字符串
名字	资源名称	string （必需）
性能	用于创建和更新 Azure Cosmos DB 容器的属性。	SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties（必需）
标签	资源标记	标记名称和值的字典。 请参阅模板 中的 标记
类型	资源类型	“Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers”

ResourceRestoreParameters

名字	描述	价值
restoreSource	必须从中启动还原的可还原数据库帐户的 ID。 例如：/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}	字符串
restoreTimestampInUtc	帐户必须还原到的时间（ISO-8601 格式）。	字符串
restoreWithTtlDisabled	指定还原的帐户是否在成功还原时禁用时间To-Live。	bool

SpatialSpec

名字	描述	价值
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串
类型	路径的空间类型列表	包含任一项的字符串数组： “LineString” “MultiPolygon” “Point” “Polygon”

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

名字	描述	价值
选项	要为请求应用的选项的键值对。 这对应于随请求一起发送的标头。	CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
资源	容器的标准 JSON 格式	SqlContainerResourceOrSqlContainerGetPropertiesResource（必需）

SqlContainerResourceOrSqlContainerGetPropertiesResource

名字	描述	价值
分析StorageTtl	分析 TTL。	int
clientEncryptionPolicy	容器的客户端加密策略。	ClientEncryptionPolicy
computedProperties	计算属性列表	ComputedProperty[]
conflictResolutionPolicy	容器的冲突解决策略。	ConflictResolutionPolicy
createMode	用于指示资源创建模式的枚举。	“Default” “还原”
defaultTtl	默认生存时间	int
id	Cosmos DB SQL 容器的名称	string （必需）
indexingPolicy	索引策略的配置。 默认情况下，容器中所有文档路径的索引都是自动的	IndexingPolicy
materializedViewDefinition	用于定义具体化视图的配置。 这必须仅用于创建具体化视图容器。	MaterializedViewDefinition
partitionKey	要用于将数据分区到多个分区的分区键的配置	ContainerPartitionKey
restoreParameters	指示有关还原的信息的参数	ResourceRestoreParameters
uniqueKeyPolicy	用于在 Azure Cosmos DB 服务中的集合中指定文档的唯一性约束的唯一键策略配置。	UniqueKeyPolicy
vectorEmbeddingPolicy	容器的向量嵌入策略。	VectorEmbeddingPolicy

标签

名字	描述	价值

UniqueKey

名字	描述	价值
路径	路径列表对于 Azure Cosmos DB 服务中的每个文档必须是唯一的	string[]

UniqueKeyPolicy

名字	描述	价值
uniqueKeys	在 Azure Cosmos DB 服务中对集合中的文档强制实施唯一性约束的唯一键列表。	UniqueKey[]

VectorEmbedding

名字	描述	价值
dataType	指示矢量的数据类型。	“float32” “int8” “uint8”（必需）
尺寸	矢量中的维度数。	int （必需）
distanceFunction	用于矢量之间的距离计算的距离函数。	“余弦” “dotproduct” “euclidean”（必需）
路径	文档中矢量字段的路径。	string （必需）

VectorEmbeddingPolicy

名字	描述	价值
vectorEmbeddings	矢量嵌入列表	VectorEmbedding[]

VectorIndex

名字	描述	价值
路径	文档中矢量字段的路径。	string （必需）
类型	矢量的索引类型。 目前支持平面、diskANN 和 quantizedFlat。	“diskANN” “flat” “quantizedFlat”（必需）

快速入门模板

以下快速入门模板部署此资源类型。

模板	描述
使用分析存储 Azure Cosmos DB 帐户 SQL API	此模板为 Core （SQL） API 创建一个 Azure Cosmos 帐户，其中包含配置了分析存储的数据库和容器。
创建免费层 Azure Cosmos DB 帐户	此模板使用具有共享吞吐量和容器的数据库为 SQL API 创建免费层 Azure Cosmos DB 帐户。
为 Core （SQL） API 创建 Azure Cosmos DB 帐户	此模板创建一个 Azure Cosmos 帐户，用于 Core （SQL） API，其中包含具有多个其他选项的吞吐量的数据库和容器。
使用自动缩放 创建 Azure Cosmos DB 帐户 SQL API	此模板为 Core （SQL） API 创建一个 Azure Cosmos 帐户，该帐户包含具有多个其他选项的自动缩放吞吐量的数据库和容器。
创建 Azure Cosmos DB Core （SQL） API 存储过程	此模板创建一个用于 Core （SQL） API 的 Azure Cosmos DB 帐户，以及一个包含存储过程、触发器和用户定义的函数的容器。
使用容器应用创建 Dapr 微服务应用	使用容器应用创建 Dapr 微服务应用。
使用容器应用创建 Dapr pub-sub servicebus 应用	使用容器应用创建 Dapr pub-sub servicebus 应用。
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB	使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。

Terraform （AzAPI 提供程序）资源定义

可以使用目标操作部署 databaseAccounts/sqlDatabases/containers 资源类型：

• 资源组

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2024-12-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
        defaultTtl = int
        id = "string"
        indexingPolicy = {
          automatic = bool
          compositeIndexes = [
            [
              {
                order = "string"
                path = "string"
              }
            ]
          ]
          excludedPaths = [
            {
              path = "string"
            }
          ]
          includedPaths = [
            {
              indexes = [
                {
                  dataType = "string"
                  kind = "string"
                  precision = int
                }
              ]
              path = "string"
            }
          ]
          indexingMode = "string"
          spatialIndexes = [
            {
              path = "string"
              types = [
                "string"
              ]
            }
          ]
          vectorIndexes = [
            {
              path = "string"
              type = "string"
            }
          ]
        }
        materializedViewDefinition = {
          definition = "string"
          sourceCollectionId = "string"
        }
        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"
            }
          ]
        }
      }
    }
  })
}

属性值

AutoscaleSettings

名字	描述	价值
maxThroughput	表示最大吞吐量，资源可以纵向扩展。	int

ClientEncryptionIncludedPath

名字	描述	价值
clientEncryptionKeyId	用于加密路径的客户端加密密钥的标识符。	string （必需）
encryptionAlgorithm	将使用的加密算法。 例如 - AEAD_AES_256_CBC_HMAC_SHA256。	string （必需）
encryptionType	要执行的加密类型。 例如 - 确定性、随机化。	string （必需）
路径	需要加密的路径。	string （必需）

ClientEncryptionPolicy

名字	描述	价值
includedPaths	需要加密的项的路径以及特定于路径的设置。	ClientEncryptionIncludedPath[] （必需）
policyFormatVersion	客户端加密策略定义的版本。 支持的版本为 1 和 2。 版本 2 支持 ID 和分区密钥路径加密。	int 约束： 最小值 = 1 最大值 = 2 （必需）

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

名字	描述	价值

CompositePath

名字	描述	价值
次序	复合路径的排序顺序。	“ascending” “descending”
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

ComputedProperty

名字	描述	价值
名字	计算属性的名称，例如 -“cp_lowerName”	字符串
查询	计算计算属性的值的查询，例如 - “SELECT VALUE LOWER（c.name） FROM c”	字符串

ConflictResolutionPolicy

名字	描述	价值
conflictResolutionPath	LastWriterWins 模式下的冲突解决路径。	字符串
conflictResolutionProcedure	解决自定义模式冲突的过程。	字符串
模式	指示冲突解决模式。	“Custom” “LastWriterWins”

ContainerPartitionKey

名字	描述	价值
类	指示用于分区的算法类型。 对于 MultiHash，容器创建支持多个分区键（最多三个最大值）	“Hash” “MultiHash” “Range”
路径	使用容器中的数据可以分区的路径列表	string[]
版本	指示分区键定义的版本	int 约束： 最小值 = 1 最大值 = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

名字	描述	价值
autoscaleSettings	指定自动缩放设置。 注意：需要吞吐量或自动缩放设置，但不需要两者。	AutoscaleSettings
吞吐量	每秒请求单位数。 例如，“throughput”：10000。	int

ExcludedPath

名字	描述	价值
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

IncludedPath

名字	描述	价值
指标	此路径的索引列表	索引[]
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串

指标

名字	描述	价值
dataType	为其应用索引行为的数据类型。	“LineString” “MultiPolygon” “Number” “Point” “Polygon” “String”
类	指示索引的类型。	“Hash” “Range” “Spatial”
精度	索引的精度。 -1 是最大精度。	int

IndexingPolicy

名字	描述	价值
自动	指示索引策略是否自动	bool
compositeIndexes	复合路径列表列表	CompositePath[][]
excludedPaths	要从索引中排除的路径列表	ExcludedPath[]
includedPaths	要包含在索引中的路径列表	IncludedPath[]
indexingMode	指示索引模式。	“一致” “懒惰” “none”
spatialIndexes	空间细节列表	SpatialSpec[]
vectorIndexes	要包含在矢量索引中的路径列表	VectorIndex[]

ManagedServiceIdentity

名字	描述	价值
类型	用于资源的标识类型。 类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将从服务中删除任何标识。	“None” “SystemAssigned” “SystemAssigned，UserAssigned” “UserAssigned”
userAssignedIdentities	与资源关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。	ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

名字	描述	价值

MaterializedViewDefinition

名字	描述	价值
定义	定义应该是一个 SQL 查询，该查询将用于从源容器提取数据以填充到具体化视图容器中。	string （必需）
sourceCollectionId	将创建具体化视图的源容器的名称。	string （必需）

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

名字	描述	价值
身份	资源的标识。	ManagedServiceIdentity
位置	资源所属的资源组的位置。	字符串
名字	资源名称	string （必需）
parent_id	此资源的父资源的 ID。	类型资源的 ID：databaseAccounts/sqlDatabases
性能	用于创建和更新 Azure Cosmos DB 容器的属性。	SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties（必需）
标签	资源标记	标记名称和值的字典。
类型	资源类型	“Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2024-12-01-preview”

ResourceRestoreParameters

名字	描述	价值
restoreSource	必须从中启动还原的可还原数据库帐户的 ID。 例如：/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}	字符串
restoreTimestampInUtc	帐户必须还原到的时间（ISO-8601 格式）。	字符串
restoreWithTtlDisabled	指定还原的帐户是否在成功还原时禁用时间To-Live。	bool

SpatialSpec

名字	描述	价值
路径	索引行为应用于的路径。 索引路径通常以根开头，以通配符结尾（/path/*）	字符串
类型	路径的空间类型列表	包含任一项的字符串数组： “LineString” “MultiPolygon” “Point” “Polygon”

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

名字	描述	价值
选项	要为请求应用的选项的键值对。 这对应于随请求一起发送的标头。	CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
资源	容器的标准 JSON 格式	SqlContainerResourceOrSqlContainerGetPropertiesResource（必需）

SqlContainerResourceOrSqlContainerGetPropertiesResource

名字	描述	价值
分析StorageTtl	分析 TTL。	int
clientEncryptionPolicy	容器的客户端加密策略。	ClientEncryptionPolicy
computedProperties	计算属性列表	ComputedProperty[]
conflictResolutionPolicy	容器的冲突解决策略。	ConflictResolutionPolicy
createMode	用于指示资源创建模式的枚举。	“Default” “还原”
defaultTtl	默认生存时间	int
id	Cosmos DB SQL 容器的名称	string （必需）
indexingPolicy	索引策略的配置。 默认情况下，容器中所有文档路径的索引都是自动的	IndexingPolicy
materializedViewDefinition	用于定义具体化视图的配置。 这必须仅用于创建具体化视图容器。	MaterializedViewDefinition
partitionKey	要用于将数据分区到多个分区的分区键的配置	ContainerPartitionKey
restoreParameters	指示有关还原的信息的参数	ResourceRestoreParameters
uniqueKeyPolicy	用于在 Azure Cosmos DB 服务中的集合中指定文档的唯一性约束的唯一键策略配置。	UniqueKeyPolicy
vectorEmbeddingPolicy	容器的向量嵌入策略。	VectorEmbeddingPolicy

标签

名字	描述	价值

UniqueKey

名字	描述	价值
路径	路径列表对于 Azure Cosmos DB 服务中的每个文档必须是唯一的	string[]

UniqueKeyPolicy

名字	描述	价值
uniqueKeys	在 Azure Cosmos DB 服务中对集合中的文档强制实施唯一性约束的唯一键列表。	UniqueKey[]

VectorEmbedding

名字	描述	价值
dataType	指示矢量的数据类型。	“float32” “int8” “uint8”（必需）
尺寸	矢量中的维度数。	int （必需）
distanceFunction	用于矢量之间的距离计算的距离函数。	“余弦” “dotproduct” “euclidean”（必需）
路径	文档中矢量字段的路径。	string （必需）

VectorEmbeddingPolicy

名字	描述	价值
vectorEmbeddings	矢量嵌入列表	VectorEmbedding[]

VectorIndex

名字	描述	价值
路径	文档中矢量字段的路径。	string （必需）
类型	矢量的索引类型。 目前支持平面、diskANN 和 quantizedFlat。	“diskANN” “flat” “quantizedFlat”（必需）