共用方式為


az sql db ltr-backup

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

管理 SQL Database 長期保留備份。

命令

名稱 Description 類型 狀態
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-backup delete

預覽

命令群組 'sql db ltr-backup' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

刪除長期保留備份。

az sql db ltr-backup delete --database
                            --location
                            --name
                            --server
                            [--yes]

範例

刪除資料庫的長期保留備份。

az sql db ltr-backup delete -l southeastasia -s myserver -d mydb -n "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"

必要參數

--database -d

Azure SQL 資料庫 的名稱。 如果指定 [連同伺服器名稱],則會擷取此資料庫下的所有要求備份。

--location -l

所需備份的位置。

--name -n

LTR 備份的名稱。 使用 'az sql db ltr-backup show' 或 'az sql db ltr-backup list' 進行備份名稱。

--server -s

Azure SQL Server 的名稱。 如果指定,則會擷取此伺服器下的所有要求備份。

選擇性參數

--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 ltr-backup list

預覽

命令群組 'sql db ltr-backup' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

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

az sql db ltr-backup list --location
                          [--database]
                          [--database-state]
                          [--latest]
                          [--resource-group]
                          [--server]

範例

列出資料庫的長期保留備份。

az sql db ltr-backup list -l southeastasia -s myserver -d mydb

列出伺服器的長期保留備份(僅列出屬於實時資料庫的最新 LTR 備份)。

az sql db ltr-backup list -l southeastasia -s myserver --database-state Live --only-latest-per-database True

列出伺服器的長期保留備份(含資源群組自變數)。

az sql db ltr-backup list -l southeastasia -g mygroup -s myserver

列出位置的長期保留備份(僅列出屬於實時資料庫的最新 LTR 備份)。

az sql db ltr-backup list -l southeastasia --database-state Live --only-latest-per-database True

列出位置的長期保留備份(含資源群組自變數)。

az sql db ltr-backup list -l southeastasia -g mygroup

必要參數

--location -l

所需備份的位置。

選擇性參數

--database -d

Azure SQL 資料庫 的名稱。 如果指定 [連同伺服器名稱],則會擷取此資料庫下的所有要求備份。

--database-state --state

'All'、'Live'或 'Deleted'。 只會從指定狀態的資料庫擷取備份。 如果未提供任何狀態,則預設為 『All』。

--latest --only-latest-per-database

如果為 true,則只會傳回每個資料庫的最新備份。

--resource-group -g

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

--server -s

Azure SQL Server 的名稱。 如果指定,則會擷取此伺服器下的所有要求備份。

全域參數
--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 ltr-backup restore

預覽

命令群組 'sql db ltr-backup' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

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

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

範例

還原 LTR 備份。

az sql db ltr-backup restore \
--dest-database targetdb --dest-server myserver --dest-resource-group mygroup \
--backup-id "/subscriptions/6caa113c-794c-42f8-ab9d-878d8aa104dc/resourceGroups/mygroup/providers/Microsoft.Sql/locations/southeastasia/longTermRetentionServers/myserver/longTermRetentionDatabases/sourcedb/longTermRetentionBackups/3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"

必要參數

--backup-id

要還原之長期保留備份的資源標識符。 使用 'az sql db ltr-backup show' 或 'az sql db ltr-backup list' 進行備份標識符。

--dest-database

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

--dest-resource-group

要還原資料庫之伺服器的資源群組名稱。

--dest-server

要還原資料庫的伺服器名稱。

選擇性參數

--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
--edition --tier -e

SKU 版本元件。 允許的值包括:基本、標準、進階版、GeneralPurpose、BusinessCritical、超大規模資料庫。

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

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

--keys

SQL 資料庫 的 AKV 金鑰清單。

--license-type

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

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

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

--no-wait

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

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

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

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

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

接受的值: Disabled, Enabled
--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 資料庫的使用者指派身分識別清單。

--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 ltr-backup show

預覽

命令群組 'sql db ltr-backup' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

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

az sql db ltr-backup show --database
                          --location
                          --name
                          --server

範例

顯示資料庫的長期保留備份。

az sql db ltr-backup show -l southeastasia -s myserver -d mydb -n "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000;Hot"

必要參數

--database -d

Azure SQL 資料庫 的名稱。 如果指定 [連同伺服器名稱],則會擷取此資料庫下的所有要求備份。

--location -l

所需備份的位置。

--name -n

LTR 備份的名稱。 使用 'az sql db ltr-backup show' 或 'az sql db ltr-backup list' 進行備份名稱。

--server -s

Azure SQL Server 的名稱。 如果指定,則會擷取此伺服器下的所有要求備份。

全域參數
--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 ltr-backup wait

預覽

命令群組 'sql db ltr-backup' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

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

az sql db ltr-backup wait [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand]
                          [--filter]
                          [--ids]
                          [--interval]
                          [--name]
                          [--resource-group]
                          [--server]
                          [--subscription]
                          [--timeout]
                          [--updated]

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--expand

要包含在回應中的子資源。 預設值為 None。

--filter

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

--ids

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

--interval

輪詢間隔以秒為單位。

預設值: 30
--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帳戶。

--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: 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 來取得完整偵錯記錄。