共用方式為


az sql db

管理資料庫。

命令

名稱 Description 類型 狀態
az sql db advanced-threat-protection-setting

管理資料庫的進階威脅防護設定。

核心 GA
az sql db advanced-threat-protection-setting show

取得進階威脅防護設定。

核心 GA
az sql db advanced-threat-protection-setting update

更新資料庫的進階威脅防護設定。

核心 GA
az sql db audit-policy

管理資料庫的稽核原則。

核心 GA
az sql db audit-policy show

顯示資料庫審核策略。

核心 GA
az sql db audit-policy update

更新資料庫的稽核原則。

核心 GA
az sql db audit-policy wait

將 CLI 置於等候狀態,直到符合資料庫的審核策略條件為止。

核心 GA
az sql db classification

管理敏感度分類。

核心 GA
az sql db classification delete

刪除指定數據行的敏感度分類。

核心 GA
az sql db classification list

取得指定資料庫的敏感度分類。

核心 GA
az sql db classification recommendation

管理敏感度分類建議。

核心 GA
az sql db classification recommendation disable

停用指定數據行的敏感度建議(預設會在所有數據行上啟用建議)。

核心 GA
az sql db classification recommendation enable

啟用指定數據行的敏感度建議(預設會在所有數據行上啟用建議)。

核心 GA
az sql db classification recommendation list

列出指定資料庫的建議敏感度分類。

核心 GA
az sql db classification show

取得指定數據行的敏感度分類。

核心 GA
az sql db classification update

更新數據行的敏感度分類。

核心 GA
az sql db copy

建立資料庫的複本。

核心 GA
az sql db create

建立資料庫。

核心 GA
az sql db delete

刪除資料庫。

核心 GA
az sql db export

將資料庫導出至 bacpac。

核心 GA
az sql db geo-backup

管理 SQL Database 異地備援備份。

核心 預覽​​
az sql db geo-backup list

取得可復原的資料庫清單。

核心 預覽​​
az sql db geo-backup restore

將異地備援備份還原至新的資料庫。

核心 預覽​​
az sql db geo-backup show

取得可復原的資料庫,這是代表資料庫異地備份的資源。

核心 預覽​​
az sql db import

將 bacpac 匯入新資料庫或現有的空白資料庫。

核心 GA
az sql db ledger-digest-uploads

管理總帳摘要上傳設定。

核心 GA
az sql db ledger-digest-uploads disable

停用上傳總帳摘要。

核心 GA
az sql db ledger-digest-uploads enable

啟用將總帳摘要上傳至 Azure 儲存體 帳戶或 Azure 機密總帳。 如果已啟用上傳總帳摘要,Cmdlet 會將摘要記憶體端點重設為新的值。

核心 GA
az sql db ledger-digest-uploads show

顯示目前的總帳摘要設定。

核心 GA
az sql db list

列出伺服器或彈性集區上的資料庫。

核心 GA
az sql db list-deleted

取得可還原的已卸除資料庫清單。

核心 GA
az sql db list-editions

顯示目前使用中訂閱可用的資料庫版本。

核心 GA
az sql db list-usages

取得資料庫使用方式。

核心 GA
az sql db ltr-backup

管理 SQL Database 長期保留備份。

核心 預覽​​
az sql db ltr-backup delete

刪除長期保留備份。

核心 預覽​​
az sql db ltr-backup list

列出位置、伺服器或資料庫的長期保留備份。

核心 預覽​​
az sql db ltr-backup restore

將長期保留備份還原至新的資料庫。

核心 預覽​​
az sql db ltr-backup show

取得資料庫的長期保留備份。

核心 預覽​​
az sql db ltr-backup wait

將 CLI 置於等候狀態,直到符合資料庫的條件為止。

核心 預覽​​
az sql db ltr-policy

管理 SQL Database 長期保留原則。

核心 預覽​​
az sql db ltr-policy set

更新資料庫的長期保留設定。

核心 預覽​​
az sql db ltr-policy show

顯示資料庫的長期保留原則。

核心 預覽​​
az sql db op

管理資料庫上的作業。

核心 GA
az sql db op cancel

取消資料庫的異步操作。

核心 GA
az sql db op list

取得在資料庫上執行的作業清單。

核心 GA
az sql db rename

重新命名資料庫。

核心 GA
az sql db replica

管理資料庫之間的複寫。

核心 GA
az sql db replica create

將資料庫建立為現有資料庫的可讀取次要複本。

核心 GA
az sql db replica delete-link

永久停止兩個資料庫複本之間的數據複寫。

核心 GA
az sql db replica list-links

列出資料庫的複本及其復寫狀態。

核心 GA
az sql db replica set-primary

從目前的主要復本資料庫故障轉移,以設定主要複本資料庫。

核心 GA
az sql db restore

從備份還原來建立新的資料庫。

核心 GA
az sql db show

取得資料庫的詳細數據。

核心 GA
az sql db show-connection-string

產生資料庫的連接字串。

核心 GA
az sql db show-deleted

取得已刪除資料庫的詳細數據。

核心 GA
az sql db str-policy

管理 SQL Database 短期保留原則。

核心 預覽​​
az sql db str-policy set

更新實時資料庫的短期保留設定。

核心 預覽​​
az sql db str-policy show

顯示實時資料庫的短期保留原則。

核心 預覽​​
az sql db str-policy wait

將 CLI 置於等候狀態,直到設定原則為止。

核心 預覽​​
az sql db tde

管理資料庫的透明數據加密。

核心 GA
az sql db tde key

管理資料庫的加密保護裝置。

核心 GA
az sql db tde key revalidate

重新驗證資料庫的加密保護裝置金鑰。

核心 GA
az sql db tde key revert

將資料庫的加密保護裝置金鑰還原為伺服器層級。

核心 GA
az sql db tde set

設定資料庫的透明數據加密組態。

核心 GA
az sql db tde show

顯示 透明資料加密。

核心 GA
az sql db threat-policy

管理資料庫的威脅偵測原則。

核心 已淘汰
az sql db threat-policy show

取得威脅偵測原則。

核心 已淘汰
az sql db threat-policy update

更新資料庫的威脅偵測原則。

核心 已淘汰
az sql db update

更新資料庫。

核心 GA

az sql db copy

建立資料庫的複本。

執行 az sql db list-editions -a -o table -l LOCATION即可看到效能等級選項的完整清單。 複製目的地資料庫必須具有與源資料庫相同的版本,但您可以在複製完成後變更版本。

az sql db copy --dest-name
               [--assign-identity {false, true}]
               [--auto-pause-delay]
               [--availability-zone]
               [--backup-storage-redundancy]
               [--capacity]
               [--compute-model {Provisioned, Serverless}]
               [--dest-resource-group]
               [--dest-server]
               [--elastic-pool]
               [--encryption-protector]
               [--encryption-protector-auto-rotation {false, true}]
               [--family]
               [--federated-client-id]
               [--ha-replicas]
               [--ids]
               [--keys]
               [--license-type {BasePrice, LicenseIncluded}]
               [--min-capacity]
               [--name]
               [--no-wait]
               [--preferred-enclave-type {Default, VBS}]
               [--read-scale {Disabled, Enabled}]
               [--resource-group]
               [--server]
               [--service-level-objective]
               [--subscription]
               [--tags]
               [--umi]
               [--zone-redundant {false, true}]

範例

建立效能等級為 S0 的資料庫,作為現有標準資料庫的複本。

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb --service-objective S0

使用 GeneralPurpose 版本、Gen4 硬體和 1 個虛擬核心建立資料庫,作為現有 GeneralPurpose 資料庫的複本。

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb -f Gen4 -c 1

建立具有本機備份記憶體備援的資料庫作為現有資料庫的複本

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb --backup-storage-redundancy Local

必要參數

--dest-name

將建立為複製目的地的資料庫名稱。

選擇性參數

--assign-identity -i

指派資料庫的身分識別。

接受的值: false, true
--auto-pause-delay

在幾分鐘后自動暫停資料庫的時間。 值為 -1 表示已停用自動暫停。

--availability-zone

可用性區域。

--backup-storage-redundancy --bsr

用來儲存備份的備份記憶體備援。 允許的值包括:Local、Zone、Geo、GeoZone。

--capacity -c

SKU 的容量元件,以整數位 DTU 或虛擬核心為單位。

--compute-model

資料庫的計算模型。

接受的值: Provisioned, Serverless
--dest-resource-group

要建立複本的資源群組名稱。 如果未指定,則預設為原始資源群組。

--dest-server

要建立複本的伺服器名稱。 如果未指定,則預設為源伺服器。

--elastic-pool

要用來建立資料庫之彈性集區的名稱或資源標識符。

--encryption-protector

指定要作為資料庫加密保護裝置密鑰的 Azure 金鑰保存庫金鑰。

--encryption-protector-auto-rotation --epauto

指定資料庫加密保護裝置金鑰自動輪替旗標。 可以是 true、false 或 null。

接受的值: false, true
--family -f

SKU 的計算產生元件(僅適用於虛擬核心 SKU)。 允許的值包括:Gen4、Gen5。

--federated-client-id

SQL 資料庫的同盟用戶端標識碼。 它用於跨租使用者 CMK 案例。

--ha-replicas --read-replicas

要為資料庫布建的高可用性復本數目。 只有超大規模資料庫版本的可設定。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--keys

SQL 資料庫 的 AKV 金鑰清單。

--license-type

要套用此資料庫的授權類型。LicenseIncluded 如果您需要授權,或 BasePrice如果您有授權且符合 Azure HybridBenefit 資格。

接受的值: BasePrice, LicenseIncluded
--min-capacity

如果尚未暫停,資料庫一律會配置的最小容量。

--name -n

Azure SQL 資料庫 的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--preferred-enclave-type

指定此資源的記憶體保護區類型。

接受的值: Default, VBS
--read-scale

如果啟用,將應用程式意圖設定為唯讀 連接字串的連線可能會路由傳送至唯讀次要複本。 此屬性僅適用於 Premium 和 業務關鍵 資料庫。

接受的值: Disabled, Enabled
--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--service-level-objective --service-objective

新資料庫的服務目標。 例如:Basic、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。

--subscription

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

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--umi --user-assigned-identity-id

SQL 資料庫的使用者指派身分識別清單。

--zone-redundant -z

指定是否要啟用區域備援。 如果未指定任何值,預設值為 true。

接受的值: false, true
全域參數
--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 sql db create

建立資料庫。

執行 az sql db list-editions -a -o table -l LOCATION即可看到效能等級選項的完整清單。

az sql db create --name
                 --resource-group
                 --server
                 [--assign-identity {false, true}]
                 [--auto-pause-delay]
                 [--availability-zone]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--catalog-collation {DATABASE_DEFAULT, SQL_Latin1_General_CP1_CI_AS}]
                 [--collation]
                 [--compute-model {Provisioned, Serverless}]
                 [--edition]
                 [--elastic-pool]
                 [--encryption-protector]
                 [--encryption-protector-auto-rotation {false, true}]
                 [--exhaustion-behavior {AutoPause, BillOverUsage}]
                 [--family]
                 [--federated-client-id]
                 [--free-limit {false, true}]
                 [--ha-replicas]
                 [--keys]
                 [--ledger-on {Disabled, Enabled}]
                 [--license-type {BasePrice, LicenseIncluded}]
                 [--maint-config-id]
                 [--max-size]
                 [--min-capacity]
                 [--no-wait]
                 [--preferred-enclave-type {Default, VBS}]
                 [--read-scale {Disabled, Enabled}]
                 [--sample-name {AdventureWorksLT}]
                 [--service-level-objective]
                 [--tags]
                 [--umi]
                 [--yes]
                 [--zone-redundant {false, true}]

範例

建立標準 S0 資料庫。

az sql db create -g mygroup -s myserver -n mydb --service-objective S0

使用 GeneralPurpose 版本、Gen4 硬體和 1 個虛擬核心建立資料庫

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1

建立已啟用區域備援的資料庫

az sql db create -g mygroup -s myserver -n mydb -z

建立已明確停用區域備援的資料庫

az sql db create -g mygroup -s myserver -n mydb -z false

建立 GeneralPurpose Gen5 2 虛擬核心無伺服器資料庫,自動暫停延遲 120 分鐘

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen5 -c 2 --compute-model Serverless --auto-pause-delay 120

建立具有 2 個讀取複本的超大規模資料庫 5 2 個虛擬核心資料庫

az sql db create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 2 --read-replicas 2

建立具有本地備援備份記憶體的 GeneralPurpose 資料庫

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose --backup-storage-redundancy Local

建立已啟用 VBS 記憶體保護區的資料庫。

az sql db create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

建立套用免費限制的資料庫

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen5 -c 2 --compute-model Serverless --use-free-limit --free-limit-exhaustion-behavior AutoPause

必要參數

--name -n

Azure SQL 資料庫 的名稱。

--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

選擇性參數

--assign-identity -i

指派資料庫的身分識別。

接受的值: false, true
--auto-pause-delay

在幾分鐘后自動暫停資料庫的時間。 值為 -1 表示已停用自動暫停。

--availability-zone

可用性區域。

--backup-storage-redundancy --bsr

用來儲存備份的備份記憶體備援。 允許的值包括:Local、Zone、Geo、GeoZone。

--capacity -c

SKU 的容量元件,以整數位 DTU 或虛擬核心為單位。

--catalog-collation

元資料目錄的定序。

接受的值: DATABASE_DEFAULT, SQL_Latin1_General_CP1_CI_AS
--collation

資料庫的定序。

--compute-model

資料庫的計算模型。

接受的值: Provisioned, Serverless
--edition --tier -e

SKU 版本元件。 允許的值包括:Basic、Standard、Premium、GeneralPurpose、BusinessCritical、Hyperscale。

--elastic-pool

要用來建立資料庫之彈性集區的名稱或資源標識符。

--encryption-protector

指定要作為資料庫加密保護裝置密鑰的 Azure 金鑰保存庫金鑰。

--encryption-protector-auto-rotation --epauto

指定資料庫加密保護裝置金鑰自動輪替旗標。 可以是 true、false 或 null。

接受的值: false, true
--exhaustion-behavior --fleb --free-limit-exhaustion-behavior

指定免費資料庫用完每月可用限制時的行為。AutoPause:資料庫會在當月剩餘時間的可用限制用盡時自動暫停。BillForUsage:資料庫在免費限制用盡時將繼續上線,並收取任何超額費用。

接受的值: AutoPause, BillOverUsage
--family -f

SKU 的計算產生元件(僅適用於虛擬核心 SKU)。 允許的值包括:Gen4、Gen5。

--federated-client-id

SQL 資料庫的同盟用戶端標識碼。 它用於跨租使用者 CMK 案例。

--free-limit --use-free-limit

資料庫是否使用免費每月限制。 在訂用帳戶中的一個資料庫上允許。

接受的值: false, true
--ha-replicas --read-replicas

要為資料庫布建的高可用性復本數目。 只有超大規模資料庫版本的可設定。

--keys

SQL 資料庫 的 AKV 金鑰清單。

--ledger-on

建立總賬資料庫,其中所有數據的完整性都會受到總帳功能的保護。 總賬資料庫中的所有數據表都必須是總賬數據表。 注意:建立資料庫之後,就無法變更此屬性的值。

接受的值: Disabled, Enabled
--license-type

要套用此資料庫的授權類型。LicenseIncluded 如果您需要授權,或 BasePrice如果您有授權且符合 Azure HybridBenefit 資格。

接受的值: BasePrice, LicenseIncluded
--maint-config-id -m

為此資源指定維護組態標識碼或名稱。

--max-size

記憶體大小上限。 如果未指定任何單位,則預設為位元組 (B)。

--min-capacity

如果尚未暫停,資料庫一律會配置的最小容量。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--preferred-enclave-type

指定此資源的記憶體保護區類型。

接受的值: Default, VBS
--read-scale

如果啟用,將應用程式意圖設定為唯讀 連接字串的連線可能會路由傳送至唯讀次要複本。 此屬性僅適用於 Premium 和 業務關鍵 資料庫。

接受的值: Disabled, Enabled
--sample-name

建立 thisdatabase 時要套用的範例架構名稱。

接受的值: AdventureWorksLT
--service-level-objective --service-objective

新資料庫的服務目標。 例如:Basic、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--umi --user-assigned-identity-id

SQL 資料庫的使用者指派身分識別清單。

--yes -y

不提示確認。

--zone-redundant -z

指定是否要啟用區域備援。 如果未指定任何值,預設值為 true。

接受的值: false, true
全域參數
--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 sql db delete

刪除資料庫。

az sql db delete [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]
                 [--yes]

範例

刪除資料庫。 ( 自動產生 )

az sql db delete --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Azure SQL 資料庫 的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

--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 sql db export

將資料庫導出至 bacpac。

az sql db export --admin-password
                 --admin-user
                 --storage-key
                 --storage-key-type {SharedAccessKey, StorageAccessKey}
                 --storage-uri
                 [--auth-type {ADPassword, SQL}]
                 [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]

範例

取得用於匯出作業的SAS 金鑰。

az storage blob generate-sas --account-name myAccountName -c myContainer -n myBacpac.bacpac \
    --permissions rw --expiry 2018-01-01T00:00:00Z

使用 SAS 金鑰匯出 bacpac。

az sql db export -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key "?sr=b&sp=rw&se=2018-01-01T00%3A00%3A00Z&sig=mysignature&sv=2015-07-08" \
    --storage-key-type SharedAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

使用記憶體帳戶金鑰匯出 bacpac。

az sql db export -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key MYKEY== --storage-key-type StorageAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

必要參數

--admin-password -p

必要。 系統管理員登入密碼。

--admin-user -u

必要。 系統管理員登入名稱。

--storage-key

必要。 記憶體金鑰。

--storage-key-type

必要。 儲存器金鑰類型。

接受的值: SharedAccessKey, StorageAccessKey
--storage-uri

必要。 記憶體 URI。

選擇性參數

--auth-type -a

驗證類型。

接受的值: ADPassword, SQL
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Azure SQL 資料庫 的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

全域參數
--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 sql db import

將 bacpac 匯入新資料庫或現有的空白資料庫。

az sql db import --admin-password
                 --admin-user
                 --storage-key
                 --storage-key-type {SharedAccessKey, StorageAccessKey}
                 --storage-uri
                 [--auth-type {ADPassword, SQL}]
                 [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]

範例

取得 SAS 金鑰以用於匯入作業。

az storage blob generate-sas --account-name myAccountName -c myContainer -n myBacpac.bacpac \
    --permissions rw --expiry 2018-01-01T00:00:00Z

使用 SAS 金鑰將 bacpac 匯入現有的資料庫。

az sql db import -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key "?sr=b&sp=rw&se=2018-01-01T00%3A00%3A00Z&sig=mysignature&sv=2015-07-08" \
    --storage-key-type SharedAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

使用記憶體帳戶金鑰將 bacpac 匯入現有的資料庫。

az sql db import -s myserver -n mydatabase -g mygroup -p password -u login --storage-key MYKEY== \
    --storage-key-type StorageAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

必要參數

--admin-password -p

必要。 系統管理員登入密碼。

--admin-user -u

必要。 系統管理員登入名稱。

--storage-key

必要。 記憶體金鑰。

--storage-key-type

必要。 儲存器金鑰類型。

接受的值: SharedAccessKey, StorageAccessKey
--storage-uri

必要。 記憶體 URI。

選擇性參數

--auth-type -a

驗證類型。

接受的值: ADPassword, SQL
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Azure SQL 資料庫 的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

全域參數
--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 sql db list

列出伺服器或彈性集區上的資料庫。

az sql db list [--elastic-pool]
               [--ids]
               [--resource-group]
               [--server]
               [--subscription]

範例

列出伺服器或彈性集區上的資料庫。 ( 自動產生 )

az sql db list --resource-group MyResourceGroup --server myserver

選擇性參數

--elastic-pool

如果指定,則只會列出這個彈性集區中的資料庫。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

全域參數
--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 sql db list-deleted

取得可還原的已卸除資料庫清單。

az sql db list-deleted [--ids]
                       [--resource-group]
                       [--server]
                       [--subscription]

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

全域參數
--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 sql db list-editions

顯示目前使用中訂閱可用的資料庫版本。

包含可用的服務目標和記憶體限制。 為了減少詳細資訊,預設會隱藏刻意減少儲存限制的設定。

az sql db list-editions --location
                        [--available]
                        [--dtu]
                        [--edition]
                        [--service-objective]
                        [--show-details {max-size}]
                        [--vcores]

範例

顯示位置中的所有資料庫版本。

az sql db list-editions -l westus -o table

顯示 Standard Edition 的所有可用資料庫服務目標。

az sql db list-editions -l westus --edition Standard -o table

顯示 P1 服務目標的可用資料庫大小上限

az sql db list-editions -l westus --service-objective P1 --show-details max-size

必要參數

--location -l

位置。​​ 值的來源:az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

選擇性參數

--available -a

如果指定,則只會顯示指定區域中可用的結果。

預設值: False
--dtu

要搜尋的 DTU 數目。 如果未指定,則會顯示所有 DTU 大小。

--edition --tier -e

要搜尋的版本。 如果未指定,則會顯示所有版本。

--service-objective

要搜尋的服務目標。 如果未指定,則會顯示所有服務目標。

--show-details -d

要包含在輸出中的其他詳細數據清單。

接受的值: max-size
--vcores

要搜尋的虛擬核心數目。 如果未指定,則會顯示所有虛擬核心大小。

全域參數
--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 sql db list-usages

取得資料庫使用方式。

az sql db list-usages [--ids]
                      [--name]
                      [--resource-group]
                      [--server]
                      [--subscription]

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Azure SQL 資料庫 的名稱。

--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

全域參數
--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 sql db rename

重新命名資料庫。

az sql db rename --new-name
                 [--ids]
                 [--name]
                 [--resource-group]
                 [--server]
                 [--subscription]

範例

重新命名資料庫。 ( 自動產生 )

az sql db rename --name MyAzureSQLDatabase --new-name MyNew --resource-group MyResourceGroup --server myserver

必要參數

--new-name

將重新命名資料庫的新名稱。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Azure SQL 資料庫 的名稱。

--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

全域參數
--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 sql db restore

從備份還原來建立新的資料庫。

az sql db restore --dest-name
                  [--assign-identity {false, true}]
                  [--auto-pause-delay]
                  [--availability-zone]
                  [--backup-storage-redundancy]
                  [--capacity]
                  [--compute-model {Provisioned, Serverless}]
                  [--deleted-time]
                  [--edition]
                  [--elastic-pool]
                  [--encryption-protector]
                  [--encryption-protector-auto-rotation {false, true}]
                  [--family]
                  [--federated-client-id]
                  [--ha-replicas]
                  [--ids]
                  [--keys]
                  [--license-type {BasePrice, LicenseIncluded}]
                  [--min-capacity]
                  [--name]
                  [--no-wait]
                  [--preferred-enclave-type {Default, VBS}]
                  [--read-scale {Disabled, Enabled}]
                  [--resource-group]
                  [--server]
                  [--service-level-objective]
                  [--subscription]
                  [--tags]
                  [--time]
                  [--umi]
                  [--zone-redundant {false, true}]

範例

從備份還原來建立新的資料庫。 ( 自動產生 )

az sql db restore --dest-name MyDest --edition GeneralPurpose --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription --time "2018-05-20T05:34:22"

從備份還原,建立具有異地備援備份記憶體的新資料庫。 ( 自動產生 )

az sql db restore --dest-name MyDest --edition GeneralPurpose --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription --time "2018-05-20T05:34:22" --backup-storage-redundancy Geo

必要參數

--dest-name

將建立為還原目的地的資料庫名稱。

選擇性參數

--assign-identity -i

指派資料庫的身分識別。

接受的值: false, true
--auto-pause-delay

在幾分鐘后自動暫停資料庫的時間。 值為 -1 表示已停用自動暫停。

--availability-zone

可用性區域。

--backup-storage-redundancy --bsr

用來儲存備份的備份記憶體備援。 允許的值包括:Local、Zone、Geo、GeoZone。

--capacity -c

SKU 的容量元件,以整數位 DTU 或虛擬核心為單位。

--compute-model

資料庫的計算模型。

接受的值: Provisioned, Serverless
--deleted-time

如果指定,請從已刪除的資料庫還原,而不是從現有的資料庫還原。 必須符合相同伺服器中已刪除資料庫的已刪除時間。 必須指定 --time 或 --deleted-time (或兩者)。 時間的格式應如下:「YYYY-MM-DDTHH:MM:SS」。。

--edition --tier -e

SKU 版本元件。 允許的值包括:Basic、Standard、Premium、GeneralPurpose、BusinessCritical、Hyperscale。

--elastic-pool

要用來建立資料庫之彈性集區的名稱或資源標識符。

--encryption-protector

指定要作為資料庫加密保護裝置密鑰的 Azure 金鑰保存庫金鑰。

--encryption-protector-auto-rotation --epauto

指定資料庫加密保護裝置金鑰自動輪替旗標。 可以是 true、false 或 null。

接受的值: false, true
--family -f

SKU 的計算產生元件(僅適用於虛擬核心 SKU)。 允許的值包括:Gen4、Gen5。

--federated-client-id

SQL 資料庫的同盟用戶端標識碼。 它用於跨租使用者 CMK 案例。

--ha-replicas --read-replicas

要為資料庫布建的高可用性復本數目。 只有超大規模資料庫版本的可設定。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--keys

SQL 資料庫 的 AKV 金鑰清單。

--license-type

要套用此資料庫的授權類型。LicenseIncluded 如果您需要授權,或 BasePrice如果您有授權且符合 Azure HybridBenefit 資格。

接受的值: BasePrice, LicenseIncluded
--min-capacity

如果尚未暫停,資料庫一律會配置的最小容量。

--name -n

Azure SQL 資料庫 的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--preferred-enclave-type

指定此資源的記憶體保護區類型。

接受的值: Default, VBS
--read-scale

如果啟用,將應用程式意圖設定為唯讀 連接字串的連線可能會路由傳送至唯讀次要複本。 此屬性僅適用於 Premium 和 業務關鍵 資料庫。

接受的值: Disabled, Enabled
--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--service-level-objective --service-objective

新資料庫的服務目標。 例如:Basic、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。

--subscription

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

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--time -t

將還原以建立新資料庫的源資料庫時間點。 必須大於或等於源資料庫的最早RestoreDate 值。 必須指定 --time 或 --deleted-time (或兩者)。 時間的格式應如下:「YYYY-MM-DDTHH:MM:SS」。。

--umi --user-assigned-identity-id

SQL 資料庫的使用者指派身分識別清單。

--zone-redundant -z

指定是否要啟用區域備援。 如果未指定任何值,預設值為 true。

接受的值: false, true
全域參數
--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 sql db show

取得資料庫的詳細數據。

az sql db show [--expand-keys {false, true}]
               [--ids]
               [--keys-filter]
               [--name]
               [--resource-group]
               [--server]
               [--subscription]

範例

取得資料庫的詳細數據。 ( 自動產生 )

az sql db show --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

選擇性參數

--expand-keys

展開資料庫的 AKV 金鑰。

接受的值: false, true
預設值: False
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--keys-filter

展開資料庫的 AKV 金鑰。

--name -n

Azure SQL 資料庫 的名稱。

--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

全域參數
--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 sql db show-connection-string

產生資料庫的連接字串。

az sql db show-connection-string --client {ado.net, jdbc, odbc, php, php_pdo, sqlcmd}
                                 [--auth-type {ADIntegrated, ADPassword, SqlPassword}]
                                 [--ids]
                                 [--name]
                                 [--server]
                                 [--subscription]

範例

產生 ado.net 的 連接字串

az sql db show-connection-string -s myserver -n mydb -c ado.net

必要參數

--client -c

用戶端連線提供者的類型。

接受的值: ado.net, jdbc, odbc, php, php_pdo, sqlcmd

選擇性參數

--auth-type -a

驗證類型。

接受的值: ADIntegrated, ADPassword, SqlPassword
預設值: SqlPassword
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Azure SQL 資料庫 的名稱。

預設值: <databasename>
--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

預設值: <servername>
--subscription

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

全域參數
--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 sql db show-deleted

取得已刪除資料庫的詳細數據。

az sql db show-deleted --restorable-dropped-database-id
                       [--expand-keys {false, true}]
                       [--ids]
                       [--keys-filter]
                       [--resource-group]
                       [--server]
                       [--subscription]

範例

取得已刪除資料庫的詳細數據。 ( 自動產生 )

az sql db show-deleted --resource-group MyResourceGroup --server myserver --restorable-dropped-database-id "MyAzureSQLDatabase,133203966918270000"

必要參數

--restorable-dropped-database-id -r

可還原的已卸除資料庫標識碼。

選擇性參數

--expand-keys

展開資料庫的 AKV 金鑰。

接受的值: false, true
預設值: False
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--keys-filter

展開資料庫的 AKV 金鑰。

--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--subscription

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

全域參數
--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 sql db update

更新資料庫。

az sql db update [--add]
                 [--assign-identity {false, true}]
                 [--auto-pause-delay]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--compute-model {Provisioned, Serverless}]
                 [--edition]
                 [--elastic-pool]
                 [--encryption-protector]
                 [--encryption-protector-auto-rotation {false, true}]
                 [--exhaustion-behavior {AutoPause, BillOverUsage}]
                 [--family]
                 [--federated-client-id]
                 [--filter]
                 [--force-string]
                 [--free-limit {false, true}]
                 [--ha-replicas]
                 [--ids]
                 [--keys]
                 [--keys-to-remove]
                 [--maint-config-id]
                 [--manual-cutover {false, true}]
                 [--max-size]
                 [--min-capacity]
                 [--name]
                 [--no-wait]
                 [--perform-cutover {false, true}]
                 [--preferred-enclave-type {Default, VBS}]
                 [--read-scale {Disabled, Enabled}]
                 [--remove]
                 [--resource-group]
                 [--server]
                 [--service-objective]
                 [--set]
                 [--subscription]
                 [--umi]
                 [--zone-redundant {false, true}]

範例

藉由指定 DTU 容量,將資料庫更新為 Standard Edition、S0 效能等級 (10 DTU)。 請注意,GeneralPurpose 允許比標準版更廣泛的大小上限。

az sql db update -g mygroup -s myserver -n mydb --edition Standard --capacity 10 --max-size 250GB

藉由指定效能等級名稱,將資料庫更新為 Standard Edition S1 效能等級 (20 DTU)。 請注意,GeneralPurpose 允許比標準版更廣泛的大小上限。

az sql db update -g mygroup -s myserver -n mydb --edition Standard --service-objective S1 --max-size 250GB

使用 Gen5 硬體將資料庫更新為 GeneralPurpose 版本、4 個虛擬核心

az sql db update -g mygroup -s myserver -n mydb --edition GeneralPurpose --capacity 4 --family Gen5

以增加的大小更新資料庫

az sql db update -g mygroup -s myserver -n mydb --max-size 500GB

更新已啟用區域備援的資料庫

az sql db update -g mygroup -s myserver -n mydb -z

使用明確停用區域備援更新資料庫

az sql db update -g mygroup -s myserver -n mydb -z false

將資料庫更新為無伺服器計算模型

az sql db update -g mygroup -s myserver -n mydb --edition GeneralPurpose --capacity 2 --family Gen5 --compute-model Serverless

使用本地備援備份記憶體更新資料庫

az sql db update -g mygroup -s myserver -n mydb --backup-storage-redundancy Local

使用已啟用 VBS 記憶體保護區更新資料庫。

az sql db update -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

將免費限制資料庫的耗盡行為更新為 BillOverUsage

az sql db update -g mygroup -s myserver -n mydb --free-limit-exhaustion-behavior BillOverUsage

使用手動完全移轉選項,將資料庫更新至超大規模資料庫,使用 Gen5 硬體的 2 個虛擬核心

az sql db update -g mygroup -s myserver -n mydb --edition Hyperscale --service-objective HS_Gen5_2 --manual-cutover

將資料庫更新為超大規模資料庫進行時,使用執行完全移轉選項觸發完全移轉

az sql db update -g mygroup -s myserver -n mydb --perform-cutover

選擇性參數

--add

藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value, string or JSON string>

預設值: []
--assign-identity -i

指派資料庫的身分識別。

接受的值: false, true
預設值: False
--auto-pause-delay

在幾分鐘后自動暫停資料庫的時間。 值為 -1 表示已停用自動暫停。

--backup-storage-redundancy --bsr

用來儲存備份的備份記憶體備援。 允許的值包括:Local、Zone、Geo、GeoZone。

--capacity -c

SKU 的容量元件,以整數位 DTU 或虛擬核心為單位。

--compute-model

資料庫的計算模型。

接受的值: Provisioned, Serverless
--edition --tier -e

SKU 版本元件。 允許的值包括:Basic、Standard、Premium、GeneralPurpose、BusinessCritical、Hyperscale。

--elastic-pool

要移入資料庫之彈性集區的名稱或資源標識碼。

--encryption-protector

指定要作為資料庫加密保護裝置密鑰的 Azure 金鑰保存庫金鑰。

--encryption-protector-auto-rotation --epauto

指定資料庫加密保護裝置金鑰自動輪替旗標。 可以是 true、false 或 null。

接受的值: false, true
--exhaustion-behavior --fleb --free-limit-exhaustion-behavior

指定免費資料庫用完每月可用限制時的行為。AutoPause:資料庫會在當月剩餘時間的可用限制用盡時自動暫停。BillForUsage:資料庫在免費限制用盡時將繼續上線,並收取任何超額費用。

接受的值: AutoPause, BillOverUsage
--family -f

SKU 的計算產生元件(僅適用於虛擬核心 SKU)。 允許的值包括:Gen4、Gen5。

--federated-client-id

SQL 資料庫的同盟用戶端標識碼。 它用於跨租使用者 CMK 案例。

--filter

篩選集合中元素的 OData 篩選表示式。 預設值為 None。

--force-string

使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。

預設值: False
--free-limit --use-free-limit

資料庫是否使用免費每月限制。 在訂用帳戶中的一個資料庫上允許。

接受的值: false, true
--ha-replicas --read-replicas

要為資料庫布建的高可用性復本數目。 只有超大規模資料庫版本的可設定。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--keys

SQL 資料庫 的 AKV 金鑰清單。

--keys-to-remove

要從 SQL 資料庫 移除的 AKV 金鑰清單。

--maint-config-id -m

為此資源指定維護組態標識碼或名稱。

--manual-cutover

是否要在更新 SLO 期間執行手動完全移轉。 將資料庫更新至超大規模資料庫層級時允許。

接受的值: false, true
--max-size

以位元組表示之資料庫的新大小上限。

--min-capacity

如果尚未暫停,資料庫一律會配置的最小容量。

--name -n

Azure SQL 資料庫 的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--perform-cutover

是否要在將資料庫更新至超大規模資料庫層級時執行完全移轉。

接受的值: false, true
--preferred-enclave-type

指定此資源的記憶體保護區類型。

接受的值: Default, VBS
--read-scale

如果啟用,將應用程式意圖設定為唯讀 連接字串的連線可能會路由傳送至唯讀次要複本。 此屬性僅適用於 Premium 和 業務關鍵 資料庫。

接受的值: Disabled, Enabled
--remove

從清單中移除屬性或專案。 範例: --remove property.list <indexToRemove>--remove propertyToRemove

預設值: []
--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>

--service-objective

新服務目標的名稱。 如果這是獨立的資料庫服務目標,且資料庫目前位於彈性集區中,則會從集區中移除資料庫。

--set

指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=<value>

預設值: []
--subscription

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

--umi --user-assigned-identity-id

SQL 資料庫的使用者指派身分識別清單。

--zone-redundant -z

指定是否要啟用區域備援。 如果未指定任何值,預設值為 true。

接受的值: false, true
全域參數
--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 來取得完整偵錯記錄。