az cosmosdb sql container
Примечание.
Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Подробнее о расширениях.
Управление контейнерами SQL из Azure Cosmos DB.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az cosmosdb sql container create |
Создайте контейнер SQL в базе данных SQL Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container create (cosmosdb-preview Расширение) |
Создайте контейнер SQL в базе данных SQL Azure Cosmos DB. |
Расширение | Общедоступная версия |
az cosmosdb sql container delete |
Удалите контейнер SQL в базе данных SQL Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container exists |
Проверяет, существует ли контейнер SQL Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container list |
Вывод списка контейнеров SQL в базе данных SQL Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container merge |
Объединяет секции контейнера SQL. |
Расширение | Предварительный просмотр |
az cosmosdb sql container redistribute-partition-throughput |
Распространяет пропускную способность секции контейнера SQL. |
Расширение | Предварительный просмотр |
az cosmosdb sql container restore |
Восстановите удаленный контейнер SQL в той же учетной записи. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container restore (cosmosdb-preview Расширение) |
Восстановите удаленный контейнер SQL в той же учетной записи. |
Расширение | Предварительный просмотр |
az cosmosdb sql container retrieve-partition-throughput |
Получение пропускной способности секции контейнера SQL. |
Расширение | Предварительный просмотр |
az cosmosdb sql container show |
Отображение сведений о контейнере SQL в базе данных SQL Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container throughput |
Управление пропускной способностью контейнера SQL в учетной записи Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container throughput migrate |
Перенос пропускной способности контейнера SQL между автомасштабированием и подготовкой вручную. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container throughput show |
Получение пропускной способности контейнера SQL в базе данных SQL Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container throughput update |
Обновите пропускную способность контейнера SQL в базе данных SQL Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container update |
Обновите контейнер SQL в базе данных SQL Azure Cosmos DB. |
Основные сведения | Общедоступная версия |
az cosmosdb sql container update (cosmosdb-preview Расширение) |
Обновите контейнер SQL в базе данных SQL Azure Cosmos DB. |
Расширение | Общедоступная версия |
az cosmosdb sql container create
Создайте контейнер SQL в базе данных SQL Azure Cosmos DB.
az cosmosdb sql container create --account-name
--database-name
--name
--partition-key-path
--resource-group
[--analytical-storage-ttl]
[--cep]
[--conflict-resolution-policy]
[--idx]
[--max-throughput]
[--partition-key-version]
[--throughput]
[--ttl]
[--unique-key-policy]
Примеры
Создайте контейнер SQL Azure Cosmos DB.
az cosmosdb sql container create -g MyResourceGroup -a MyAccount -d MyDatabase -n MyContainer --partition-key-path "/my/path" --idx @policy-file.json --ttl 1000 --throughput "700"
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Путь ключа секции, например "/address/zipcode".
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Аналитическое TTL, если включено аналитическое хранилище.
Политика шифрования клиента можно ввести в виде строки или в виде файла, например --cep или --cep @policy-file.json "{"includedPaths": [{"path": "/path1","clientEncryptionKeyId": "key1","encryptionAlgorithm": "AEAD_AES_256_CBC_HMAC_SHA256","encryptionType": "Deterministic"},"policyFormatVersion": 2}".
Политику разрешения конфликтов можно ввести в виде строки или в виде файла, например --conflict-resolution-policy или --conflict-resolution-policy @policy-file.json "{"mode": "lastWriterWins", "conflictResolutionPath": "/path"}".
Политика индексирования можно ввести в виде строки или в виде файла. Например, --idx или --idx @policy-file.json "{"indexingMode": "согласованный", "automatic": true, "includePaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"}}".
Максимальный ресурс пропускной способности может масштабироваться до (ЕЗ/с). Предоставляется при включении автомасштабирования ресурса. Минимальное значение может быть равно 4000 (ЕЗ/с).
Версия ключа секции.
Пропускная способность контейнера SQL (ЕЗ/с). Значение по умолчанию — 400. Опустите этот параметр, если база данных имеет общую пропускную способность, если контейнер не должен иметь выделенную пропускную способность.
TTL по умолчанию. Если значение отсутствует или задано значение "-1", срок действия элементов не истекает. Если для значения задано значение "n", элементы истекают секунды "n" после последнего изменения.
Уникальная политика ключей позволяет ввести ее в виде строки или в виде файла, например --unique-key-policy или --unique-key-policy @policy-file.json "{"uniqueKeys": ["paths": ["path/to/key1"}, {"paths": ["path/to/key2"}}".
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container create (cosmosdb-preview Расширение)
Создайте контейнер SQL в базе данных SQL Azure Cosmos DB.
az cosmosdb sql container create --account-name
--database-name
--name
--partition-key-path
--resource-group
[--analytical-storage-ttl]
[--cep]
[--conflict-resolution-policy]
[--idx]
[--materialized-view-definition]
[--max-throughput]
[--partition-key-version]
[--throughput]
[--ttl]
[--unique-key-policy]
Примеры
Создайте контейнер SQL Azure Cosmos DB.
az cosmosdb sql container create -g MyResourceGroup -a MyAccount -d MyDatabase -n MyContainer --partition-key-path "/my/path" --idx @policy-file.json --ttl 1000 --throughput "700"
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Путь ключа секции, например "/address/zipcode".
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Аналитическое TTL, если включено аналитическое хранилище.
Политика шифрования клиента можно ввести в виде строки или в виде файла, например --cep или --cep @policy-file.json "{ "includedPaths": [{"path": "/path1","clientEncryptionKeyId": "key1","encryptionAlgorithm": "AEAD_AES_256_CBC_HMAC_SHA256","encryptionType": "Deterministic"}], "policyFormatVersion": 2}.
Политика разрешения конфликтов можно ввести в виде строки или в виде файла, например --conflict-resolution-policy или --conflict-resolution-policy @policy-file.json "{ "mode": "lastWriterWins", "conflictResolutionPath": "/path" }.
Политика индексирования можно ввести в виде строки или в виде файла. Например, --idx или --idx @policy-file.json "{ "indexingMode": "согласованный", "automatic": true, "includePaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"} }".
Определение материализованного представления можно ввести в виде строки или в виде файла, например --materialized-view-definition @materializedview-definition-file.json или --materialized-view-definition -m '{ "sourceCollectionId": "MySourceCollectionName", "definition": "SELECT * FROM root r"}".
Максимальный ресурс пропускной способности может масштабироваться до (ЕЗ/с). Предоставляется при включении автомасштабирования ресурса. Минимальное значение может быть равно 4000 (ЕЗ/с).
Версия ключа секции.
Пропускная способность контейнера SQL (ЕЗ/с). Значение по умолчанию — 400. Опустите этот параметр, если база данных имеет общую пропускную способность, если контейнер не должен иметь выделенную пропускную способность.
TTL по умолчанию. Если значение отсутствует или задано значение "-1", срок действия элементов не истекает. Если для значения задано значение "n", элементы истекают секунды "n" после последнего изменения.
Уникальная политика ключей позволяет ввести ее в виде строки или в виде файла, например --unique-key-policy или --unique-key-policy @policy-file.json "{ "uniqueKeys": ["пути": ["путь/путь/ключ1"]}, {"paths": ["path/to/key2"}} }".
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container delete
Удалите контейнер SQL в базе данных SQL Azure Cosmos DB.
az cosmosdb sql container delete --account-name
--database-name
--name
--resource-group
[--yes]
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Не запрашивать подтверждение.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container exists
Проверяет, существует ли контейнер SQL Azure Cosmos DB.
az cosmosdb sql container exists --account-name
--database-name
--name
--resource-group
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container list
Вывод списка контейнеров SQL в базе данных SQL Azure Cosmos DB.
az cosmosdb sql container list --account-name
--database-name
--resource-group
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container merge
Эта команда находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus
Объединяет секции контейнера SQL.
az cosmosdb sql container merge --account-name
--database-name
--name
--resource-group
Примеры
объединение секций контейнера my-container
az cosmosdb sql container merge -g my-resource-group -a my-account -d my-db --name my-container
Обязательные параметры
Имя учетной записи базы данных CosmosDB.
Имя имени базы данных CosmosDB.
Имя коллекции CosmosDB.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container redistribute-partition-throughput
Эта команда находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus
Распространяет пропускную способность секции контейнера SQL.
az cosmosdb sql container redistribute-partition-throughput --account-name
--database-name
--name
--resource-group
[--evenly-distribute {false, true}]
[--source-partition-info]
[--target-partition-info]
Примеры
Равномерно распределяет пропускную способность секции для контейнера SQL между всеми физическими секциями
az cosmosdb sql container redistribute-partition-throughput --account-name account_name --database-name db_name --name container_name --resource-group rg_name --evenly-distribute
Распространение пропускной способности секции для контейнера SQL из исходных секций в целевые секции
az cosmosdb sql container redistribute-partition-throughput --account-name account_name --database-name db_name --name container_name --resource-group rg_name --target-partition-info 8=1200 6=1200]' --source-partition-info 9]'
Обязательные параметры
Имя учетной записи базы данных CosmosDB.
Имя имени базы данных CosmosDB.
Имя коллекции CosmosDB.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Переключитесь на распределение пропускной способности одинаково между всеми физическими секциями.
Идентификаторы физической секции, разделенные пространством, например 1 2.
Сведения о требуемой пропускной способности физической секции: 0=1200 1=1200.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container restore
Восстановите удаленный контейнер SQL в той же учетной записи.
az cosmosdb sql container restore --account-name
--database-name
--name
--resource-group
[--restore-timestamp]
Примеры
Восстановите удаленный контейнер SQL в той же учетной записи.
az cosmosdb sql container restore --resource-group resource_group --account-name database_account_name --database-name parent_database_name --name name_of_container_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Метка времени, в которую необходимо восстановить контейнер.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container restore (cosmosdb-preview Расширение)
Эта команда находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus
Восстановите удаленный контейнер SQL в той же учетной записи.
az cosmosdb sql container restore --account-name
--database-name
--name
--resource-group
[--disable-ttl {false, true}]
[--restore-timestamp]
Примеры
Восстановите удаленный контейнер SQL в той же учетной записи.
az cosmosdb sql container restore --resource-group resource_group --account-name database_account_name --database-name parent_database_name --name name_of_container_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Включите или отключите восстановление с отключенным ttl.
Метка времени, в которую необходимо восстановить контейнер.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container retrieve-partition-throughput
Эта команда находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus
Получение пропускной способности секции контейнера SQL.
az cosmosdb sql container retrieve-partition-throughput --account-name
--database-name
--name
--resource-group
[--all-partitions {false, true}]
[--physical-partition-ids]
Примеры
Получение пропускной способности контейнера container_name для определенных физических секций
az cosmosdb sql container retrieve-partition-throughput --account-name account_name --database-name db_name --name container_name --resource-group rg_name --physical-partition-ids 8 9
Получение пропускной способности контейнера container_name для всех физических секций
az cosmosdb sql container retrieve-partition-throughput --account-name account_name --database-name db_name --name container_name --resource-group rg_name --all-partitions
Обязательные параметры
Имя учетной записи базы данных CosmosDB.
Имя имени базы данных CosmosDB.
Имя контейнера CosmosDB.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Переключитесь, чтобы получить пропускную способность для всех физических секций.
Разделенный пробелом список идентификаторов физических разделов.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container show
Отображение сведений о контейнере SQL в базе данных SQL Azure Cosmos DB.
az cosmosdb sql container show --account-name
--database-name
--name
--resource-group
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container update
Обновите контейнер SQL в базе данных SQL Azure Cosmos DB.
az cosmosdb sql container update --account-name
--database-name
--name
--resource-group
[--analytical-storage-ttl]
[--idx]
[--ttl]
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Аналитическое TTL, если включено аналитическое хранилище.
Политика индексирования можно ввести в виде строки или в виде файла. Например, --idx или --idx @policy-file.json "{"indexingMode": "согласованный", "automatic": true, "includePaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"}}".
TTL по умолчанию. Если значение отсутствует или задано значение "-1", срок действия элементов не истекает. Если для значения задано значение "n", элементы истекают секунды "n" после последнего изменения.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az cosmosdb sql container update (cosmosdb-preview Расширение)
Обновите контейнер SQL в базе данных SQL Azure Cosmos DB.
az cosmosdb sql container update --account-name
--database-name
--name
--resource-group
[--analytical-storage-ttl]
[--idx]
[--materialized-view-definition]
[--ttl]
Обязательные параметры
Имя учетной записи Cosmosdb.
имя базы данных.
Имя контейнера.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Аналитическое TTL, если включено аналитическое хранилище.
Политика индексирования можно ввести в виде строки или в виде файла. Например, --idx или --idx @policy-file.json "{ "indexingMode": "согласованный", "automatic": true, "includePaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"} }".
Определение материализованного представления можно ввести в виде строки или в виде файла, например --materialized-view-definition @materializedview-definition-file.json или --materialized-view-definition -m '{ "sourceCollectionId": "MySourceCollectionName", "definition": "SELECT * FROM root r"}".
TTL по умолчанию. Если значение отсутствует или задано значение "-1", срок действия элементов не истекает. Если для значения задано значение "n", элементы истекают секунды "n" после последнего изменения.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.