エラスティックジョブの作成、構成、および管理

[アーティクル]
04/03/2024

この記事では、Azure SQL Database のエラスティックジョブを作成、構成、および管理するために必要な手順について説明します。これらの手順の多くは Azure portal および T-SQL、PowerShell、REST API を使用して実行できます。エラスティックジョブを使用すると、複数のデータベースにわたって 1 つまたは複数の Transact-SQL (T-SQL) スクリプトを同時に実行できます。詳細については、「エラスティックジョブ (プレビュー) を使用して管理タスクを自動化する」または「エラスティックジョブの作成、構成、および管理 (プレビュー)」で詳細を確認してください。

エラスティックジョブエージェントの作成および構成

DTU 購入モデルを使用して、S1 以上で、中身が空の Azure SQL Database を作成または特定します。このデータベースは、ジョブエージェントと同じサーバーに存在する必要があります。このデータベースは、エラスティックジョブエージェントの作成時に ジョブデータベースとして使用されます。 Azure portal、PowerShell、Azure CLI (sql up) を使用して、単一データベースを作成できます。
Azure portal で、または PowerShell を使用してエラスティックジョブエージェントを作成します。

Azure portal でエラスティックジョブエージェントを作成する手順は次のとおりです。
1. Azure portal で、[Elastic Job agents] (Elastic Job エージェント) を検索します。 [作成] を選択して、新しいエラスティックジョブエージェントのリソースのプロビジョニングを開始します。またはこのリンクから、Azure portal で Elastic Job エージェントを作成します。
2. エラスティックジョブエージェント名を指定します。
3. エージェントのサブスクリプションとリソースグループを選択します。必要な場合は、新しいリソースグループを作成します。エラスティックジョブは、他のリソースグループ、サブスクリプション、さらには他の Azure リージョン内のデータベースをターゲットにすることができます。
4. エラスティックジョブエージェントのサーバーになる Azure SQL Database 論理サーバーを選択します。
5. エラスティックジョブエージェントのデータベースになる論理サーバーの Job データベースを選択します。検証により、データベースが適切であることが確認されます。
6. [サービスレベル] で、[JA 100] を選択します。
7. [Next: Identity] (次へ: ID) を選択します。
8. ジョブエージェントでターゲットサーバー/データベースに対する認証を行うには、2 つの方法があります。ユーザー割り当てマネージド ID (UMI) を使用した Microsoft Entra 認証、またはデータベーススコープの資格情報を使用する方法です。
  1. エラスティックジョブエージェントのプロビジョニングプロセスの外部で UMI を作成するか、既存の UMI を使用します。 [ユーザー割り当てマネージド ID の追加] を選択します。 UMI を選択します。 [追加] を選択します。
  2. データベーススコープの資格情報を使用する場合は、このチュートリアルの後半の手順を参照してください。
9. タグを選択します。
10. Azure タグの使用を検討します。たとえば、リソースを作成したユーザーを識別する "オーナー" タグまたは "CreatedBy" タグ、このリソースが稼働中、開発中であるかどうかを識別する Environment タグなどです。詳細については、「Azure リソースの名前付けおよびタグ付けの戦略を作成する」を参照してください。
11. [Review + create](レビュー + 作成) を選択します。
12. [確認と作成] ページで新しいエラスティックジョブエージェントの選択を確認し、[作成] を選択します。
13. ターゲットサーバー/データベースに対して認証を行うには、さらに次の手順が必要です。このチュートリアル記事の次のセクションの手順を続行してください。

ジョブエージェント認証を作成する

エラスティックジョブエージェントは、各ターゲットサーバーまたはデータベースに対して認証可能である必要があります。このセクションでは、エラスティックジョブエージェントでターゲットグループ内のサーバー/データベースに対して認証を行うために必要な手順について説明します。

ターゲットに対するエラスティックジョブエージェントの認証には、次の 2 つのオプションがあります。

ユーザー割り当てマネージド ID (UMI) にマップされたデータベースユーザーを使用して、ターゲットサーバー/データベースに対する認証を行います。
- Microsoft Entra 認証 (旧称 Azure Active Directory) で UMI を使用することをお勧めします。
各データベースのデータベーススコープの資格情報にマップされたデータベースユーザーを使用します。
- 以前は、データベーススコープの資格情報が、エラスティックジョブエージェントがターゲットに対して認証するための唯一のオプションでした。

ユーザー割り当てマネージド ID (UMI) による Microsoft Entra 認証を使用する

ユーザー割り当てマネージド ID (UMI) を使った Microsoft Entra (旧称 Azure Active Directory) 認証を使用します。これは、推奨されている認証方法です。

すべてのジョブターゲット論理サーバー/データベース、およびジョブ出力論理サーバーで、Microsoft Entra (旧称 Azure Active Directory) 認証を有効にします。
ユーザー割り当てマネージド ID (UMI) を作成するか、既存の UMI を使用します。
- Azure portal、Azure CLI、PowerShell、Resource Manager、または REST API を使用して、新しい UMI を作成できます。
作成したエラスティックジョブエージェントに UMI を割り当てます。
- エラスティックジョブエージェントの作成時に UMI を割り当てることをおすすめします。「エラスティックジョブエージェントの作成および構成」の手順を参照してください。 Azure portal でジョブエージェントを作成する際に、[ID] タブでエラスティックジョブエージェントに割り当てます。
- UMI を使用するように既存のエラスティックジョブエージェントを更新するには、エラスティックジョブエージェントの Azure portal ページで、リソースメニューにある [セキュリティ] メニューから [ID] に移動します。 UMI を選択してエラスティックジョブエージェントに割り当てます。
- New-AzSqlElasticJobAgent または Set-AzSqlElasticJobAgent PowerShell コマンドレットを使用してエラスティックジョブエージェントを作成または更新する場合は、次のパラメーターを使用します: -IdentityType UserAssigned -IdentityID <identity resource path>。例:
```
$parameters = @{
    Name = '<job agent name>'
    ResourceGroupName = '<Resource_Group_Name>'
    IdentityType = 'UserAssigned'
    IdentityID = '/subscriptions/fa58cf66-caaf-4ba9-875d-f1234/resourceGroups/<resource group name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<UMI name here>'
}
Set-AzSqlElasticJobAgent @parameters
```
- REST API を使用して、エラスティックジョブエージェントを作成または更新することもできます。
ターゲットグループを作成し、ジョブのターゲットを追加します。 PowerShell または T-SQL を使用して、ターゲットグループおよびターゲット (ジョブの実行の対象とするデータベース) を定義します。
各ターゲットサーバー/データベースで、T-SQL または PowerShell を使用して、UMI またはデータベーススコープの資格情報にマップされた包含ユーザーを作成します。
1. T-SQL を使用してジョブ認証を作成します。
2. PowerShell を使用してジョブ認証を作成します。
出力データベースで、アクセス許可を作成して UMI ジョブユーザーに割り当てます。出力データベースに接続し、jobuserUMI という名前のユーザーに対して次のスクリプトの例を実行します。
```
CREATE USER [jobuserUMI] FROM EXTERNAL PROVIDER; 
GO 
```
the @output_table_name argument の sp_add_jobstep 呼び出しで出力パラメーターが指定されている場合は、ジョブエージェント UMI またはデータベーススコープの資格情報に、その出力テーブルに CREATE TABLE および IN Standard Edition RT データへのアクセス許可を付与する必要があります。
```
GRANT CREATE TABLE TO [job_user];
GRANT SELECT,INSERT,UPDATE,DELETE ON [dbo].[output_table_name] TO job_user;
```
各ターゲットサーバー/データベースで、ジョブスクリプトを実行するために必要なアクセス許可をデータベースユーザーに付与します。これらのアクセス許可は、T-SQL クエリの要件によって異なります。

データベーススコープの資格情報を使用する

ジョブデータベースと各ターゲットサーバー/データベースで、認証にデータベーススコープの資格情報を使用できます。以前は、データベーススコープの資格情報がエラスティックジョブで使用できる唯一のオプションでした。

注意

UMI が Job Agent に割り当てられている場合、SQL 認証はターゲットへの接続には使用されません。 Job Agent は UMI を使用した Microsoft Entra 認証のみを使用して、すべてのターゲットデータベースに接続します。

ジョブデータベースにデータベーススコープの資格情報を作成します。
1. データベーススコープの資格情報の作成に PowerShell を使用する。
2. データベーススコープの資格情報の作成に T-SQL を使用する。
PowerShell を使用してターゲットグループ (ジョブの実行の対象とするデータベース)を定義するか、T-SQL を使用してターゲットを定義します。
ジョブを実行する各ターゲットデータベースに、ジョブエージェントのログイン/ユーザーを作成します。各ターゲットサーバー/データベースのログイン/ユーザーには、ジョブユーザーのデータベーススコープ資格情報の ID と同じ名前と、ジョブユーザーのデータベーススコープ資格情報と同じパスワードが必要です。
1. 資格情報とユーザーを各ターゲットデータベースに追加するには、PowerShell を使用します。
2. ユーザーの追加についての詳細は、「ログインとユーザーアカウントを使用してサーバーおよびデータベースへのアクセスを承認する」を参照してください。
出力データベースで、アクセス許可を作成してジョブユーザーに割り当てます。
1. 出力データベースをホストする論理サーバーの master データベースに接続します。まだ存在しない場合は、ジョブユーザーのデータベーススコープの資格情報の ID と同じ名前およびパスワードを使用して、SQL 認証ログインを作成します。
```
CREATE LOGIN [job_user] WITH PASSWORD '<same_password_as_database-scoped_credential>'
GO 
```
2. 出力データベースに接続し、job_user という名前のユーザーに対して次のスクリプトの例を実行します。
```
CREATE USER [job_user] FROM LOGIN [job_user]; 
GO 
```
3. @output_table_name 引数の sp_add_jobstep 呼び出しで出力パラメーターが指定されている場合、ジョブエージェント UMI またはデータベーススコープの資格情報には、その出力テーブルに CREATE TABLE および INSERT データを実行するアクセス許可が付与されている必要があります。
```
GRANT CREATE TABLE TO [job_user];
GRANT SELECT,INSERT,UPDATE,DELETE ON [dbo].[output_table_name] TO job_user;
```
各ターゲットサーバー/データベースで、ジョブスクリプトを実行するために必要なアクセス許可をデータベースユーザーに付与します。これらのアクセス許可は、T-SQL クエリの要件によって異なります。

ジョブの作成、実行、および管理

PowerShell または T-SQL を使用してジョブを作成します。
各エラスティックジョブにステップを追加します。ジョブステップごとにターゲットグループを選択する必要があります。 PowerShell または T-SQL を使用してジョブステップを追加します。
PowerShell または T-SQL を使用してジョブを実行します。
Azure portal を使用してジョブの実行状態を監視するか、PowerShell または T-SQL を使用してジョブを監視します。

Azure SQL エラスティックジョブのプライベートエンドポイントを構成する

各ターゲットサーバーには、サービス管理のプライベートエンドポイントを使用することで到達できます。また、Microsoft によって作成および管理され、エラスティックジョブでのみ使用できます。エラスティックジョブのプライベートエンドポイントを作成すると、エラスティックジョブとターゲットサーバーの間にプライベートリンクが確立されます。構成が完了すると、エラスティックジョブエージェントとターゲットサーバー間のすべての通信がプライベートエンドポイント経由で行われます。

構成は簡単です。この通信を有効にするには、目的のターゲットサーバーとジョブ出力サーバーごとにプライベートエンドポイントを作成する必要があります。

[Elastic job agent] (エラスティックジョブエージェント) ナビゲーションメニューの [セキュリティ] で、[プライベートエンドポイント] を選択します。
[サーバーの追加] を選択し、プライベートエンドポイントを作成します。
[プライベートエンドポイントの作成] ウィンドウを開きます。
1. Azure 内の任意の サブスクリプションからターゲットサーバーを選択できます。
2. そのサブスクリプション内のターゲットの Azure SQL Database 論理サーバーを選択します。
3. プライベートエンドポイント名を指定します。
[プライベートエンドポイントの作成] を選択します。デプロイには少し時間がかかります。すぐに、[プライベートエンドポイント] ページの [接続の状態] に [保留中] と表示されます。
Azure portal で、ターゲットの Azure SQL Database 論理サーバーに移動します。
そのターゲットの Azure SQL Database 論理サーバーの管理者として、[SQL サーバー] ナビゲーションメニューの [セキュリティ] で [ネットワーク] を選択します。
[プライベートアクセス] を選択します。
保留中のプライベートエンドポイント要求を承認します。
[プライベートエンドポイント] ページの [接続の状態] に [承認済み] と表示されます。これで、ジョブエージェントとそのターゲットの Azure SQL Database 論理サーバー内のデータベース、またはエラスティックプール間の通信は、サービス管理のプライベートエンドポイントを経由するようになります。
そのターゲットの Azure SQL Database 論理サーバーの管理者として、[SQL サーバー] ナビゲーションメニューの [セキュリティ] で [ネットワーク] を選択します。エラスティックジョブの目的でパブリックアクセスを有効にする必要はありません。

Azure Monitor を使用してジョブエージェントアラートを構成する

ジョブの実行状態に関する通知を受け取るエラスティックジョブエージェントのリソースに対して Azure Monitor アラートを構成します。たとえば、ユーザーが構成したアクショングループを使用して、ジョブの失敗/成功を通知できます。

エラスティックジョブエージェントアラートは、Azure portal、PowerShell、または REST API を使用して作成できます。

Azure portal を使用してエージェントアラートを作成する

Azure portal、Azure CLI、PowerShell、REST API を使用して、Azure Monitor アラートルールを作成します。エラスティックジョブのアラートルールは、Azure SQL Database などの他のアラートルールと同様に機能します。

Azure Portal で続行する場合:

エラスティックジョブエージェントの Azure portal のリソースメニューから、[監視] メニューに移動して [アラート] を選択します。
[Set up alert rules on this resource] (このリソースのアラートルールを設定) プロンプトで、[アラートルールの作成] を選択します。
[アラートルールの作成] ページで、[シグナルの選択] ページが開きます。エラスティックジョブメトリック [Elastic Jobs Executions Failed] (エラスティックジョブ実行失敗)、[Elastic Jobs Executions Successful] (エラスティックジョブ実行成功)、または [Elastic Jobs Executions Timed Out] (エラスティックジョブ実行タイムアウト) を選択します。
[アラートロジック] では、[しきい値]、[集計の種類]、[演算子]、[単位] は既定値のままにします。
[しきい値] を 0 に設定します。その他の設定は、既定値のままにしておきます。
[次へ: アクション] を選択します。
[アクショングループの作成] を選択するか、既存のアクショングループを選択します。
1. Azure portal で Azure Monitor アラートのアクショングループを作成し、エラーの際に管理者や開発者に電子メールを送信するなどの通知の設定を行います。
2. アラートのアクショングループをテストします。
[Next: Details](次へ: 詳細) を選択します。
プロジェクトの詳細として、サブスクリプションとリソースグループを指定します。
アラート通信のアラートルールの詳細を指定します。 アラートルール名を指定します。
[タグ] を選択し、このアラートの CreatedBy や Environment などのメタデータを指定します。
[確認および作成] を選択します。 ［作成］ を選択します Azure portal にアラートルールが表示されるまでには、数分かかる場合があります。
必要に応じて、Azure portal、Azure CLI、または PowerShell を使用して Azure Monitor のアラート処理ルールを作成します。アラート処理ルールを使用して、通知の非表示、または特定の種類のアラートに対する特定のアクションの適用など、アラートがトリガーされたときに何が起こるかを決定できます。

ジョブエージェントをスケーリングする

既定では、ジョブエージェントは JA100 で作成され、最大 100 件のエラスティックジョブを同時に実行できます。サービスレベルの変更は非同期操作であり、新しいサービスレベルはプロビジョニングの遅延後に使用可能になります。

エラスティックジョブエージェントの同時実行数が 100 を超える必要がある場合は、より高いサービスレベルを使用できます。「同時実行の容量レベル」を参照してください。現在、ジョブエージェントのサービスレベルは、Azure portal、PowerShell、または REST API を使用して変更できます。

同時実行ジョブでサービスレベルを超えると、サービスレベルの同時実行ジョブの制限を超えてジョブが開始される前に、キューの遅延が発生します。

Azure portal を使用してエラスティックジョブエージェントをスケーリングする

Azure portal で、[Elastic Job agents] (Elastic Job エージェント) ページに移動します。
[価格レベル]を選択するか、コンテキストメニューから [Scale Up/Down] (スケールアップ/スケールダウン) を選択します。
[サービスレベル] ドロップダウンリストから新しいサービスレベルを選択します。
コストのカードを確認します。
[更新] を選択します。

PowerShell を使用してエラスティックジョブエージェントをスケーリングする

Set-AzSqlElasticJobAgent のオプションパラメーター -ServiceObjective を使用して、新しいサービス目標を指定できます。次に例を示します。

$parameters = @{
    Name = '<job agent name>'
    ResourceGroupName = '<Resource_Group_Name>'
    ServiceObjective = 'JA200'
}
Set-AzSqlElasticJobAgent @parameters

REST API を使用してエラスティックジョブエージェントをスケーリングする

ジョブエージェント REST API を使用して、ジョブエージェントをスケーリングできます。次に例を示します。

{ 
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1", 
"name": "agent1", 
"type": "Microsoft.Sql/servers/jobAgents", 
"location": "southeastasia", 
"sku": {
"name": "JA100  ", 
"capacity": 100 
}, 
"properties": {  
"databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
}  
}

次の方法で共有

エラスティックジョブの作成、構成、および管理

エラスティックジョブエージェントの作成および構成

ジョブエージェント認証を作成する

ユーザー割り当てマネージド ID (UMI) による Microsoft Entra 認証を使用する

データベーススコープの資格情報を使用する

ジョブの作成、実行、および管理

Azure SQL エラスティックジョブのプライベートエンドポイントを構成する

Azure Monitor を使用してジョブエージェントアラートを構成する

Azure portal を使用してエージェントアラートを作成する

ジョブエージェントをスケーリングする

Azure portal を使用してエラスティックジョブエージェントをスケーリングする

PowerShell を使用してエラスティックジョブエージェントをスケーリングする

REST API を使用してエラスティックジョブエージェントをスケーリングする

フィードバック

その他のリソース

次の方法で共有

エラスティック ジョブの作成、構成、および管理

エラスティック ジョブ エージェントの作成および構成

ジョブ エージェント認証を作成する

ユーザー割り当てマネージド ID (UMI) による Microsoft Entra 認証を使用する

データベース スコープの資格情報を使用する

ジョブの作成、実行、および管理

Azure SQL エラスティック ジョブのプライベート エンドポイントを構成する

Azure Monitor を使用してジョブ エージェントアラートを構成する

Azure portal を使用してエージェントアラートを作成する

ジョブ エージェントをスケーリングする

Azure portal を使用してエラスティック ジョブ エージェントをスケーリングする

PowerShell を使用してエラスティック ジョブ エージェントをスケーリングする

REST API を使用してエラスティック ジョブ エージェントをスケーリングする

関連するコンテンツ

フィードバック

その他のリソース

エラスティックジョブの作成、構成、および管理

エラスティックジョブエージェントの作成および構成

ジョブエージェント認証を作成する

データベーススコープの資格情報を使用する

Azure SQL エラスティックジョブのプライベートエンドポイントを構成する

Azure Monitor を使用してジョブエージェントアラートを構成する

ジョブエージェントをスケーリングする

Azure portal を使用してエラスティックジョブエージェントをスケーリングする

PowerShell を使用してエラスティックジョブエージェントをスケーリングする

REST API を使用してエラスティックジョブエージェントをスケーリングする