База данных Microsoft.DocumentDBAccounts/sqlDatabases/container

Определение ресурсов 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

Имя Описание Ценность
Индексы Список индексов для этого пути индексы []
путь Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/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

Имя Описание Ценность
Индексы Список индексов для этого пути индексы []
путь Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/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
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером, настроенным с помощью аналитического хранилища.
Создание учетной записи Azure Cosmos DB уровня "Бесплатный"

развертывание в Azure
Этот шаблон создает бесплатную учетную запись Azure Cosmos DB для API SQL с базой данных с общей пропускной способностью и контейнером.
создание учетной записи Azure Cosmos DB для API Core (SQL)

развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с пропускной способностью с несколькими другими параметрами.
создание API SQL учетной записи Azure Cosmos DB с автомасштабированием

развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с пропускной способностью автомасштабирования с несколькими другими параметрами.
Создание хранимых процедур API Azure Cosmos DB Core (SQL)

развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Core (SQL) и контейнер с хранимой процедурой, триггером и определяемой пользователем функцией.
создает приложение микрослужб Dapr с помощью приложений контейнеров

развертывание в Azure
Создайте приложение микрослужб Dapr с помощью контейнерных приложений.
Создает приложение dapr pub-sub servicebus с помощью приложений контейнеров

развертывание в Azure
Создайте приложение dapr pub-sub servicebus с помощью контейнерных приложений.
Развертывание базы данных Azure Data Explorer с помощью подключения Cosmos DB

развертывание в Azure
Разверните базу данных 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

Имя Описание Ценность
Индексы Список индексов для этого пути индексы []
путь Путь, к которому применяется индексирование. Пути индекса обычно начинаются с корневого и заканчиваются подстановочным знаком (/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    = ["*"]
}