az sql db ltr-policy

管理 SQL Database 長期保留原則。

命令

名稱	Description	類型	狀態
az sql db ltr-policy set	更新資料庫的長期保留設定。	Core	GA
az sql db ltr-policy show	顯示資料庫的長期保留原則。	Core	GA

az sql db ltr-policy set

編輯

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

az sql db ltr-policy set [--ids]
                         [--make-backups-immutable --tb-immutability]
                         [--monthly-retention]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]
                         [--tb-immutability-mode]
                         [--week-of-year]
                         [--weekly-retention]
                         [--yearly-retention]
                         [--yes]

範例

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

az sql db ltr-policy set -g mygroup -s myserver -n mydb --weekly-retention "P1W" --monthly-retention "P6M" --yearly-retention "P1Y" --week-of-year 26 --make-backups-immutable Enabled

為已啟用時間型不變性且鎖定不變性模式的資料庫設定長期保留。

az sql db ltr-policy set -g mygroup -s myserver -n mydb --weekly-retention "P0W" --monthly-retention "P0M" --yearly-retention "P0Y" --tb-immutability Enabled --tb-immutability-mode Locked

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--make-backups-immutable --tb-immutability

是否要在 LTR 備份上啟用以時間為基礎的不變性。可能的值為：「True」、「False」、「Enabled」、「Disabled」。

--monthly-retention

每月備份的保留期。如果只傳遞數位而不是 ISO 8601 字串，則會假設天數為單位。至少有 7 天，最多 10 年。

--name -n

Azure SQL Database 的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--server -s

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--tb-immutability-mode

要在 LTR 備份上設定的時間型不變性模式。可能的值為：「已鎖定」、「已解除鎖定」。只有在啟用 make-backups-immutable 時，這才有效。

--week-of-year

年度周，1 到 52，用來進行每年 LTR 備份。

--weekly-retention

每周備份的保留期。如果只傳遞數位而不是 ISO 8601 字串，則會假設天數為單位。至少有 7 天，最多 10 年。

--yearly-retention

每年備份的保留期。如果只傳遞數位而不是 ISO 8601 字串，則會假設天數為單位。至少有 7 天，最多 10 年。

--yes -y

請勿提示確認。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False