az cosmosdb sql container

管理 Azure Cosmos DB SQL 容器。

命令

az cosmosdb sql container create

在 Azure Cosmos DB SQL 資料庫下建立 SQL 容器。

az cosmosdb sql container delete

刪除 Azure Cosmos DB SQL 資料庫下的 SQL 容器。

az cosmosdb sql container exists

檢查 Azure Cosmos DB SQL 容器是否存在。

az cosmosdb sql container list

列出 Azure Cosmos DB SQL 資料庫下的 SQL 容器。

az cosmosdb sql container merge

合併 sql 容器的資料分割。

az cosmosdb sql container redistribute-partition-throughput

轉散發 sql 容器的分割區輸送量。

az cosmosdb sql container restore

還原相同帳戶內已刪除的 SQL 容器。

az cosmosdb sql container retrieve-partition-throughput

擷取 sql 容器的資料分割輸送量。

az cosmosdb sql container show

在 Azure Cosmos DB SQL 資料庫下顯示 SQL 容器的詳細資料。

az cosmosdb sql container throughput

在 Azure Cosmos DB 帳戶下管理 SQL 容器的輸送量。

az cosmosdb sql container throughput migrate

在自動調整和手動布建之間移轉 SQL 容器的輸送量。

az cosmosdb sql container throughput show

取得 Azure Cosmos DB SQL 資料庫下 SQL 容器的輸送量。

az cosmosdb sql container throughput update

更新 Azure Cosmos DB SQL 資料庫下 SQL 容器的輸送量。

az cosmosdb sql container update

更新 Azure Cosmos DB SQL 資料庫下的 SQL 容器。

az cosmosdb sql container create

在 Azure Cosmos DB SQL 資料庫下建立 SQL 容器。

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]

範例

建立 Azure Cosmos DB SQL 容器。

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"

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--database-name -d

資料庫名稱。

--name -n

容器名稱。

--partition-key-path -p

分割區索引鍵路徑,例如 '/address/zipcode'。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--analytical-storage-ttl -t

啟用分析儲存體時的分析 TTL。

--cep

用戶端加密原則,您可以將它輸入為字串或檔案,例如 --cep 或 --cep @policy-file.json 「{」includedPaths「: [{」path「: 」/path1「,」clientEncryptionKeyId「: 」key1「,」encryptionAlgorithm「: 」AEAD_AES_256_CBC_HMAC_SHA256「,」encryptionType「: 」Deterministic「}],」policyFormatVersion「: 2}」。

--conflict-resolution-policy -c

衝突解決原則,您可以將它輸入為字串或檔案,例如 --conflict-resolution-policy @policy-file.json 或 --conflict-resolution-policy 「{」mode「: 」lastWriterWins「, 」conflictResolutionPath「: 」/path「}」。

--idx

編制索引原則、 您可以將它輸入為字串或檔案,例如 --idx 或 --idx @policy-file.json 「{」indexingMode「: 」consistent「, 」automatic「: true, 」includedPaths「: [{」path「: 」/*「}], 」excludedPaths「: [{ 」path「: 」/headquarters/employees/?「}, { 」path「: 」/「_etag」/?「}]}」。

預設值: { "indexingMode": "consistent", "automatic": true, "includedPaths": [ { "path": "/*" } ], "excludedPaths": [ { "path": "/\"_etag\"/?" } ] }
--max-throughput

最大輸送量資源可以調整為 (RU/秒) 。 提供資源啟用自動調整時。 最小值可以是 4000 (RU/秒) 。

--partition-key-version

分割區索引鍵的版本。

--throughput

SQL 容器的輸送量 (RU/秒) 。 預設值為 400。 如果資料庫具有共用輸送量,除非容器應該具有專用輸送量,否則請省略此參數。

--ttl

預設 TTL。 如果遺漏值或設定為 「-1」,則專案不會過期。 如果此值設定為 「n」,則專案會在上次修改時間之後的 「n」 秒到期。

--unique-key-policy -u

唯一金鑰原則,您可以將它輸入為字串或檔案,例如 --unique-key-policy 或 --unique-key-policy @policy-file.json 「{」uniqueKeys「: [{」path「: [」/path/to/key1「]}, {」path「: [」/path/to/key2「]}]}」。

az cosmosdb sql container delete

刪除 Azure Cosmos DB SQL 資料庫下的 SQL 容器。

az cosmosdb sql container delete --account-name
                                 --database-name
                                 --name
                                 --resource-group
                                 [--yes]

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--database-name -d

資料庫名稱。

--name -n

容器名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--yes -y

不提示確認。

az cosmosdb sql container exists

檢查 Azure Cosmos DB SQL 容器是否存在。

az cosmosdb sql container exists --account-name
                                 --database-name
                                 --name
                                 --resource-group

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--database-name -d

資料庫名稱。

--name -n

容器名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

az cosmosdb sql container list

列出 Azure Cosmos DB SQL 資料庫下的 SQL 容器。

az cosmosdb sql container list --account-name
                               --database-name
                               --resource-group

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--database-name -d

資料庫名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

az cosmosdb sql container merge

合併 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

必要參數

--account-name -a

CosmosDB 資料庫帳戶的名稱。

--database-name -d

CosmosDB 資料庫名稱的名稱。

--name -n

CosmosDB 集合的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

az cosmosdb sql container redistribute-partition-throughput

轉散發 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]'

必要參數

--account-name -a

CosmosDB 資料庫帳戶的名稱。

--database-name -d

CosmosDB 資料庫名稱的名稱。

--name -n

CosmosDB 集合的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--evenly-distribute

切換以將輸送量平均分散到所有實體分割區。

接受的值: false, true
--source-partition-info

空格分隔的來源實體分割區識別碼,例如:1 2。

--target-partition-info

所需目標實體分割區輸送量的相關資訊,例如:0=1200 1=1200。

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

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--database-name -d

資料庫名稱。

--name -n

容器名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--restore-timestamp -t

容器必須還原至的時間戳記。

az cosmosdb sql container retrieve-partition-throughput

擷取 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

必要參數

--account-name -a

CosmosDB 資料庫帳戶的名稱。

--database-name -d

CosmosDB 資料庫名稱的名稱。

--name -n

CosmosDB 容器的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--all-partitions

切換以擷取所有實體分割區的輸送量。

接受的值: false, true
--physical-partition-ids -p

實體分割區識別碼的空間分隔清單。

az cosmosdb sql container show

在 Azure Cosmos DB SQL 資料庫下顯示 SQL 容器的詳細資料。

az cosmosdb sql container show --account-name
                               --database-name
                               --name
                               --resource-group

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--database-name -d

資料庫名稱。

--name -n

容器名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

az cosmosdb sql container update

更新 Azure Cosmos DB SQL 資料庫下的 SQL 容器。

az cosmosdb sql container update --account-name
                                 --database-name
                                 --name
                                 --resource-group
                                 [--analytical-storage-ttl]
                                 [--idx]
                                 [--ttl]

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--database-name -d

資料庫名稱。

--name -n

容器名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--analytical-storage-ttl -t

啟用分析儲存體時的分析 TTL。

--idx

索引編制原則, 您可以將它輸入為字串或檔案,例如 --idx 或 --idx @policy-file.json 「{」indexingMode「: 」consistent「, 」automatic「: true, 」includedPaths「: [{」path「: 」/*「}], 」excludedPaths「: [{ 」path「: 」/headquarters/employees/?「}, { 」path「: 」/「_etag」/?「}}」。

--ttl

預設 TTL。 如果值遺失或設定為 「-1」,則專案不會過期。 如果此值設定為 「n」,則專案會在上次修改時間之後的 「n」 秒到期。