az cosmosdb sql database

參考

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。安裝每個擴充功能以受益於其擴充功能。深入了解擴充功能。

管理 Azure Cosmos DB SQL 資料庫。

命令

名稱	Description	類型	狀態
az cosmosdb sql database create	在 Azure Cosmos DB 帳戶下建立 SQL 資料庫。	核心	GA
az cosmosdb sql database delete	刪除 Azure Cosmos DB 帳戶下的 SQL 資料庫。	核心	GA
az cosmosdb sql database exists	檢查 Azure Cosmos DB SQL 資料庫是否存在。	核心	GA
az cosmosdb sql database list	列出 Azure Cosmos DB 帳戶下的 SQL 資料庫。	核心	GA
az cosmosdb sql database merge	合併 sql Database 的數據分割。	副檔名	預覽
az cosmosdb sql database restore	還原相同帳戶內已刪除的 SQL 資料庫。	核心	GA
az cosmosdb sql database restore (cosmosdb-preview 擴充功能)	還原相同帳戶內已刪除的 SQL 資料庫。	副檔名	預覽
az cosmosdb sql database show	在 Azure Cosmos DB 帳戶下顯示 SQL 資料庫的詳細數據。	核心	GA
az cosmosdb sql database throughput	在 Azure Cosmos DB 帳戶下管理 SQL 資料庫的輸送量。	核心	GA
az cosmosdb sql database throughput migrate	在自動調整和手動布建之間移轉 SQL 資料庫的輸送量。	核心	GA
az cosmosdb sql database throughput show	取得 Azure Cosmos DB 帳戶下 SQL 資料庫的輸送量。	核心	GA
az cosmosdb sql database throughput update	更新 Azure Cosmos DB 帳戶下 SQL 資料庫的輸送量。	核心	GA

az cosmosdb sql database create

編輯

在 Azure Cosmos DB 帳戶下建立 SQL 資料庫。

az cosmosdb sql database create --account-name
                                --name
                                --resource-group
                                [--max-throughput]
                                [--throughput]

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--name -n

資料庫名稱。

--resource-group -g

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

選擇性參數

--max-throughput

輸送量資源上限可以調整為（RU/秒）。提供資源啟用自動調整時。最小值可以是 4000 （RU/秒）。

--throughput

SQL 資料庫的輸送量（RU/秒）。預設值為 400。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az cosmosdb sql database delete

編輯

刪除 Azure Cosmos DB 帳戶下的 SQL 資料庫。

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

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--name -n

資料庫名稱。

--resource-group -g

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

選擇性參數

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az cosmosdb sql database exists

編輯

檢查 Azure Cosmos DB SQL 資料庫是否存在。

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

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--name -n

資料庫名稱。

--resource-group -g

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

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az cosmosdb sql database list

編輯

列出 Azure Cosmos DB 帳戶下的 SQL 資料庫。

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

範例

列出 Azure Cosmos DB 帳戶下的 SQL 資料庫（自動產生）

az cosmosdb sql database list --account-name MyAccount --resource-group MyResourceGroup

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--resource-group -g

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

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az cosmosdb sql database merge

預覽

此命令處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

合併 sql Database 的數據分割。

az cosmosdb sql database merge --account-name
                               --name
                               --resource-group

範例

合併資料庫 my-database 的數據分割

az cosmosdb sql database merge -g my-resource-group -a my-account --name my-database

必要參數

--account-name -a

CosmosDB 資料庫帳戶的名稱。

--name -n

CosmosDB 資料庫名稱的名稱。

--resource-group -g

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

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az cosmosdb sql database restore

編輯

還原相同帳戶內已刪除的 SQL 資料庫。

az cosmosdb sql database restore --account-name
                                 --name
                                 --resource-group
                                 [--restore-timestamp]

範例

還原相同帳戶內已刪除的 SQL 資料庫。

az cosmosdb sql database restore --resource-group resource_group --account-name database_account_name --name name_of_database_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--name -n

資料庫名稱。

--resource-group -g

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

選擇性參數

--restore-timestamp -t

資料庫必須還原至的時間戳。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az cosmosdb sql database restore (cosmosdb-preview 擴充功能)

預覽

此命令處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

還原相同帳戶內已刪除的 SQL 資料庫。

az cosmosdb sql database restore --account-name
                                 --name
                                 --resource-group
                                 [--disable-ttl {false, true}]
                                 [--restore-timestamp]

範例

還原相同帳戶內已刪除的 SQL 資料庫。

az cosmosdb sql database restore --resource-group resource_group --account-name database_account_name --name name_of_database_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--name -n

資料庫名稱。

--resource-group -g

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

選擇性參數

--disable-ttl

預覽

啟用或停用已停用ttl還原。

接受的值: false, true

--restore-timestamp -t

資料庫必須還原至的時間戳。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az cosmosdb sql database show

編輯

在 Azure Cosmos DB 帳戶下顯示 SQL 資料庫的詳細數據。

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

必要參數

--account-name -a

Cosmosdb 帳戶名稱。

--name -n

資料庫名稱。

--resource-group -g

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

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az cosmosdb sql database

命令

az cosmosdb sql database create

必要參數

選擇性參數

az cosmosdb sql database delete

必要參數

選擇性參數

az cosmosdb sql database exists

必要參數

az cosmosdb sql database list

範例

必要參數

az cosmosdb sql database merge

範例

必要參數

az cosmosdb sql database restore

範例

必要參數

選擇性參數

az cosmosdb sql database restore (cosmosdb-preview 擴充功能)

範例

必要參數

選擇性參數

az cosmosdb sql database show

必要參數

其他資源