Azure SQL データベースのメンテナンス期間を構成する

データベース、エラスティック プール、またはエラスティック プールを作成するときにメンテナンス期間を構成するには、[追加設定] ページで目的の [メンテナンス期間] を設定します。

1 つのデータベースまたはエラスティック プールを作成するときにメンテナンス期間を設定する

新しいデータベースまたはプールを作成する詳細な手順については、「Azure SQL Database の単一データベースを作成する」を参照してください。

次の例は、Azure PowerShell を使用してメンテナンス期間を構成する方法を示しています。 Azure PowerShell をインストールするか、Azure Cloud Shell を使用することができます。

Azure Cloud Shell を起動する

Azure Cloud Shell は無料のインタラクティブ シェルです。この記事の手順は、Azure Cloud Shell を使って実行することができます。 一般的な Azure ツールが事前にインストールされており、アカウントで使用できるように構成されています。

Cloud Shell を開くには、コード ブロックの右上隅にある [使ってみる] を選択します。 https://shell.azure.com に移動して、別のブラウザー タブで Cloud Shell を起動することもできます。

Cloud Shell が開いたら、環境で PowerShell が選択されていることを確認します。 以降のセッションでは、PowerShell 環境で Azure CLI を使用します。 [コピー] を選択してコードのブロックをコピーし、Cloud Shell に貼り付けます。その後、Enter キーを押してそれを実行します。

使用可能なメンテナンス期間を検出する

メンテナンス期間を設定する場合、リージョンごとに独自のメンテナンス期間オプションがあります。これは、データベースまたはプールを配置するリージョンのタイムゾーンに対応しています。

SQL Database とエラスティック プールのメンテナンス期間を検出する

次の例では、Get-AzMaintenancePublicConfiguration コマンドレットを使用して、eastus2 リージョンに使用できるメンテナンス期間を返します。 データベースおよびエラスティック プールの場合は、MaintenanceScope を SQLDB に設定します。

$location = "eastus2"

Write-Host "Available maintenance schedules in ${location}:"
$configurations = Get-AzMaintenancePublicConfiguration
$configurations | ?{ $_.Location -eq $location -and $_.MaintenanceScope -eq "SQLDB"}

単一データベースの作成時にメンテナンス期間を設定する

次の例では、New-AzSqlDatabase コマンドレットを使用して新しいデータベースを作成し、メンテナンス期間を設定します。 -MaintenanceConfigurationId には、データベースのリージョンの有効な値を設定する必要があります。 リージョンの有効な値を取得するには、「使用可能なメンテナンス期間を検出する」を参照してください。

 # Set variables for your database
 $resourceGroupName = "your_resource_group_name"
 $serverName = "your_server_name"
 $databaseName = "your_db_name"
 
 # Set selected maintenance window
 $maintenanceConfig = "SQL_EastUS2_DB_1"

 Write-host "Creating a standard-series (Gen5) 2 vCore database with maintenance window ${maintenanceConfig} ..."
 $database = New-AzSqlDatabase `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -DatabaseName $databaseName `
   -Edition GeneralPurpose `
   -ComputeGeneration Gen5 `
   -VCore 2 `
   -MaintenanceConfigurationId $maintenanceConfig
 $database

エラスティック プールの作成時にメンテナンス期間を設定する

次の例では、New-AzSqlElasticPool コマンドレットを使用して新しいエラスティック プールを作成し、メンテナンス期間を設定します。 メンテナンス期間がエラスティック プールに設定されるため、プール内のすべてのデータベースには、プールのメンテナンス期間スケジュールが設定されます。 -MaintenanceConfigurationId には、プールのリージョンの有効な値を設定する必要があります。 リージョンの有効な値を取得するには、「使用可能なメンテナンス期間を検出する」を参照してください。

 # Set variables for your pool
 $resourceGroupName = "your_resource_group_name"
 $serverName = "your_server_name"
 $poolName = "your_pool_name"
 
 # Set selected maintenance window
 $maintenanceConfig = "SQL_EastUS2_DB_2"

 Write-host "Creating a Standard 50 pool with maintenance window ${maintenanceConfig} ..."
 $pool = New-AzSqlElasticPool `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -ElasticPoolName $poolName `
   -Edition "Standard" `
   -Dtu 50 `
   -DatabaseDtuMin 10 `
   -DatabaseDtuMax 20 `
   -MaintenanceConfigurationId $maintenanceConfig
 $pool

次の例は、Azure CLI を使用してメンテナンス期間を構成する方法を示しています。 Azure CLI をインストールするか、または Azure Cloud Shell を使用することができます。

Azure Cloud Shell を起動する

Azure Cloud Shell は無料のインタラクティブ シェルです。この記事の手順は、Azure Cloud Shell を使って実行することができます。 一般的な Azure ツールが事前にインストールされており、アカウントで使用できるように構成されています。

Cloud Shell を開くには、コード ブロックの右上隅にある [使ってみる] を選択します。 https://shell.azure.com に移動して、別のブラウザー タブで Cloud Shell を起動することもできます。

Cloud Shell が開いたら、お使いの環境に対して Bash が選択されていることを確認します。 以降のセッションでは、Bash 環境で Azure CLI を使用します。 [コピー] を選択してコードのブロックをコピーし、Cloud Shell に貼り付けます。その後、Enter キーを押してそれを実行します。

Azure へのサインイン

Cloud Shell は、サインインした最初のアカウントで自動的に認証されます。 別のサブスクリプションを使用してサインインするには、次のスクリプトを使用し、<Subscription ID> をご使用の Azure サブスクリプション ID に置き換えます。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

詳細については、アクティブなサブスクリプションの設定または対話形式のサインインに関する記事を参照してください

使用可能なメンテナンス期間を検出する

メンテナンス期間を設定する場合、リージョンごとに独自のメンテナンス期間オプションがあります。これは、データベースまたはプールを配置するリージョンのタイムゾーンに対応しています。

SQL Database とエラスティック プールのメンテナンス期間を検出する

次の例では、az maintenance public-configuration list コマンドを使用して、eastus2 リージョンに使用できるメンテナンス期間を返します。 データベースおよびエラスティック プールの場合は、maintenanceScope を SQLDB に設定します。

location="eastus2"

az maintenance public-configuration list --query "[?location=='$location'&&contains(maintenanceScope,'SQLDB')]"

単一データベースの作成時にメンテナンス期間を設定する

次の例では、az sql db create コマンドを使用して新しいデータベースを作成し、メンテナンス期間を設定します。 --maint-config-id (または -m) には、データベースのリージョンの有効な値を設定する必要があります。 リージョンの有効な値を取得するには、「使用可能なメンテナンス期間を検出する」を参照してください。

 # Set variables for your database
 resourceGroupName="your_resource_group_name"
 serverName="your_server_name"
 databaseName="your_db_name"

 # Set selected maintenance window
 maintenanceConfig="SQL_EastUS2_DB_1"

 # Create database
 az sql db create \
   --resource-group $resourceGroupName \
   --server $serverName \
   --name $databaseName \
   --edition GeneralPurpose \
   --family Gen5 \
   --capacity 2 \
   --maint-config-id $maintenanceConfig

エラスティック プールの作成時にメンテナンス期間を設定する

次の例では、新しいエラスティック プールを作成し、az sql elastic-pool create コマンドレットを使用してメンテナンス期間を設定します。 メンテナンス期間がエラスティック プールに設定されるため、プール内のすべてのデータベースには、プールのメンテナンス期間スケジュールが設定されます。 --maint-config-id (または -m) には、プールのリージョンの有効な値を設定する必要があります。 リージョンの有効な値を取得するには、「使用可能なメンテナンス期間を検出する」を参照してください。

 # Set variables for your pool
 resourceGroupName="your_resource_group_name"
 serverName="your_server_name"
 poolName="your_pool_name"

 # Set selected maintenance window
 maintenanceConfig="SQL_EastUS2_DB_2"

 # Create elastic pool
 az sql elastic-pool create \
   --resource-group $resourceGroupName \
   --server $serverName \
   --name $poolName \
   --edition GeneralPurpose \
   --family Gen5 \
   --capacity 2 \
   --maint-config-id $maintenanceConfig

以降の手順では、Azure portal を使用して、既存のデータベースまたはエラスティック プールにメンテナンス期間を設定します。

既存のデータベースまたはエラスティック プールにメンテナンス期間を設定する

1. メンテナンス期間を設定する SQL データベースまたはエラスティック プールに移動します。

2. [設定] メニューで、 [メンテナンス] を選択し、目的のメンテナンス期間を選択します。

   

既存のデータベースのメンテナンス期間を設定する

次の例では、Set-AzSqlDatabase コマンドレットを使用して、既存のデータベースにメンテナンス期間を設定します。 -MaintenanceConfigurationId には、データベースのリージョンの有効な値を設定する必要があります。 リージョンの有効な値を取得するには、「使用可能なメンテナンス期間を検出する」を参照してください。

 # Select different maintenance window
 $maintenanceConfig = "SQL_EastUS2_DB_2"

 Write-host "Changing database maintenance window to ${maintenanceConfig} ..."
 $database = Set-AzSqlDatabase `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -DatabaseName $databaseName `
   -MaintenanceConfigurationId $maintenanceConfig
 $database

既存のエラスティック プールにメンテナンス期間を設定する

次の例では、Set-AzSqlElasticPool コマンドレットを使用して、既存のエラスティック プールにメンテナンス期間を設定します。 $maintenanceConfig 値がプールのリージョンの有効な値であることを確認することが重要です。 リージョンの有効な値を取得するには、「使用可能なメンテナンス期間を検出する」を参照してください。

 # Select different maintenance window
 $maintenanceConfig = "SQL_EastUS2_DB_1"
 
 Write-host "Changing pool maintenance window to ${maintenanceConfig} ..."
 $pool = Set-AzSqlElasticPool `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -ElasticPoolName $poolName `
   -MaintenanceConfigurationId $maintenanceConfig
 $pool

次の例は、Azure CLI を使用してメンテナンス期間を構成する方法を示しています。 Azure CLI をインストールするか、または Azure Cloud Shell を使用することができます。

既存のデータベースのメンテナンス期間を設定する

次の例では、az sql db update コマンドを使用して、既存のデータベースにメンテナンス期間を設定します。 --maint-config-id (または -m) には、データベースのリージョンの有効な値を設定する必要があります。 リージョンの有効な値を取得するには、「使用可能なメンテナンス期間を検出する」を参照してください。

 # Select different maintenance window
 maintenanceConfig="SQL_EastUS2_DB_2"

 # Update database
 az sql db update \
   --resource-group $resourceGroupName \
   --server $serverName \
   --name $databaseName \
   --maint-config-id $maintenanceConfig

既存のエラスティック プールにメンテナンス期間を設定する

次の例では、az sql elastic-pool update コマンドを使用して、既存のエラスティック プールにメンテナンス期間を設定します。 maintenanceConfig 値がプールのリージョンの有効な値であることを確認することが重要です。 リージョンの有効な値を取得するには、「使用可能なメンテナンス期間を検出する」を参照してください。

 # Select different maintenance window
 maintenanceConfig="SQL_EastUS2_DB_1"

 # Update pool
 az sql elastic-pool update \
   --resource-group $resourceGroupName \
   --server $serverName \
   --name $poolName \
   --maint-config-id $maintenanceConfig

1. 不要になった SQL データベースまたはエラスティック プールに移動します。
2. [概要] メニューで、リソースを削除するオプションを選択します。

# Delete database
Remove-AzSqlDatabase `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -DatabaseName $databaseName

# Delete elastic pool
Remove-AzSqlElasticPool `
   -ResourceGroupName $resourceGroupName `
   -ServerName $serverName `
   -ElasticPoolName $poolName

az sql db delete \
   --resource-group $resourceGroupName \
   --server $serverName \
   --name $databaseName

az sql elastic-pool delete \
   --resource-group $resourceGroupName \
   --server $serverName \
   --name $poolName