Azure SQL Database の長期的なバックアップ保有期間を管理する

有効な Azure サブスクリプション。

Azure CLI の環境を準備します。

• Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。

  

• CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。

  • ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。

  • 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。

  • az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。

PowerShell のための環境を準備します。

Get-AzSqlDatabaseLongTermRetentionBackup と Restore-AzSqlDatabase の場合、次のいずれかのロールのメンバーである必要があります。

• サブスクリプションの所有者ロール、または

• サブスクリプションの共同作成者ロール、または

• SQL Server 共同作成者ロールまたは

• 次のアクセス許可を持つカスタム ロール:

  Microsoft.Sql/locations/longTermRetentionBackups/read Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionBackups/read Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups/read

Remove-AzSqlDatabaseLongTermRetentionBackup では、次のいずれかのロールのメンバーである必要があります。

• サブスクリプションの所有者ロール、または

• サブスクリプションの共同作成者ロール、または

• 次のアクセス許可を持つカスタム ロール:

  Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups/delete

ご利用のサービス レベルのリテンション期間より長く自動バックアップを保持するように SQL Database を構成できます。

1. Azure portal で、ご自分のサーバーに移動してから、 [バックアップ] を選択します。 [保持ポリシー] タブを選択して、バックアップの保持設定を変更します。

   

2. [保持ポリシー] タブで、長期的なバックアップ保持ポリシーを設定または変更するデータベースを選択します。 選択されていないデータベースへの影響はありません。

   

3. [ポリシーの構成] ウィンドウで、週単位、月単位、または年単位のバックアップに必要な保有期間を指定します。 長期的なバックアップ保有期間を設定しないことを示すには、保有期間を "0" にします。

   

4. [適用] を選択して、指定した保有期間設定を選択したすべてのデータベースに適用します。

LTR ポリシーを作成するには、az sql db ltr-policy set コマンドを実行します。 次の例では、週単位のバックアップについて 12 週間の長期保有ポリシーを設定します。

az sql db ltr-policy set \
   --resource-group mygroup \
   --server myserver \
   --name mydb \
   --weekly-retention "P12W"

この例では、週単位のバックアップについては 12 週間、年単位のバックアップについては 5 年、年単位の LTR バックアップを取得するのは 4 月 15 日の週に設定します。

az sql db ltr-policy set \
   --resource-group mygroup \
   --server myserver \
   --name mydb \
   --weekly-retention "P12W" \
   --yearly-retention "P5Y" \
   --week-of-year 16

# get the SQL server
$subId = "<subscriptionId>"
$serverName = "<serverName>"
$resourceGroup = "<resourceGroupName>"
$dbName = "<databaseName>"

Connect-AzAccount
Select-AzSubscription -SubscriptionId $subId

$server = Get-AzSqlServer -ServerName $serverName -ResourceGroupName $resourceGroup

# create LTR policy with WeeklyRetention = 12 weeks. MonthlyRetention and YearlyRetention = 0 by default.
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ServerName $serverName -DatabaseName $dbName `
    -ResourceGroupName $resourceGroup -WeeklyRetention P12W

# create LTR policy with WeeklyRetention = 12 weeks, YearlyRetention = 5 years and WeekOfYear = 16 (week of April 15). MonthlyRetention = 0 by default.
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ServerName $serverName -DatabaseName $dbName `
    -ResourceGroupName $resourceGroup -WeeklyRetention P12W -YearlyRetention P5Y -WeekOfYear 16

1. Azure portal で、ご自分のサーバーに移動してから、 [バックアップ] を選択します。 特定のデータベースに使用可能な LTR バックアップを表示するには、[使用可能な LTR バックアップ] 列の下にある [管理] を選択します。 選択したデータベースに使用可能な LTR バックアップの一覧を示すウィンドウが表示されます。

   

2. 表示されている [使用可能な LTR バックアップ] ウィンドウで、使用可能なバックアップを確認します。 復元元のバックアップ セットを選択します。

   

3. 使用可能な LTR バックアップから復元するには、復元元のバックアップを選択してから、 [復元] を選択します。

   

4. 新しいデータベースの名前を選択してから、 [確認と作成] を選択して、復元の詳細を確認します。 [作成] を選択して、選択したバックアップからデータベースを復元します。

   

5. ツール バーの通知アイコンを選択して、復元ジョブの状態を確認します。

   

6. 復元ジョブが完了したら、 [SQL データベース] ページを開き、新しく復元されたデータベースを確認します。

LTR ポリシーを表示する

サーバーの 1 つのデータベースの LTR ポリシーを表示するには、az sql db ltr-policy show コマンドを実行します。

az sql db ltr-policy show \
    --resource-group mygroup \
    --server myserver \
    --name mydb

LTR バックアップを表示する

データベースの LTR バックアップの一覧を表示するには、az sql db ltr-backup list コマンドを使用します。 このコマンドを使用すると、他のコマンドで使用するための name パラメーターを知ることができます。

az sql db ltr-backup list \
   --location eastus2 \
   --server myserver \
   --database mydb

LTR バックアップから復元する

LTR バックアップからデータベースを復元するには、az sql db ltr-backup restore コマンドを実行します。 az sql db ltr-backup show を実行すると、backup-id を取得できます。

1. 後で使用するには、"az sql db ltr-backup show" コマンドで backup-id の変数を作成します。

   get_backup_id=$(az sql db ltr-backup show 
       --location eastus2 \
       --server myserver \
       --database mydb \
       --name "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000" \
       --query 'id' \
       --output tsv)
   

2. LTR バックアップからデータベースを復元します。

   az sql db ltr-backup restore \
      --dest-database targetdb \
      --dest-server myserver \
      --dest-resource-group mygroup \
      --backup-id $get_backup_id
   

LTR ポリシーを表示する

この例では、サーバー内の LTR ポリシーの一覧を表示する方法を示します。

# get all LTR policies within a server
$ltrPolicies = Get-AzSqlDatabase -ResourceGroupName $resourceGroup -ServerName $serverName | `
    Get-AzSqlDatabaseLongTermRetentionPolicy

# get the LTR policy of a specific database
$ltrPolicies = Get-AzSqlDatabaseBackupLongTermRetentionPolicy -ServerName $serverName -DatabaseName $dbName `
    -ResourceGroupName $resourceGroup

LTR ポリシーをクリアする

この例では、データベースから LTR ポリシーを消去する方法を示します。

Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ServerName $serverName -DatabaseName $dbName `
    -ResourceGroupName $resourceGroup -RemovePolicy

LTR バックアップを表示する

サーバー内の LTR バックアップを一覧表示する例を次に示します。

# get the list of all LTR backups in a specific Azure region
# backups are grouped by the logical database id, within each group they are ordered by the timestamp, the earliest backup first
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location

# get the list of LTR backups from the Azure region under the named server
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location -ServerName $serverName

# get the LTR backups for a specific database from the Azure region under the named server
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location -ServerName $serverName -DatabaseName $dbName

# list LTR backups only from live databases (you have option to choose All/Live/Deleted)
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location -DatabaseState Live

# only list the latest LTR backup for each database
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location -ServerName $serverName -OnlyLatestPerDatabase

LTR バックアップから復元する

LTR バックアップから復元する例を次に示します。 このインターフェイスは変更されませんでしたが、リソース ID パラメーターでは LTR バックアップ リソース ID が必須になりました。

# restore a specific LTR backup as an P1 database on the server $serverName of the resource group $resourceGroup
Restore-AzSqlDatabase -FromLongTermRetentionBackup -ResourceId $ltrBackup.ResourceId -ServerName $serverName -ResourceGroupName $resourceGroup `
    -TargetDatabaseName $dbName -ServiceObjectiveName P1

1. Azure portal で、Azure SQL Database の論理サーバーに移動します。
2. [バックアップ] を選択します。 特定のデータベースに使用可能な LTR バックアップを表示するには、[使用可能な LTR バックアップ] 列の下にある [管理] を選択します。 選択したデータベースに使用可能な LTR バックアップの一覧を示すウィンドウが表示されます。
3. 表示されている [使用可能な LTR バックアップ] ウィンドウで、使用可能なバックアップを確認します。 削除するバックアップを選択します。 [削除] を選択します。

1. az sql db ltr-backup list を使用すると、バックアップの name を確認できます。
2. LTR バックアップを削除するには、az sql db ltr-backup delete コマンドを実行します。

   az sql db ltr-backup delete \
      --location eastus2 \
      --server myserver \
      --database mydb \
      --name "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"
   

バックアップの一覧から LTR バックアップを削除する例を次に示します。

1. [LTR バックアップの表示] でバックアップを識別します。
2. Remove-AzSqlDatabaseLongTermRetentionBackup を使用してバックアップを削除します。

   # remove the earliest backup
   $ltrBackup = $ltrBackups[0]
   Remove-AzSqlDatabaseLongTermRetentionBackup -ResourceId $ltrBackup.ResourceId