PowerShell を使用して Azure Database for MySQL の読み取りレプリカを作成し、管理する方法

[アーティクル]
05/11/2023

適用対象: Azure Database for MySQL - シングルサーバー

重要

Azure Database for MySQL シングルサーバーは廃止パスにあります。 Azure Database for MySQL フレキシブルサーバーにアップグレードすることを強くお勧めします。 Azure Database for MySQL フレキシブルサーバーへの移行の詳細については、Azure Database for MySQL シングルサーバーの現状に関するページを参照してください

この記事では、PowerShell を使用して Azure Database for MySQL サービスの読み取りレプリカを作成および管理する方法を学習します。読み取りレプリカの詳細については、概要を参照してください。

Azure PowerShell

PowerShell を使用して、読み取りレプリカを作成して管理できます。

前提条件

このハウツーガイドを完了するには、次が必要です。

ローカルにインストールされた Az PowerShell モジュール、またはブラウザーの Azure Cloud Shell
Azure Database for MySQL サーバー

重要

Az.MySql PowerShell モジュールがプレビュー段階にある間は、次のコマンドを使用して、Az PowerShell モジュールとは別にこれをインストールする必要があります: Install-Module -Name Az.MySql -AllowPrerelease。 Az.MySql PowerShell モジュールは、一般提供された段階で将来の Az PowerShell モジュールリリースの一部となり、Azure Cloud Shell 内からネイティブに使用できるようになります。

PowerShell をローカルで使用する場合は、Connect-AzAccount コマンドレットを使用して Azure アカウントに接続します。

Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンドブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの [Cloud Shell] ボタンを選択します。

Azure Cloud Shell を使用するには、以下のようにします。

Cloud Shell を開始します。
コードブロック (またはコマンドブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードまたはコマンドを実行します。

重要

読み取りレプリカ機能は、汎用とメモリ最適化のどちらかの価格レベルにおける Azure Database for MySQL サーバーにのみ使用可能です。ソースサーバーがこれらの価格レベルのいずれであるかを確認します。

プライマリサーバーで GTID が有効になっている場合 (gtid_mode = ON)、新しく作成されたレプリカでも GTID が有効になり、GTID ベースのレプリケーションが使用されます。詳細については、「グローバルトランザクション識別子 (GTID)」を参照してください。

読み取りレプリカを作成します

重要

使用されているストレージ (v1 または v2) によっては、ソースサーバーに既存のレプリカサーバーが存在しない場合、レプリケーションに備えるためにソースサーバーの再起動が必要となる場合があります。サーバーの再起動を検討して、ピーク時間外にその操作を行ってください。詳細については、「ソースサーバーの再起動」を参照してください。

読み取りレプリカサーバーは、次のコマンドを使用して作成できます。

Get-AzMySqlServer -Name mydemoserver -ResourceGroupName myresourcegroup |
  New-AzMySqlReplica -Name mydemoreplicaserver -ResourceGroupName myresourcegroup

New-AzMySqlReplica コマンドには、次のパラメーターが必要です。

設定	値の例	説明
ResourceGroupName	myresourcegroup	レプリカサーバーが作成されるリソースグループ。
名前	mydemoreplicaserver	作成する新しいレプリカサーバーの名前。

リージョンをまたがる読み取りレプリカを作成するには、Location パラメーターを使用します。次の例では、米国西部リージョンにレプリカを作成します。

Get-AzMySqlServer -Name mrdemoserver -ResourceGroupName myresourcegroup |
  New-AzMySqlReplica -Name mydemoreplicaserver -ResourceGroupName myresourcegroup -Location westus

Note

レプリカを作成できるリージョンの詳細については、読み取りレプリカの概念に関する記事を参照してください。

既定では、Sku パラメーターが指定されていない限り、読み取りレプリカはソースと同じサーバー構成で作成されます。

Note

レプリカが確実にマスターに追随できるように、レプリカサーバーの構成をソースと同じかそれ以上の値にしておくことをお勧めします。

ソースサーバーのレプリカを一覧表示する

特定のソースサーバーのレプリカをすべて表示するには、次のコマンドを実行します。

Get-AzMySqlReplica -ResourceGroupName myresourcegroup -ServerName mydemoserver

Get-AzMySqlReplica コマンドには、次のパラメーターが必要です。

設定	値の例	説明
ResourceGroupName	myresourcegroup	レプリカサーバーを作成するリソースグループ。
ServerName	mydemoserver	ソースサーバーの名前または ID。

レプリカサーバーを削除します

読み取りレプリカサーバーを削除するには、Remove-AzMySqlServer コマンドレットを実行します。

Remove-AzMySqlServer -Name mydemoreplicaserver -ResourceGroupName myresourcegroup

ソースサーバーを削除する

重要

ソースサーバーを削除すると、すべてのレプリカサーバーへのレプリケーションを停止し、ソースサーバー自体を削除します。これでレプリカサーバーは、読み取りと書き込みの両方をサポートするスタンドアロンサーバーになります。

ソースサーバーを削除するには、Remove-AzMySqlServer コマンドレットを実行します。

Remove-AzMySqlServer -Name mydemoserver -ResourceGroupName myresourcegroup

既知の問題

汎用およびメモリ最適化レベルのサーバーで使用されるストレージには、General Purpose ストレージ v1 (最大 4 TB をサポート) と General Purpose ストレージ v2 (最大 16 TB のストレージをサポート) の 2 つの世代があります。ソースサーバーとレプリカサーバーでストレージの種類が同じである必要があります。 General Purpose ストレージ v2 は一部のリージョンでは使用できないため、読み取りレプリカ作成のために PowerShell で場所を使用するときは必ず、正しいレプリカリージョンを選択してください。ソースサーバーのストレージの種類を特定する方法については、サーバーが実行されているストレージの種類の判別方法に関するリンクを参照してください。

ソースサーバーの読み取りレプリカを作成できないリージョンを選択した場合、次の図に示すようにデプロイが実行を継続し、 "リソースプロビジョニング操作が、許可されているタイムアウト期間内に完了しませんでした。" というエラーでタイムアウトになる問題が発生します。

次のステップ

PowerShell を使用して Azure Database for MySQL サーバーを再起動する