PowerShell による Always On 可用性グループの作成

適用対象:SQL Server

このトピックでは、 SQL Serverの Always On 可用性グループを PowerShell コマンドレットで作成および構成する方法について説明します。 可用性グループ は、1 つのまとまりとしてフェールオーバーする一連のユーザーデータベースと、フェールオーバーをサポートする一連のフェールオーバーパートナー ( 可用性レプリカ) を定義します。

注

可用性グループの概要については、「Always On 可用性グループとは (SQL Server)」を参照してください。

注

PowerShell のコマンドレットの代わりに、可用性グループの作成ウィザードや Transact-SQL を使用する方法もあります。詳細については、「[新しい可用性グループ] ダイアログボックスの使用 (SQL Server Management Studio)」または「可用性グループの作成 (Transact-SQL)」を参照してください。

はじめに

前提条件、制限事項、および推奨事項

可用性グループを作成する前に、 SQL Server の各ホストインスタンスが、同じ Windows Server Failover Clustering (WSFC) フェールオーバークラスタリングのそれぞれ異なる WSFC ノードに存在していることを確認します。また、使用するサーバーインスタンスが、他のサーバーインスタンスの前提条件を満たしていることと、他の Always On 可用性グループの要件がすべて満たされていること、さらに、自分自身も推奨事項を認識していることを確認してください。詳細については、「Always On 可用性グループの前提条件、制限事項、および推奨事項 (SQL Server)」を参照することを強くお勧めします。

アクセス許可

sysadmin 固定サーバーロールのメンバーシップと、CREATE AVAILABILITY GROUP サーバー権限、ALTER ANY AVAILABILITY GROUP 権限、または CONTROL SERVER 権限が必要です。

PowerShell を使用した可用性グループの作成と構成

次の表は、可用性グループの構成に伴う基本的な作業の一覧です。一覧には PowerShell コマンドレットによってサポートされる作業が示されています。 Always On 可用性グループに関連したこれらの作業は、この表に示されている順に実行する必要があります。

タスク	PowerShell コマンドレット (利用可能な場合) または Transact SQL ステートメント	タスクを実行する場所
データベースミラーリングエンドポイントを作成する ( SQL Server インスタンスごとに 1 回)	New-SqlHadrEndPoint	データベースミラーリングエンドポイントが欠落している各サーバーインスタンスで実行します。既存のデータベースミラーリングエンドポイントに変更を加えるには、Set-SqlHadrEndpoint を使用します。
可用性グループを作成する	まず、 New-SqlAvailabilityReplica コマンドレットに -AsTemplate パラメーターを指定し、可用性グループに追加する予定の 2 つの可用性レプリカのそれぞれについて、インメモリの可用性レプリカオブジェクトを作成します。次に、 New-SqlAvailabilityGroup コマンドレットを使用し、可用性レプリカオブジェクトを参照して、可用性グループを作成します。	初期プライマリレプリカをホストするサーバーインスタンスで実行します。
セカンダリレプリカを可用性グループに参加させる	Join-SqlAvailabilityGroup	セカンダリレプリカをホストする各サーバーインスタンスで実行します。
セカンダリデータベースを準備する	Backup-SqlDatabase と Restore-SqlDatabase	プライマリレプリカをホストするサーバーインスタンスでバックアップを作成します。セカンダリレプリカをホストする各サーバーインスタンス上で、 NoRecovery 復元パラメーターを使用してバックアップを復元します。プライマリレプリカをホストするコンピューターとターゲットセカンダリレプリカをホストするコンピューターとでファイルパスが異なる場合は、 RelocateFile 復元パラメーターも使用します。
各セカンダリデータベースを可用性グループに参加させてデータ同期を開始する	Add-SqlAvailabilityDatabase	セカンダリレプリカをホストする各サーバーインスタンスで実行します。

注

特定のタスクを実行するには、示されているサーバーインスタンス (1 つまたは複数) にディレクトリを変更します (cd)。

PowerShell の使用

SQL Server PowerShell プロバイダーを設定して使用します。

注

特定のコマンドレットの構文や例を表示するには、 PowerShell 環境で Get-Help SQL Server コマンドレットを使用します。詳細については、「 Get Help SQL Server PowerShell」を参照してください。

プライマリレプリカをホストするサーバーインスタンスにディレクトリを変更 (cd) します。
プライマリレプリカ用に、可用性レプリカのインメモリオブジェクトを作成します。
セカンダリレプリカごとにインメモリの可用性レプリカオブジェクトを作成します。
可用性グループを作成します。

注

可用性グループ名の最大文字数は 128 文字です。
新しいセカンダリレプリカを、可用性グループに参加させます。可用性グループへのセカンダリレプリカの参加 (SQL Server) に関する記事を参照してください。
可用性グループ内のデータベースごとに、 WITH NORECOVERY を使用して、プライマリデータベースの最近のバックアップを復元してセカンダリデータベースを作成します。
すべての新しいセカンダリデータベースを、可用性グループに参加させます。可用性グループへのセカンダリレプリカの参加 (SQL Server) に関する記事を参照してください。
(省略可能) Windows の dir コマンドを使用して、新しい可用性グループの内容を確認します。

注

複数のサーバーインスタンスの SQL Server サービスアカウントが、それぞれ異なるドメインユーザーアカウントで実行されている場合、それぞれのサーバーインスタンス上に、もう一方のサーバーインスタンス用のログインを作成し、そのログインにローカルのデータベースミラーリングエンドポイントへの CONNECT 権限を付与します。

例

以下の PowerShell スクリプトは、2 つの可用性レプリカと 1 つの可用性データベースから成る <myAvailabilityGroup> という名前の単純な可用性グループを作成、構成する例です。この例では、次の処理を実行します。

<myDatabase> とそのトランザクションログをバックアップします。
<myDatabase> とそのトランザクションログを -NoRecovery オプションを使用して復元します。
SQL Server のローカルインスタンス (名前は PrimaryComputer\Instance) によってホストされるプライマリレプリカのメモリ内表現を作成します。
SQL Server のインスタンス (名前は SecondaryComputer\Instance) によってホストされるセカンダリレプリカのメモリ内表現を作成します。
<myAvailabilityGroup>という名前の可用性グループを作成します。
セカンダリレプリカを可用性グループに追加します。
セカンダリデータベースを可用性グループに参加させます。

# Backup my database and its log on the primary  
Backup-SqlDatabase `  
    -Database "<myDatabase>" `  
    -BackupFile "\\share\backups\<myDatabase>.bak" `  
    -ServerInstance "PrimaryComputer\Instance"  
  
Backup-SqlDatabase `  
    -Database "<myDatabase>" `  
    -BackupFile "\\share\backups\<myDatabase>.log" `  
    -ServerInstance "PrimaryComputer\Instance" `  
    -BackupAction Log   
  
# Restore the database and log on the secondary (using NO RECOVERY)  
Restore-SqlDatabase `  
    -Database "<myDatabase>" `  
    -BackupFile "\\share\backups\<myDatabase>.bak" `  
    -ServerInstance "SecondaryComputer\Instance" `  
    -NoRecovery  
  
Restore-SqlDatabase `  
    -Database "<myDatabase>" `  
    -BackupFile "\\share\backups\<myDatabase>.log" `  
    -ServerInstance "SecondaryComputer\Instance" `  
    -RestoreAction Log `  
    -NoRecovery  
  
# Create an in-memory representation of the primary replica.  
$primaryReplica = New-SqlAvailabilityReplica `  
    -Name "PrimaryComputer\Instance" `  
    -EndpointURL "TCP://PrimaryComputer.domain.com:5022" `  
    -AvailabilityMode "SynchronousCommit" `  
    -FailoverMode "Automatic" `  
    -Version 12 `  
    -AsTemplate  
  
# Create an in-memory representation of the secondary replica.  
$secondaryReplica = New-SqlAvailabilityReplica `  
    -Name "SecondaryComputer\Instance" `  
    -EndpointURL "TCP://SecondaryComputer.domain.com:5022" `  
    -AvailabilityMode "SynchronousCommit" `  
    -FailoverMode "Automatic" `  
    -Version 12 `  
    -AsTemplate  
  
# Create the availability group  
New-SqlAvailabilityGroup `  
    -Name "<myAvailabilityGroup>" `  
    -Path "SQLSERVER:\SQL\PrimaryComputer\Instance" `  
    -AvailabilityReplica @($primaryReplica,$secondaryReplica) `  
    -Database "<myDatabase>"  
  
# Join the secondary replica to the availability group.  
Join-SqlAvailabilityGroup -Path "SQLSERVER:\SQL\SecondaryComputer\Instance" -Name "<myAvailabilityGroup>"  
  
# Join the secondary database to the availability group.  
Add-SqlAvailabilityDatabase -Path "SQLSERVER:\SQL\SecondaryComputer\Instance\AvailabilityGroups\<myAvailabilityGroup>" -Database "<myDatabase>"

参照

データベースミラーリングエンドポイント (SQL Server)
Always On 可用性グループの概要 (SQL Server)

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-01-02