チュートリアル: Azure CLI を使用して Azure Database for MySQL を設計する

[アーティクル]
06/01/2023

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

重要

Azure Database for MySQL の単一サーバーは提供終了パスにあります。 Azure Database for MySQL フレキシブルサーバーにアップグレードすることを強くお勧めします。 Azure Database for MySQL フレキシブルサーバーへの移行の詳細については、「Azure Database for MySQL 単一サーバーの動作」を参照してください。

Azure Database for MySQL は、Microsoft クラウドにおける、MySQL Community Edition のデータベースエンジンをベースとしたリレーショナルデータベースサービスです。このチュートリアルでは、Azure CLI (コマンドラインインターフェイス) とその他のユーティリティを使用して、次のことを行う方法を説明します。

Azure Database for MySQL の作成
サーバーのファイアウォールの構成
mysql コマンドラインツールを使用したデータベースの作成
サンプルデータを読み込む
クエリデータ
データの更新
データの復元

Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

前提条件

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 を実行します。

この記事では、Azure CLI のバージョン 2.0 以降が必要です。 Azure Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。

複数のサブスクリプションをお持ちの場合は、リソースが存在するか、課金の対象となっている適切なサブスクリプションを選択してください。 az account set コマンドを使用して、アカウントの特定のサブスクリプション ID を選択します。

az account set --subscription 00000000-0000-0000-0000-000000000000

リソースグループを作成する

az group create コマンドで Azure リソースグループを作成します。リソースグループとは、複数の Azure リソースをまとめてデプロイ、管理する際の論理コンテナーです。

次の例では、westus の場所に myresourcegroup という名前のリソースグループを作成します。

az group create --name myresourcegroup --location westus

Azure Database for MySQL サーバーの作成

az mysql server create コマンドを使用して、Azure Database for MySQL サーバーを作成します。 1 つのサーバーで複数のデータベースを管理できます。通常は、プロジェクトまたはユーザーごとに個別のデータベースを使用します。

次の例は、westus にあるリソースグループ myresourcegroup に、mydemoserver という名前の Azure Database for MySQL サーバーを作成します。サーバーの管理者ユーザーの名前は myadmin です。これは、2 個の仮想コアを備えた General Purpose Gen 5 サーバーです。 <server_admin_password> は独自の値に置き換えます。

az mysql server create --resource-group myresourcegroup --name mydemoserver --location westus --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen5_2 --version 5.7

sku-name パラメーターの値は、次の例のように、{価格レベル}_{コンピューティング世代}_{仮想コア数} という規約に従います。

--sku-name B_Gen5_2 は、"Basic、Gen 5、および 2 個の仮想コア" にマップされます。
--sku-name GP_Gen5_32 は、"汎用、Gen 5、および 32 個の仮想コア" にマップされます。
--sku-name MO_Gen5_2 は、"メモリ最適化、Gen 5、および 2 個の仮想コア" にマップされます。

リージョンごとおよびレベルごとに有効な値を理解するには、価格レベルのドキュメントを参照してください。

重要

ここで指定するサーバー管理者のログイン名とパスワードは、このクイックスタートの後半でサーバーとそのデータベースにログインするために必要です。後で使用するために、この情報を覚えておくか、記録しておきます。

ファイアウォール規則の構成

az mysql server firewall-rule create コマンドで、Azure Database for MySQL サーバーレベルのファイアウォール規則を作成します。サーバーレベルのファイアウォール規則により、mysql コマンドラインツールや MySQL Workbench などの外部アプリケーションが、Azure MySQL service ファイアウォールを経由してサーバーに接続できるようになります。

次の例では、特定の IP アドレス 192.168.0.1 からの接続を許可する、AllowMyIP と呼ばれるファイアウォール規則を作成しています。実際の接続元となる場所に対応する IP アドレスまたは IP アドレスの範囲に置き換えてください。

az mysql server firewall-rule create --resource-group myresourcegroup --server mydemoserver --name AllowMyIP --start-ip-address 192.168.0.1 --end-ip-address 192.168.0.1

接続情報の取得

サーバーに接続するには、ホスト情報とアクセス資格情報を提供する必要があります。

az mysql server show --resource-group myresourcegroup --name mydemoserver

結果は JSON 形式です。 fullyQualifiedDomainName と administratorLogin の値を書き留めておきます。

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "fullyQualifiedDomainName": "mydemoserver.mysql.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforMySQL/servers/mydemoserver",
  "location": "westus",
  "name": "mydemoserver",
  "resourceGroup": "myresourcegroup",
 "sku": {
    "capacity": 2,
    "family": "Gen5",
    "name": "GP_Gen5_2",
    "size": null,
    "tier": "GeneralPurpose"
  },
  "sslEnforcement": "Enabled",
  "storageProfile": {
    "backupRetentionDays": 7,
    "geoRedundantBackup": "Disabled",
    "storageMb": 5120
  },
  "tags": null,
  "type": "Microsoft.DBforMySQL/servers",
  "userVisibleState": "Ready",
  "version": "5.7"
}

mysql を使用してサーバーに接続する

mysql コマンドラインツールを使用して、Azure Database for MySQL サーバーへの接続を確立します。この例では、コマンドは次のようになります。

mysql -h mydemoserver.mysql.database.azure.com -u myadmin@mydemoserver -p

空のデータベースの作成

サーバーに接続したら、空のデータベースを作成します。

mysql> CREATE DATABASE mysampledb;

プロンプトで次のコマンドを実行し、新しく作成したデータベースに接続を切り替えます。

mysql> USE mysampledb;

データベースのテーブルを作成する

Azure Database for MySQL データベースに接続する方法を説明したので、次はいくつかの基本的なタスクを実行します。

最初に、テーブルを作成してデータを読み込みます。インベントリ情報を格納するテーブルを作成しましょう。

CREATE TABLE inventory (
	id serial PRIMARY KEY, 
	name VARCHAR(50), 
	quantity INTEGER
);

テーブルにデータを読み込む

テーブルを作成したので、次はデータを挿入します。開いているコマンドプロンプトウィンドウで、次のクエリを実行してデータ行を挿入します。

INSERT INTO inventory (id, name, quantity) VALUES (1, 'banana', 150); 
INSERT INTO inventory (id, name, quantity) VALUES (2, 'orange', 154);

これで、先ほど作成したテーブルにサンプルデータが 2 行挿入されました。

クエリを実行し、テーブル内のデータを更新する

次のクエリを実行して、データベーステーブルから情報を取得します。

SELECT * FROM inventory;

さらに、テーブル内のデータを更新することもできます。

UPDATE inventory SET quantity = 200 WHERE name = 'banana';

データを取得するとき、それに応じてデータ行が更新されます。

SELECT * FROM inventory;

データベースを以前の状態に復元する

テーブルを誤って削除した場合を想定してください。データの復元は容易なことではありません。 Azure Database for MySQL では、過去最長 35 日間における任意の時点に戻り、新しいデータベースに過去のデータを復元することができます。この新しいサーバーを使用して、削除されたデータを復元することができます。次の手順を実行して、テーブルを追加する前の状態にサンプルデータベースを復元します。

復元するには、次の情報が必要です。

復元ポイント: サーバーが変更される前の日時を選択します。ソースデータベースの最も古いバックアップと同じか、それよりも前の値にする必要があります。
対象サーバー: 復元先の新しいサーバー名を指定します。
ソースサーバー: 復元するサーバーの名前を指定します。
場所: リージョンを選択することはできません。既定では、ソースサーバーと同じ場所になります。

az mysql server restore --resource-group myresourcegroup --name mydemoserver-restored --restore-point-in-time "2017-05-4 03:10" --source-server-name mydemoserver

az mysql server restore コマンドには、次のパラメーターが必要です。

設定	提案された値	説明
resource-group	myresourcegroup	ソースサーバーが存在するリソースグループ。
name	mydemoserver-restored	復元コマンドで作成される新しいサーバーの名前。
restore-point-in-time	2017-04-13T13:59:00Z	復元する特定の時点を選びます。この日付と時刻は、ソースサーバーのバックアップ保有期間内でなければなりません。 ISO8601 の日時形式を使います。たとえば、ローカルなタイムゾーン (例: `2017-04-13T05:59:00-08:00`) または UTC Zulu 形式 (例: `2017-04-13T13:59:00Z`) を使うことができます。
source-server	mydemoserver	復元元のソースサーバーの名前または ID。

特定の時点にサーバーを復元すると、新しいサーバーが作成され、指定した時点の元のサーバーとしてコピーされます。復元されたサーバーの場所と価格レベルの値は、元のサーバーと同じです。

コマンドは同期的であり、サーバーが復元された後に戻ります。復元が終了した後、作成された新しいサーバーを調べます。データが期待どおりに復元されたことを確認します。

リソースをクリーンアップする

これらのリソースが別のクイックスタート/チュートリアルで不要である場合、次のコマンドで削除することができます。

az group delete --name myresourcegroup

新しく作成した 1 つのサーバーを削除するだけの場合は、az mysql server delete コマンドを実行してください。

az mysql server delete --resource-group myresourcegroup --name mydemoserver

次のステップ

このチュートリアルで学習した内容は次のとおりです。

Azure Database for MySQL サーバーの作成
サーバーのファイアウォールの構成
mysql コマンドラインツールを使用したデータベースの作成
サンプルデータを読み込む
クエリデータ
データの更新
データの復元

Azure Database for MySQL - Azure CLI サンプル