Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
- последние
- 2026-04-01-превью
- 2026-03-15
- 2025-11-01-превью
- 2025-10-15
- 2025-05-01-превью
- 2025-04-15
- 2024-12-01-превью
- 2024-11-15
- 2024-09-01-превью
- 2024-08-15
- 2024-05-15
- 2024-05-15-превью
- 2024-02-15-превью
- 2023-11-15
- 2023-11-15-превью
- 2023-09-15
- 2023-09-15-превью
- 2023-04-15
- 2023-03-15
- 2023-03-15-превью
- 2023-03-01-превью
- 2022-11-15
- 2022-11-15-превью
- 2022-08-15
- 2022-08-15-превью
- 2022-05-15
- 2022-05-15-превью
- 2022-02-15-превью
- 2021-11-15-превью
- 2021-10-15
- 2021-10-15-превью
- 2021-07-01-превью
- 2021-06-15
- 2021-05-15
- 2021-04-15
- 2021-04-01-превью
- 2021-03-15
- 2021-03-01-превью
- 2021-01-15
- 2020-09-01
- 2020-06-01-превью
- 2020-04-01
- 2020-03-01
- 2019-12-12
- 2019-08-01
Определение ресурсов Bicep
Тип ресурса databaseAccounts/sqlDatabases/container можно развернуть с помощью операций, предназначенных для следующих операций:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.DocumentDB/databaseAccounts/sqlDatabases/container, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2026-04-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/container
| Имя | Описание | Ценность |
|---|---|---|
| тождество | Удостоверение ресурса. | ManagedServiceIdentity (Управляемый сервисИдентификация) |
| местоположение | Расположение группы ресурсов, к которой принадлежит ресурс. | струна |
| имя | Имя ресурса | строка (обязательно) |
| родитель | В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса. Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса. |
Символьное имя ресурса типа: databaseAccounts/sqlDatabases |
| свойства | Свойства для создания и обновления контейнера Azure Cosmos DB. | SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
ARMResourcePropertiesTags
| Имя | Описание | Ценность |
|---|
АвтомасштабированиеSettings
| Имя | Описание | Ценность |
|---|---|---|
| maxПропускная способность | Представляет максимальную пропускную способность, ресурс может масштабироваться до. | инт |
ClientEncryptionIncludedPath
| Имя | Описание | Ценность |
|---|---|---|
| clientEncryptionKeyId | Идентификатор ключа шифрования клиента, который будет использоваться для шифрования пути. | строка (обязательно) |
| шифрованиеАлгоритм | Алгоритм шифрования, который будет использоваться. Например - AEAD_AES_256_CBC_HMAC_SHA256. | строка (обязательно) |
| encryptionType | Тип выполняемого шифрования. Например, детерминированное, случайное. | строка (обязательно) |
| путь | Путь, который необходимо зашифровать. | строка (обязательно) |
ClientEncryptionPolicy
| Имя | Описание | Ценность |
|---|---|---|
| включенныеPaths | Пути элемента, нуждающегося в шифровании, вместе с параметрами конкретного пути. | ClientEncryptionIncludedPath[] (обязательно) |
| policyFormatVersion | Версия определения политики шифрования клиента. Поддерживаемые версии: 1 и 2. Версия 2 поддерживает шифрование пути идентификатора и ключа секции. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 2 (обязательно) |
Составной Путь
| Имя | Описание | Ценность |
|---|---|---|
| порядок | Порядок сортировки составных путей. | "возрастание" "убывание" |
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
ComputedProperty (ВычислительноеСвойство)
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя вычисляемого свойства, например "cp_lowerName" | струна |
| запрос | Запрос, вычисляющий значение вычисляемого свойства, например "SELECT VALUE LOWER(c.name) FROM c" | струна |
Политика разрешения конфликтов
| Имя | Описание | Ценность |
|---|---|---|
| conflictResolutionPath | Путь разрешения конфликтов в режиме LastWriterWins. | струна |
| Процедура разрешения конфликта | Процедура разрешения конфликтов в случае пользовательского режима. | струна |
| режим | Указывает режим разрешения конфликтов. | "Custom" "LastWriterWins" |
ContainerPartitionKey (Ключ контейнераPartition)
| Имя | Описание | Ценность |
|---|---|---|
| добрый | Указывает тип алгоритма, используемого для секционирования. Для MultiHash для создания контейнера поддерживаются несколько ключей секций (не более трех). | Хэш MultiHash "Диапазон" |
| Пути | Список путей, с помощью которых можно секционировать данные в контейнере | строка[] |
| Версия | Указывает версию определения ключа секции | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 2 |
CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
| Имя | Описание | Ценность |
|---|---|---|
| autoscaleSettings | Задает параметры автомасштабирования. Примечание. Требуется либо пропускная способность, либо автомасштабированиеSettings, но не оба. | АвтомасштабированиеSettings |
| производительность | Единицы запроса в секунду. Например, "пропускная способность": 10000. | инт |
Политика маскировки данных
| Имя | Описание | Ценность |
|---|---|---|
| исключенныеПути | Список путей JSON для исключения из маскировки. | DataMaskingPolicyExcludedPathsItem[] |
| включенныеPaths | Список путей JSON, которые должны быть включены в политику маскирования. | DataMaskingPolicyIncludedPathsItem[] |
| isPolicyEnabled | Флаг, указывающий, включена ли политика маскировки данных. | булевая переменная (bool) |
DataMaskingPolicyExcludedPathsItem
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь JSON для исключения из маскировки (например, "/id"). | строка (обязательно) |
DataMaskingPolicyIncludedPathsItem
| Имя | Описание | Ценность |
|---|---|---|
| length | Длина подстроки для маски (если применимо). | инт |
| путь | Путь JSON для применения маскировки (например, "/contact/phones"). | строка (обязательно) |
| startPosition | Начальная позиция для маскировки подстроки (если применимо). | инт |
| strategy | Применить стратегию маскировки (например, "MaskSubstring"). | струна |
ИсключенныйPath
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
FullTextIndexPath (Полный текстИндексPath)
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь к полю полнотекстового текста в документе. | строка (обязательно) |
FullTextPath (Полный текстPath)
| Имя | Описание | Ценность |
|---|---|---|
| язык | Язык полнотекстового поля в документе. | струна |
| путь | Путь к полю полнотекстового текста в документе. | строка (обязательно) |
FullTextPolicy
| Имя | Описание | Ценность |
|---|---|---|
| Язык defaultLanguage | Язык по умолчанию для полнотекстовых путей. | струна |
| fullTextPaths | Список путей FullText | FullTextPath[] |
Включенныйpath
Индексы
| Имя | Описание | Ценность |
|---|---|---|
| тип данных | Тип данных, к которому применяется индексирование. | LineString «Мультиполигон» "Число" "Точка" "Многоугольник" "String" |
| добрый | Указывает тип индекса. | Хэш "Диапазон" "Пространственный" |
| точность | Точность индекса. -1 — максимальная точность. | инт |
Политика Индексации
| Имя | Описание | Ценность |
|---|---|---|
| Автоматически | Указывает, является ли политика индексирования автоматической | булевая переменная (bool) |
| составныеIndexes | Список составных путей | Композитный путь[][] |
| исключенныеПути | Список путей для исключения из индексирования | ИсключенныйPath[] |
| fullTextIndexes | Список путей для включения в полнотекстовую индексацию | FullTextIndexPath[] |
| включенныеPaths | Список путей для включения в индексирование | ВключенныйPath[] |
| Режим индексирования | Указывает режим индексирования. | "согласованный" "ленивый" "нет" |
| spatialIndexes | Список пространственных особенностей | Пространственная специализация[] |
| vectorIndexes | Список путей для включения в векторного индексирования | Векторный индекс[] |
Управляемая служебная идентичность
| Имя | Описание | Ценность |
|---|---|---|
| тип | Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы. | "Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned |
| ИдентичностиНазначенныеПользователем | Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Имя | Описание | Ценность |
|---|
ManagedServiceIdentityUserAssignedIdentities
| Имя | Описание | Ценность |
|---|
MaterializedViewDefinition (МатериализованноеViewDefinition)
| Имя | Описание | Ценность |
|---|---|---|
| определение | Определение должно быть SQL-запросом, который будет использоваться для получения данных из исходного контейнера для заполнения в контейнер материализованного представления. | строка (обязательно) |
| sourceCollectionId | Имя исходного контейнера, на котором будет создано материализованное представление. | строка (обязательно) |
| throughputBucketForBuild | Контейнер пропускной способности, назначенный для операций материализованного представления в целевом контейнере. | инт |
МатериализованныйВидДетали
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Поле идентификатора контейнера Materialized. | струна |
| _удалить | _rid поле материализованного контейнера. | струна |
MaterializedViewsProperties (МатериализованныеViewsProperties)
| Имя | Описание | Ценность |
|---|---|---|
| throughputBucketForBuild | Контейнер пропускной способности, назначенный для операций материализованного представления в исходном контейнере. | инт |
ResourceRestoreParameters (Параметры восстановления)
| Имя | Описание | Ценность |
|---|---|---|
| restoreSource | Идентификатор учетной записи базы данных, из которой необходимо инициировать восстановление. Например: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/location/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} | струна |
| restoreTimestampInUtc | Время восстановления учетной записи (формат ISO-8601). | струна |
| restoreWithTtlDisabled | Указывает, будет ли восстановленная учетная запись иметь время-To-Live отключена при успешном восстановлении. | булевая переменная (bool) |
ПространственнаяСпецификация
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
| Типы | Список пространственного типа пути | Массив строк, содержащий любой из: LineString «Мультиполигон» "Точка" "Многоугольник" |
SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties
| Имя | Описание | Ценность |
|---|---|---|
| Параметры | Пара параметров с ключом-значением, применяемая для запроса. Это соответствует заголовкам, отправленным запросом. | CreateUpdateOptionsOrSqlContainerGetPropertiesOptions |
| ресурс | Стандартный формат JSON контейнера | SqlContainerResourceOrSqlContainerGetPropertiesResource (обязательно) |
SqlContainerResourceOrSqlContainerGetPropertiesResource
| Имя | Описание | Ценность |
|---|---|---|
| analyticStorageTtl | Аналитический TTL. | инт |
| clientEncryptionPolicy | Политика шифрования клиента для контейнера. | ClientEncryptionPolicy |
| computedProperties | Список вычисляемых свойств | ComputedProperty[] |
| Политика разрешения конфликтов | Политика разрешения конфликтов для контейнера. | Политика разрешения конфликтов |
| createMode | Перечисление, указывающее режим создания учетной записи. | По умолчанию "Восстановить" |
| dataMaskingPolicy | Политика маскирования данных для контейнера. | Политика маскировки данных |
| defaultTtl | Время жизни по умолчанию | инт |
| fullTextPolicy | Политика FullText для контейнера. | FullTextPolicy |
| идентификатор | Имя контейнера SQL Cosmos DB | строка (обязательно) |
| Политика индексации | Конфигурация политики индексирования. По умолчанию индексирование выполняется автоматически для всех путей к документам в контейнере. | Политика индексации |
| materializedViewDefinition | Конфигурация определения материализованных представлений. Это необходимо указать только для создания контейнера "Материализованное представление". | MaterializedViewDefinition (МатериализованноеViewDefinition) |
| materializedViews | Материализованные представления, определенные в контейнере. | МатериализованныйВидПодробности[] |
| materializedViewsProperties | Свойства материализованных представлений, определенные для исходного контейнера. | MaterializedViewsProperties (МатериализованныеViewsProperties) |
| partitionKey | Конфигурация ключа секции, используемого для секционирования данных на несколько секций | ContainerPartitionKey (Ключ контейнераPartition) |
| restoreParameters | Параметры для указания сведений о восстановлении | ResourceRestoreParameters (Параметры восстановления) |
| uniqueKeyPolicy | Конфигурация уникальной политики ключей для указания ограничений уникальности для документов в коллекции в службе Azure Cosmos DB. | Политика UniqueKeyPolicy |
| vectorEmbeddingPolicy | Политика внедрения вектора для контейнера. | Политика VectorEmbeddingPolicy |
Уникальный ключ
| Имя | Описание | Ценность |
|---|---|---|
| Пути | Список путей должен быть уникальным для каждого документа в службе Azure Cosmos DB. | строка[] |
Политика UniqueKeyPolicy
| Имя | Описание | Ценность |
|---|---|---|
| uniqueKeys | Список уникальных ключей, которые применяют ограничение уникальности для документов в коллекции в службе Azure Cosmos DB. | УникальныйКлюч[] |
ВекторВстраивание
| Имя | Описание | Ценность |
|---|---|---|
| тип данных | Указывает тип данных вектора. | Float16 «Поплавок32» 'int8' Uint8 (обязательный) |
| Размеры | Количество измерений в векторе. | int (обязательно) |
| distanceФункция | Функция расстояния, используемая для вычисления расстояния между векторами. | "косинус" "dotproduct" 'euclidean' (обязательный) |
| путь | Путь к полю вектора в документе. | строка (обязательно) |
Политика VectorEmbeddingPolicy
| Имя | Описание | Ценность |
|---|---|---|
| vectorEmbeddings | Список внедрения векторов | VectorEmbedding[] |
Векторный индекс
| Имя | Описание | Ценность |
|---|---|---|
| indexingSearchListSize | Это размер списка потенциальных соседей, хранящегося при построении индекса DiskANN в рамках процессов оптимизации. Большие значения могут улучшить запоминание за счет задержки. Это применимо только для векторного индекса типа diskANN. | int Ограничения целостности: Минимальное значение = 25 Максимальное значение = 500 |
| путь | Путь к полю вектора в документе. | строка (обязательно) |
| quantizationByteSize | Количество байтов, используемых при квантовании векторов по произведению. Большее значение может привести к лучшей запоминаемости для векторного поиска за счет задержки. Это применимо только для векторных индексов типа quantizedFlat и diskANN. | int Ограничения целостности: Минимальное значение = 4 |
| тип | Тип индекса вектора. В настоящее время поддерживаются плоская, дисковая, дисковая и квантизованнаяFlat. | DiskANN "плоская" "quantizedFlat" (обязательный) |
| vectorIndexShardKey | Массив ключей шардов для векторного индекса. Это применимо только для векторных индексов типа quantizedFlat и diskANN. | строка[] |
Примеры использования
Примеры Bicep
Простой пример развертывания контейнера SQL в учетной записи Cosmos DB.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource databaseAccount 'Microsoft.DocumentDB/databaseAccounts@2021-10-15' = {
name: resourceName
location: location
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: []
}
}
resource sqlDatabase 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2021-10-15' = {
name: resourceName
parent: databaseAccount
properties: {
options: {
throughput: 400
}
resource: {
id: resourceName
}
}
}
resource container 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-04-15' = {
name: resourceName
parent: sqlDatabase
properties: {
options: {}
resource: {
id: 'test-containerWest Europe'
partitionKey: {
kind: 'Hash'
paths: [
'/definition'
]
}
}
}
}
Примеры быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.
| Bicep-файл | Описание |
|---|---|
| API SQL учетной записи Azure Cosmos DB с аналитическим хранилищем | Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером, настроенным с помощью аналитического хранилища. |
| Создание учетной записи Azure Cosmos DB уровня "Бесплатный" | Этот шаблон создает бесплатную учетную запись Azure Cosmos DB для API SQL с базой данных с общей пропускной способностью и контейнером. |
| создание учетной записи Azure Cosmos DB для API Core (SQL) | Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с пропускной способностью с несколькими другими параметрами. |
| создание API SQL учетной записи Azure Cosmos DB с автомасштабированием | Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с пропускной способностью автомасштабирования с несколькими другими параметрами. |
| Создание хранимых процедур API Azure Cosmos DB Core (SQL) | Этот шаблон создает учетную запись Azure Cosmos DB для API Core (SQL) и контейнер с хранимой процедурой, триггером и определяемой пользователем функцией. |
| создает приложение микрослужб Dapr с помощью приложений контейнеров | Создайте приложение микрослужб Dapr с помощью контейнерных приложений. |
| Создает приложение dapr pub-sub servicebus с помощью приложений контейнеров | Создайте приложение dapr pub-sub servicebus с помощью контейнерных приложений. |
| Развертывание базы данных Azure Data Explorer с помощью подключения Cosmos DB | Разверните базу данных Azure Data Explorer с подключением Cosmos DB. |
Определение ресурса шаблона ARM
Тип ресурса databaseAccounts/sqlDatabases/container можно развернуть с помощью операций, предназначенных для следующих операций:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.DocumentDB/databaseAccounts/sqlDatabases/container, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
"apiVersion": "2026-04-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/container
| Имя | Описание | Ценность |
|---|---|---|
| apiVersion | Версия API | «2026-04-01-превью» |
| тождество | Удостоверение ресурса. | ManagedServiceIdentity (Управляемый сервисИдентификация) |
| местоположение | Расположение группы ресурсов, к которой принадлежит ресурс. | струна |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства для создания и обновления контейнера Azure Cosmos DB. | SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
| тип | Тип ресурса | "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/container" |
ARMResourcePropertiesTags
| Имя | Описание | Ценность |
|---|
АвтомасштабированиеSettings
| Имя | Описание | Ценность |
|---|---|---|
| maxПропускная способность | Представляет максимальную пропускную способность, ресурс может масштабироваться до. | инт |
ClientEncryptionIncludedPath
| Имя | Описание | Ценность |
|---|---|---|
| clientEncryptionKeyId | Идентификатор ключа шифрования клиента, который будет использоваться для шифрования пути. | строка (обязательно) |
| шифрованиеАлгоритм | Алгоритм шифрования, который будет использоваться. Например - AEAD_AES_256_CBC_HMAC_SHA256. | строка (обязательно) |
| encryptionType | Тип выполняемого шифрования. Например, детерминированное, случайное. | строка (обязательно) |
| путь | Путь, который необходимо зашифровать. | строка (обязательно) |
ClientEncryptionPolicy
| Имя | Описание | Ценность |
|---|---|---|
| включенныеPaths | Пути элемента, нуждающегося в шифровании, вместе с параметрами конкретного пути. | ClientEncryptionIncludedPath[] (обязательно) |
| policyFormatVersion | Версия определения политики шифрования клиента. Поддерживаемые версии: 1 и 2. Версия 2 поддерживает шифрование пути идентификатора и ключа секции. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 2 (обязательно) |
Составной Путь
| Имя | Описание | Ценность |
|---|---|---|
| порядок | Порядок сортировки составных путей. | "возрастание" "убывание" |
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
ComputedProperty (ВычислительноеСвойство)
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя вычисляемого свойства, например "cp_lowerName" | струна |
| запрос | Запрос, вычисляющий значение вычисляемого свойства, например "SELECT VALUE LOWER(c.name) FROM c" | струна |
Политика разрешения конфликтов
| Имя | Описание | Ценность |
|---|---|---|
| conflictResolutionPath | Путь разрешения конфликтов в режиме LastWriterWins. | струна |
| Процедура разрешения конфликта | Процедура разрешения конфликтов в случае пользовательского режима. | струна |
| режим | Указывает режим разрешения конфликтов. | "Custom" "LastWriterWins" |
ContainerPartitionKey (Ключ контейнераPartition)
| Имя | Описание | Ценность |
|---|---|---|
| добрый | Указывает тип алгоритма, используемого для секционирования. Для MultiHash для создания контейнера поддерживаются несколько ключей секций (не более трех). | Хэш MultiHash "Диапазон" |
| Пути | Список путей, с помощью которых можно секционировать данные в контейнере | строка[] |
| Версия | Указывает версию определения ключа секции | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 2 |
CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
| Имя | Описание | Ценность |
|---|---|---|
| autoscaleSettings | Задает параметры автомасштабирования. Примечание. Требуется либо пропускная способность, либо автомасштабированиеSettings, но не оба. | АвтомасштабированиеSettings |
| производительность | Единицы запроса в секунду. Например, "пропускная способность": 10000. | инт |
Политика маскировки данных
| Имя | Описание | Ценность |
|---|---|---|
| исключенныеПути | Список путей JSON для исключения из маскировки. | DataMaskingPolicyExcludedPathsItem[] |
| включенныеPaths | Список путей JSON, которые должны быть включены в политику маскирования. | DataMaskingPolicyIncludedPathsItem[] |
| isPolicyEnabled | Флаг, указывающий, включена ли политика маскировки данных. | булевая переменная (bool) |
DataMaskingPolicyExcludedPathsItem
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь JSON для исключения из маскировки (например, "/id"). | строка (обязательно) |
DataMaskingPolicyIncludedPathsItem
| Имя | Описание | Ценность |
|---|---|---|
| length | Длина подстроки для маски (если применимо). | инт |
| путь | Путь JSON для применения маскировки (например, "/contact/phones"). | строка (обязательно) |
| startPosition | Начальная позиция для маскировки подстроки (если применимо). | инт |
| strategy | Применить стратегию маскировки (например, "MaskSubstring"). | струна |
ИсключенныйPath
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
FullTextIndexPath (Полный текстИндексPath)
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь к полю полнотекстового текста в документе. | строка (обязательно) |
FullTextPath (Полный текстPath)
| Имя | Описание | Ценность |
|---|---|---|
| язык | Язык полнотекстового поля в документе. | струна |
| путь | Путь к полю полнотекстового текста в документе. | строка (обязательно) |
FullTextPolicy
| Имя | Описание | Ценность |
|---|---|---|
| Язык defaultLanguage | Язык по умолчанию для полнотекстовых путей. | струна |
| fullTextPaths | Список путей FullText | FullTextPath[] |
Включенныйpath
Индексы
| Имя | Описание | Ценность |
|---|---|---|
| тип данных | Тип данных, к которому применяется индексирование. | LineString «Мультиполигон» "Число" "Точка" "Многоугольник" "String" |
| добрый | Указывает тип индекса. | Хэш "Диапазон" "Пространственный" |
| точность | Точность индекса. -1 — максимальная точность. | инт |
Политика Индексации
| Имя | Описание | Ценность |
|---|---|---|
| Автоматически | Указывает, является ли политика индексирования автоматической | булевая переменная (bool) |
| составныеIndexes | Список составных путей | Композитный путь[][] |
| исключенныеПути | Список путей для исключения из индексирования | ИсключенныйPath[] |
| fullTextIndexes | Список путей для включения в полнотекстовую индексацию | FullTextIndexPath[] |
| включенныеPaths | Список путей для включения в индексирование | ВключенныйPath[] |
| Режим индексирования | Указывает режим индексирования. | "согласованный" "ленивый" "нет" |
| spatialIndexes | Список пространственных особенностей | Пространственная специализация[] |
| vectorIndexes | Список путей для включения в векторного индексирования | Векторный индекс[] |
Управляемая служебная идентичность
| Имя | Описание | Ценность |
|---|---|---|
| тип | Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы. | "Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned |
| ИдентичностиНазначенныеПользователем | Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Имя | Описание | Ценность |
|---|
ManagedServiceIdentityUserAssignedIdentities
| Имя | Описание | Ценность |
|---|
MaterializedViewDefinition (МатериализованноеViewDefinition)
| Имя | Описание | Ценность |
|---|---|---|
| определение | Определение должно быть SQL-запросом, который будет использоваться для получения данных из исходного контейнера для заполнения в контейнер материализованного представления. | строка (обязательно) |
| sourceCollectionId | Имя исходного контейнера, на котором будет создано материализованное представление. | строка (обязательно) |
| throughputBucketForBuild | Контейнер пропускной способности, назначенный для операций материализованного представления в целевом контейнере. | инт |
МатериализованныйВидДетали
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Поле идентификатора контейнера Materialized. | струна |
| _удалить | _rid поле материализованного контейнера. | струна |
MaterializedViewsProperties (МатериализованныеViewsProperties)
| Имя | Описание | Ценность |
|---|---|---|
| throughputBucketForBuild | Контейнер пропускной способности, назначенный для операций материализованного представления в исходном контейнере. | инт |
ResourceRestoreParameters (Параметры восстановления)
| Имя | Описание | Ценность |
|---|---|---|
| restoreSource | Идентификатор учетной записи базы данных, из которой необходимо инициировать восстановление. Например: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/location/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} | струна |
| restoreTimestampInUtc | Время восстановления учетной записи (формат ISO-8601). | струна |
| restoreWithTtlDisabled | Указывает, будет ли восстановленная учетная запись иметь время-To-Live отключена при успешном восстановлении. | булевая переменная (bool) |
ПространственнаяСпецификация
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
| Типы | Список пространственного типа пути | Массив строк, содержащий любой из: LineString «Мультиполигон» "Точка" "Многоугольник" |
SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties
| Имя | Описание | Ценность |
|---|---|---|
| Параметры | Пара параметров с ключом-значением, применяемая для запроса. Это соответствует заголовкам, отправленным запросом. | CreateUpdateOptionsOrSqlContainerGetPropertiesOptions |
| ресурс | Стандартный формат JSON контейнера | SqlContainerResourceOrSqlContainerGetPropertiesResource (обязательно) |
SqlContainerResourceOrSqlContainerGetPropertiesResource
| Имя | Описание | Ценность |
|---|---|---|
| analyticStorageTtl | Аналитический TTL. | инт |
| clientEncryptionPolicy | Политика шифрования клиента для контейнера. | ClientEncryptionPolicy |
| computedProperties | Список вычисляемых свойств | ComputedProperty[] |
| Политика разрешения конфликтов | Политика разрешения конфликтов для контейнера. | Политика разрешения конфликтов |
| createMode | Перечисление, указывающее режим создания учетной записи. | По умолчанию "Восстановить" |
| dataMaskingPolicy | Политика маскирования данных для контейнера. | Политика маскировки данных |
| defaultTtl | Время жизни по умолчанию | инт |
| fullTextPolicy | Политика FullText для контейнера. | FullTextPolicy |
| идентификатор | Имя контейнера SQL Cosmos DB | строка (обязательно) |
| Политика индексации | Конфигурация политики индексирования. По умолчанию индексирование выполняется автоматически для всех путей к документам в контейнере. | Политика индексации |
| materializedViewDefinition | Конфигурация определения материализованных представлений. Это необходимо указать только для создания контейнера "Материализованное представление". | MaterializedViewDefinition (МатериализованноеViewDefinition) |
| materializedViews | Материализованные представления, определенные в контейнере. | МатериализованныйВидПодробности[] |
| materializedViewsProperties | Свойства материализованных представлений, определенные для исходного контейнера. | MaterializedViewsProperties (МатериализованныеViewsProperties) |
| partitionKey | Конфигурация ключа секции, используемого для секционирования данных на несколько секций | ContainerPartitionKey (Ключ контейнераPartition) |
| restoreParameters | Параметры для указания сведений о восстановлении | ResourceRestoreParameters (Параметры восстановления) |
| uniqueKeyPolicy | Конфигурация уникальной политики ключей для указания ограничений уникальности для документов в коллекции в службе Azure Cosmos DB. | Политика UniqueKeyPolicy |
| vectorEmbeddingPolicy | Политика внедрения вектора для контейнера. | Политика VectorEmbeddingPolicy |
Уникальный ключ
| Имя | Описание | Ценность |
|---|---|---|
| Пути | Список путей должен быть уникальным для каждого документа в службе Azure Cosmos DB. | строка[] |
Политика UniqueKeyPolicy
| Имя | Описание | Ценность |
|---|---|---|
| uniqueKeys | Список уникальных ключей, которые применяют ограничение уникальности для документов в коллекции в службе Azure Cosmos DB. | УникальныйКлюч[] |
ВекторВстраивание
| Имя | Описание | Ценность |
|---|---|---|
| тип данных | Указывает тип данных вектора. | Float16 «Поплавок32» 'int8' Uint8 (обязательный) |
| Размеры | Количество измерений в векторе. | int (обязательно) |
| distanceФункция | Функция расстояния, используемая для вычисления расстояния между векторами. | "косинус" "dotproduct" 'euclidean' (обязательный) |
| путь | Путь к полю вектора в документе. | строка (обязательно) |
Политика VectorEmbeddingPolicy
| Имя | Описание | Ценность |
|---|---|---|
| vectorEmbeddings | Список внедрения векторов | VectorEmbedding[] |
Векторный индекс
| Имя | Описание | Ценность |
|---|---|---|
| indexingSearchListSize | Это размер списка потенциальных соседей, хранящегося при построении индекса DiskANN в рамках процессов оптимизации. Большие значения могут улучшить запоминание за счет задержки. Это применимо только для векторного индекса типа diskANN. | int Ограничения целостности: Минимальное значение = 25 Максимальное значение = 500 |
| путь | Путь к полю вектора в документе. | строка (обязательно) |
| quantizationByteSize | Количество байтов, используемых при квантовании векторов по произведению. Большее значение может привести к лучшей запоминаемости для векторного поиска за счет задержки. Это применимо только для векторных индексов типа quantizedFlat и diskANN. | int Ограничения целостности: Минимальное значение = 4 |
| тип | Тип индекса вектора. В настоящее время поддерживаются плоская, дисковая, дисковая и квантизованнаяFlat. | DiskANN "плоская" "quantizedFlat" (обязательный) |
| vectorIndexShardKey | Массив ключей шардов для векторного индекса. Это применимо только для векторных индексов типа quantizedFlat и diskANN. | строка[] |
Примеры использования
Шаблоны быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.
| Шаблон | Описание |
|---|---|
|
API SQL учетной записи Azure Cosmos DB с аналитическим хранилищем развертывание |
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером, настроенным с помощью аналитического хранилища. |
|
Создание учетной записи Azure Cosmos DB уровня "Бесплатный" развертывание |
Этот шаблон создает бесплатную учетную запись Azure Cosmos DB для API SQL с базой данных с общей пропускной способностью и контейнером. |
|
создание учетной записи Azure Cosmos DB для API Core (SQL) развертывание |
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с пропускной способностью с несколькими другими параметрами. |
|
создание API SQL учетной записи Azure Cosmos DB с автомасштабированием развертывание |
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с пропускной способностью автомасштабирования с несколькими другими параметрами. |
|
Создание хранимых процедур API Azure Cosmos DB Core (SQL) развертывание |
Этот шаблон создает учетную запись Azure Cosmos DB для API Core (SQL) и контейнер с хранимой процедурой, триггером и определяемой пользователем функцией. |
|
создает приложение микрослужб Dapr с помощью приложений контейнеров развертывание |
Создайте приложение микрослужб Dapr с помощью контейнерных приложений. |
|
Создает приложение dapr pub-sub servicebus с помощью приложений контейнеров развертывание |
Создайте приложение dapr pub-sub servicebus с помощью контейнерных приложений. |
|
Развертывание базы данных Azure Data Explorer с помощью подключения Cosmos DB развертывание |
Разверните базу данных Azure Data Explorer с подключением Cosmos DB. |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса databaseAccounts/sqlDatabases/container можно развернуть с помощью операций, предназначенных для следующих операций:
- Группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.DocumentDB/databaseAccounts/sqlDatabases/container, добавьте следующий объект Terraform в шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2026-04-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/container
| Имя | Описание | Ценность |
|---|---|---|
| тождество | Удостоверение ресурса. | ManagedServiceIdentity (Управляемый сервисИдентификация) |
| местоположение | Расположение группы ресурсов, к которой принадлежит ресурс. | струна |
| имя | Имя ресурса | строка (обязательно) |
| идентификатор_родителя | Идентификатор ресурса, который является родительским для этого ресурса. | Идентификатор ресурса типа: databaseAccounts/sqlDatabases |
| свойства | Свойства для создания и обновления контейнера Azure Cosmos DB. | SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. |
| тип | Тип ресурса | «Microsoft. DocumentDB/databaseAccounts/sqlDatabases/containers@2026-04-01-preview" |
ARMResourcePropertiesTags
| Имя | Описание | Ценность |
|---|
АвтомасштабированиеSettings
| Имя | Описание | Ценность |
|---|---|---|
| maxПропускная способность | Представляет максимальную пропускную способность, ресурс может масштабироваться до. | инт |
ClientEncryptionIncludedPath
| Имя | Описание | Ценность |
|---|---|---|
| clientEncryptionKeyId | Идентификатор ключа шифрования клиента, который будет использоваться для шифрования пути. | строка (обязательно) |
| шифрованиеАлгоритм | Алгоритм шифрования, который будет использоваться. Например - AEAD_AES_256_CBC_HMAC_SHA256. | строка (обязательно) |
| encryptionType | Тип выполняемого шифрования. Например, детерминированное, случайное. | строка (обязательно) |
| путь | Путь, который необходимо зашифровать. | строка (обязательно) |
ClientEncryptionPolicy
| Имя | Описание | Ценность |
|---|---|---|
| включенныеPaths | Пути элемента, нуждающегося в шифровании, вместе с параметрами конкретного пути. | ClientEncryptionIncludedPath[] (обязательно) |
| policyFormatVersion | Версия определения политики шифрования клиента. Поддерживаемые версии: 1 и 2. Версия 2 поддерживает шифрование пути идентификатора и ключа секции. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 2 (обязательно) |
Составной Путь
| Имя | Описание | Ценность |
|---|---|---|
| порядок | Порядок сортировки составных путей. | "возрастание" "убывание" |
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
ComputedProperty (ВычислительноеСвойство)
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя вычисляемого свойства, например "cp_lowerName" | струна |
| запрос | Запрос, вычисляющий значение вычисляемого свойства, например "SELECT VALUE LOWER(c.name) FROM c" | струна |
Политика разрешения конфликтов
| Имя | Описание | Ценность |
|---|---|---|
| conflictResolutionPath | Путь разрешения конфликтов в режиме LastWriterWins. | струна |
| Процедура разрешения конфликта | Процедура разрешения конфликтов в случае пользовательского режима. | струна |
| режим | Указывает режим разрешения конфликтов. | "Custom" "LastWriterWins" |
ContainerPartitionKey (Ключ контейнераPartition)
| Имя | Описание | Ценность |
|---|---|---|
| добрый | Указывает тип алгоритма, используемого для секционирования. Для MultiHash для создания контейнера поддерживаются несколько ключей секций (не более трех). | Хэш MultiHash "Диапазон" |
| Пути | Список путей, с помощью которых можно секционировать данные в контейнере | строка[] |
| Версия | Указывает версию определения ключа секции | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 2 |
CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
| Имя | Описание | Ценность |
|---|---|---|
| autoscaleSettings | Задает параметры автомасштабирования. Примечание. Требуется либо пропускная способность, либо автомасштабированиеSettings, но не оба. | АвтомасштабированиеSettings |
| производительность | Единицы запроса в секунду. Например, "пропускная способность": 10000. | инт |
Политика маскировки данных
| Имя | Описание | Ценность |
|---|---|---|
| исключенныеПути | Список путей JSON для исключения из маскировки. | DataMaskingPolicyExcludedPathsItem[] |
| включенныеPaths | Список путей JSON, которые должны быть включены в политику маскирования. | DataMaskingPolicyIncludedPathsItem[] |
| isPolicyEnabled | Флаг, указывающий, включена ли политика маскировки данных. | булевая переменная (bool) |
DataMaskingPolicyExcludedPathsItem
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь JSON для исключения из маскировки (например, "/id"). | строка (обязательно) |
DataMaskingPolicyIncludedPathsItem
| Имя | Описание | Ценность |
|---|---|---|
| length | Длина подстроки для маски (если применимо). | инт |
| путь | Путь JSON для применения маскировки (например, "/contact/phones"). | строка (обязательно) |
| startPosition | Начальная позиция для маскировки подстроки (если применимо). | инт |
| strategy | Применить стратегию маскировки (например, "MaskSubstring"). | струна |
ИсключенныйPath
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
FullTextIndexPath (Полный текстИндексPath)
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь к полю полнотекстового текста в документе. | строка (обязательно) |
FullTextPath (Полный текстPath)
| Имя | Описание | Ценность |
|---|---|---|
| язык | Язык полнотекстового поля в документе. | струна |
| путь | Путь к полю полнотекстового текста в документе. | строка (обязательно) |
FullTextPolicy
| Имя | Описание | Ценность |
|---|---|---|
| Язык defaultLanguage | Язык по умолчанию для полнотекстовых путей. | струна |
| fullTextPaths | Список путей FullText | FullTextPath[] |
Включенныйpath
Индексы
| Имя | Описание | Ценность |
|---|---|---|
| тип данных | Тип данных, к которому применяется индексирование. | LineString «Мультиполигон» "Число" "Точка" "Многоугольник" "String" |
| добрый | Указывает тип индекса. | Хэш "Диапазон" "Пространственный" |
| точность | Точность индекса. -1 — максимальная точность. | инт |
Политика Индексации
| Имя | Описание | Ценность |
|---|---|---|
| Автоматически | Указывает, является ли политика индексирования автоматической | булевая переменная (bool) |
| составныеIndexes | Список составных путей | Композитный путь[][] |
| исключенныеПути | Список путей для исключения из индексирования | ИсключенныйPath[] |
| fullTextIndexes | Список путей для включения в полнотекстовую индексацию | FullTextIndexPath[] |
| включенныеPaths | Список путей для включения в индексирование | ВключенныйPath[] |
| Режим индексирования | Указывает режим индексирования. | "согласованный" "ленивый" "нет" |
| spatialIndexes | Список пространственных особенностей | Пространственная специализация[] |
| vectorIndexes | Список путей для включения в векторного индексирования | Векторный индекс[] |
Управляемая служебная идентичность
| Имя | Описание | Ценность |
|---|---|---|
| тип | Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы. | "Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned |
| ИдентичностиНазначенныеПользователем | Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Имя | Описание | Ценность |
|---|
ManagedServiceIdentityUserAssignedIdentities
| Имя | Описание | Ценность |
|---|
MaterializedViewDefinition (МатериализованноеViewDefinition)
| Имя | Описание | Ценность |
|---|---|---|
| определение | Определение должно быть SQL-запросом, который будет использоваться для получения данных из исходного контейнера для заполнения в контейнер материализованного представления. | строка (обязательно) |
| sourceCollectionId | Имя исходного контейнера, на котором будет создано материализованное представление. | строка (обязательно) |
| throughputBucketForBuild | Контейнер пропускной способности, назначенный для операций материализованного представления в целевом контейнере. | инт |
МатериализованныйВидДетали
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Поле идентификатора контейнера Materialized. | струна |
| _удалить | _rid поле материализованного контейнера. | струна |
MaterializedViewsProperties (МатериализованныеViewsProperties)
| Имя | Описание | Ценность |
|---|---|---|
| throughputBucketForBuild | Контейнер пропускной способности, назначенный для операций материализованного представления в исходном контейнере. | инт |
ResourceRestoreParameters (Параметры восстановления)
| Имя | Описание | Ценность |
|---|---|---|
| restoreSource | Идентификатор учетной записи базы данных, из которой необходимо инициировать восстановление. Например: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/location/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} | струна |
| restoreTimestampInUtc | Время восстановления учетной записи (формат ISO-8601). | струна |
| restoreWithTtlDisabled | Указывает, будет ли восстановленная учетная запись иметь время-To-Live отключена при успешном восстановлении. | булевая переменная (bool) |
ПространственнаяСпецификация
| Имя | Описание | Ценность |
|---|---|---|
| путь | Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/path/*) | струна |
| Типы | Список пространственного типа пути | Массив строк, содержащий любой из: LineString «Мультиполигон» "Точка" "Многоугольник" |
SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties
| Имя | Описание | Ценность |
|---|---|---|
| Параметры | Пара параметров с ключом-значением, применяемая для запроса. Это соответствует заголовкам, отправленным запросом. | CreateUpdateOptionsOrSqlContainerGetPropertiesOptions |
| ресурс | Стандартный формат JSON контейнера | SqlContainerResourceOrSqlContainerGetPropertiesResource (обязательно) |
SqlContainerResourceOrSqlContainerGetPropertiesResource
| Имя | Описание | Ценность |
|---|---|---|
| analyticStorageTtl | Аналитический TTL. | инт |
| clientEncryptionPolicy | Политика шифрования клиента для контейнера. | ClientEncryptionPolicy |
| computedProperties | Список вычисляемых свойств | ComputedProperty[] |
| Политика разрешения конфликтов | Политика разрешения конфликтов для контейнера. | Политика разрешения конфликтов |
| createMode | Перечисление, указывающее режим создания учетной записи. | По умолчанию "Восстановить" |
| dataMaskingPolicy | Политика маскирования данных для контейнера. | Политика маскировки данных |
| defaultTtl | Время жизни по умолчанию | инт |
| fullTextPolicy | Политика FullText для контейнера. | FullTextPolicy |
| идентификатор | Имя контейнера SQL Cosmos DB | строка (обязательно) |
| Политика индексации | Конфигурация политики индексирования. По умолчанию индексирование выполняется автоматически для всех путей к документам в контейнере. | Политика индексации |
| materializedViewDefinition | Конфигурация определения материализованных представлений. Это необходимо указать только для создания контейнера "Материализованное представление". | MaterializedViewDefinition (МатериализованноеViewDefinition) |
| materializedViews | Материализованные представления, определенные в контейнере. | МатериализованныйВидПодробности[] |
| materializedViewsProperties | Свойства материализованных представлений, определенные для исходного контейнера. | MaterializedViewsProperties (МатериализованныеViewsProperties) |
| partitionKey | Конфигурация ключа секции, используемого для секционирования данных на несколько секций | ContainerPartitionKey (Ключ контейнераPartition) |
| restoreParameters | Параметры для указания сведений о восстановлении | ResourceRestoreParameters (Параметры восстановления) |
| uniqueKeyPolicy | Конфигурация уникальной политики ключей для указания ограничений уникальности для документов в коллекции в службе Azure Cosmos DB. | Политика UniqueKeyPolicy |
| vectorEmbeddingPolicy | Политика внедрения вектора для контейнера. | Политика VectorEmbeddingPolicy |
Уникальный ключ
| Имя | Описание | Ценность |
|---|---|---|
| Пути | Список путей должен быть уникальным для каждого документа в службе Azure Cosmos DB. | строка[] |
Политика UniqueKeyPolicy
| Имя | Описание | Ценность |
|---|---|---|
| uniqueKeys | Список уникальных ключей, которые применяют ограничение уникальности для документов в коллекции в службе Azure Cosmos DB. | УникальныйКлюч[] |
ВекторВстраивание
| Имя | Описание | Ценность |
|---|---|---|
| тип данных | Указывает тип данных вектора. | Float16 «Поплавок32» 'int8' Uint8 (обязательный) |
| Размеры | Количество измерений в векторе. | int (обязательно) |
| distanceФункция | Функция расстояния, используемая для вычисления расстояния между векторами. | "косинус" "dotproduct" 'euclidean' (обязательный) |
| путь | Путь к полю вектора в документе. | строка (обязательно) |
Политика VectorEmbeddingPolicy
| Имя | Описание | Ценность |
|---|---|---|
| vectorEmbeddings | Список внедрения векторов | VectorEmbedding[] |
Векторный индекс
| Имя | Описание | Ценность |
|---|---|---|
| indexingSearchListSize | Это размер списка потенциальных соседей, хранящегося при построении индекса DiskANN в рамках процессов оптимизации. Большие значения могут улучшить запоминание за счет задержки. Это применимо только для векторного индекса типа diskANN. | int Ограничения целостности: Минимальное значение = 25 Максимальное значение = 500 |
| путь | Путь к полю вектора в документе. | строка (обязательно) |
| quantizationByteSize | Количество байтов, используемых при квантовании векторов по произведению. Большее значение может привести к лучшей запоминаемости для векторного поиска за счет задержки. Это применимо только для векторных индексов типа quantizedFlat и diskANN. | int Ограничения целостности: Минимальное значение = 4 |
| тип | Тип индекса вектора. В настоящее время поддерживаются плоская, дисковая, дисковая и квантизованнаяFlat. | DiskANN "плоская" "quantizedFlat" (обязательный) |
| vectorIndexShardKey | Массив ключей шардов для векторного индекса. Это применимо только для векторных индексов типа quantizedFlat и diskANN. | строка[] |
Примеры использования
Примеры Terraform
Простой пример развертывания контейнера SQL в учетной записи Cosmos DB.
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 = ["*"]
}