このトピックでは、PolarDB for MySQL をすぐに使い始める方法について説明します。具体的には、クラスターの作成、ホワイトリストの設定、データベースアカウントの作成、クラスターへの接続方法を解説します。
チュートリアル
以下のいずれかの手順についてご質問がある場合は、その手順をクリックして詳細な手順をご確認ください。
1. クラスターの作成
PolarDB の [クイック購入] ページに移動して、最小限の構成で PolarDB for MySQL クラスターをすばやく作成します。 次の表のパラメーターを設定し、他のすべての設定にはデフォルト値を使用します。 詳細については、「カスタム構成でクラスターを作成する」をご参照ください。
|
パラメーター |
説明 |
|
課金方法 |
クラスターの 課金方法 を選択します。詳細については、「課金方法」をご参照ください。
|
|
リージョン |
クラスターをデプロイするリージョンを選択します。 説明
PolarDB クラスターと接続したい ECS インスタンスは、内部ネットワーク経由で通信するために同じリージョンにある必要があります。 |
|
データベースエンジン |
クラスターの データベースエンジン を選択します。
説明
クイック購入は MySQL 8.0 のみをサポートしています。別の MySQL バージョンを購入するには、左上隅の 購入 タブをクリックしてください。 |
|
プロダクトエディション |
クラスターの データベースエディション を選択します。
説明
|
|
ネットワークタイプ |
クラスターの VPC と vSwitch を設定します。 説明
|
|
デプロイモード (オプション) |
クラスターのノード数と高可用性モードを選択します。詳細については、「高可用性モード (ホットスタンバイクラスター)」をご参照ください。
説明
このオプションは、サブスクリプション および 従量課金 の 課金方法 でのみ利用可能です。 |
|
ノード仕様 |
実際の要件に基づいて、クラスターのコンピューティングノードタイプを選択します。他のタイプを購入する必要がある場合は、左上隅の 購入 タブを選択してください。 |
|
ストレージ容量 (オプション) |
クラスターのストレージ容量を設定します。 説明
このオプションは、課金方法 が サブスクリプション または 従量課金 で、かつ データベースエディション が Standard Edition の場合にのみ必須です。 |
2. ホワイトリストの設定
PolarDB コンソール に移動します。クラスターリスト リストで、対象クラスターの ID をクリックして詳細ページに移動します。構成・ amp; の管理 > ホワイトリスト を選択し、IP アドレスホワイトリストまたはセキュリティグループを追加します。詳細については、「クラスターのホワイトリスト設定」および「セキュリティグループの設定」をご参照ください。
-
ECS インスタンスを使用して PolarDB にアクセスし、ECS インスタンスと PolarDB クラスターが同じ VPC 内にある場合、VPC の CIDR ブロックをデフォルトグループに追加できます。
-
ECS インスタンスを使用して PolarDB にアクセスするが、ECS インスタンスと PolarDB クラスターが同じ VPC 内にない場合、ECS インスタンスのパブリック IP アドレスを新しい IP ホワイトリストグループに追加するか、ECS インスタンスのセキュリティグループをクラスターホワイトリストに追加できます。
-
オンプレミス環境から PolarDB にアクセスする場合、オンプレミス環境のパブリック IP アドレスを新しい IP ホワイトリストグループに追加します。
オンプレミス環境のパブリック IP アドレスを見つけるには、次のいずれかのコマンドを使用します:
-
Linux の場合:ターミナルを開き、
curl ifconfig.meコマンドを実行します。 -
Windows の場合:コマンドプロンプトを開き、
curl ip.meコマンドを実行します。 -
macOS の場合:ターミナルを開き、
curl ifconfig.meコマンドを実行します。
ローカルネットワークがプロキシを使用している場合、上記のコマンドで返される IP アドレスは実際のパブリック IP アドレスではない可能性があります。この場合、
0.0.0.0/0の CIDR ブロックを PolarDB クラスターのホワイトリストに追加できます。クラスターに接続した後、SHOW PROCESSLIST;コマンドを実行して実際のパブリック IP アドレスを取得し、それをクラスターホワイトリストに追加します。その後、0.0.0.0/0の CIDR ブロックをホワイトリストから削除します。xxx | aurora | 100.104.xxx.xxx:59236 | information_schema | Sleep | 47 | | NULL 268459868 | polardb_mysql_account | 47.94.74.xxx:39160 | NULL | Query | 0 | starting | SHOW PROCESSLIST -
-
0.0.0.0/0の CIDR ブロックは、どの IP アドレスからのアクセスも許可するため、重大なセキュリティリスクをもたらします。この CIDR ブロックは必要な場合にのみ追加してください。
3. データベースアカウントの作成
PolarDB コンソール に移動します。クラスターリスト リストで、対象クラスターの ID をクリックして詳細ページに移動します。構成・ amp; の管理 > アカウント管理 を選択してデータベースアカウントを作成します。詳細については、「データベースアカウントの作成と管理」をご参照ください。
データベースアカウントには、権限の異なる 高特権アカウント または 普通口座 があります。ニーズに最も適したアカウントタイプを作成してください。詳細については、「アカウント権限」をご参照ください。
4. クラスターエンドポイントの取得
PolarDB コンソール に移動します。クラスターリスト リストで、対象クラスターの ID をクリックして詳細ページに移動します。データベース接続 を選択してクラスターエンドポイントを取得します。詳細については、「エンドポイントの管理」をご参照ください。データベース接続 ページで、クラスターエンドポイント (推奨) セクションを見つけ、プライベートエンドポイントの横にある コピー をクリックします。
-
クラスターエンドポイント の使用を推奨します。デフォルトのポートは 3306 です。
-
アクセス環境に応じて、Internal Network または Internet エンドポイントを選択します。
-
ECS を使用して PolarDB にアクセスし、ECS と PolarDB が同じ VPC 内にある場合は、Internal Network を選択します。
-
オンプレミス環境から PolarDB クラスターにアクセスする場合は、Internet を選択します。パブリックエンドポイントを申請するには、右側の 申請する をクリックします。
-
-
Internet エンドポイントはインターネットを使用します。最適なパフォーマンスを得るために、Internet 経由で PolarDB クラスターにアクセスすることは避けてください。
-
Internal Network エンドポイントを使用して、バーチャルホストや Simple Application Server から PolarDB クラスターに接続することはできません。
5. クラスターへの接続
ニーズに合った接続方法を選択してください:
DMS を使用してクラスターに接続
DMS は Alibaba Cloud のグラフィカルなデータ管理サービスです。追加のツールをインストールすることなく、DMS で直接 PolarDB クラスターを管理できます。
PolarDB コンソール に移動します。クラスターリスト で、対象クラスターの ID をクリックしてクラスター詳細ページに移動します。ページの右上隅にある データベースにログイン をクリックします。

PolarDB for MySQL クラスターの データベースアカウント と データベースパスワード を入力し、ログイン をクリックします。

ログイン後、左側のナビゲーションウィンドウの ログイン済みインスタンス リストで PolarDB for MySQL クラスターを見つけます。

クライアントを使用してクラスターに接続
MySQL 互換の任意のクライアントを使用して PolarDB クラスターに接続できます。以下の例では MySQL Workbench 8.0.29 を使用します。
MySQL Workbench をダウンロードしてインストールします。
MySQL Workbench を開き、Database > Connect to Database を選択します。
接続情報を入力し、OK をクリックします。

パラメーター
説明
例
Hostname
pc-2***.rwlb.rds.aliyuncs.com
Port
データベースエンドポイントのポート番号。
説明デフォルトのポートは 3306 です。
3306
Username
polardb_mysql_user
Password
データベースアカウントのパスワード。
Pass***233
コマンドラインを使用してクラスターに接続
サーバーに MySQL クライアントがインストールされている場合、次のコマンドを実行して PolarDB for MySQL クラスターに接続します。
構文:
mysql -h<endpoint> -P<port> -u<database_username> -p<database_user_password>例:
mysql -h pc-2***.rwlb.rds.aliyuncs.com -P3306 -upolardb_mysql_user -pPass***233パラメーター | 説明 | 例 |
-h | pc-2***.rwlb.rds.aliyuncs.com | |
-P | データベースエンドポイントのポート番号。 説明
| 3306 |
-u | polardb_mysql_user | |
-p | データベースアカウントのパスワード。 説明 このパラメーターは必須です。
| Pass***233 |
アプリケーションを使用してクラスターに接続
PolarDB for MySQL クラスターへの接続は、任意の MySQL データベースへの接続と同じです。エンドポイント、ポート、アカウント、パスワードを、ご利用の PolarDB クラスターの値に置き換えてください。以下に言語別の例を示します:
Java
Maven プロジェクトで MySQL JDBC ドライバーを使用して PolarDB for MySQL クラスターに接続します。
pom.xml ファイルに MySQL JDBC ドライバーの依存関係を追加します:
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.27</version> </dependency>クラスターに接続します。
<HOST>、<USER>、<PASSWORD>、<DATABASE>、<YOUR_TABLE_NAME>、および<YOUR_TABLE_COLUMN_NAME>を実際の値に置き換えてください。import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.Statement; public class DatabaseConnection { public DatabaseConnection() { } public static void main(String[] args) { // 接続するデータベースのエンドポイント、ポート、および名前。 String url = "jdbc:mysql://<HOST>:3306/<DATABASE>?useSSL=false&serverTimezone=UTC"; // データベースアカウント。 String user = "<USER>"; // データベースアカウントのパスワード。 String password = "<PASSWORD>"; try { Class.forName("com.mysql.cj.jdbc.Driver"); Connection conn = DriverManager.getConnection(url, user, password); Statement stmt = conn.createStatement(); // 取得するデータテーブルの名前。 ResultSet rs = stmt.executeQuery("SELECT * FROM `<YOUR_TABLE_NAME>`"); while(rs.next()) { // 取得するデータテーブルの列名。 System.out.println(rs.getString("<YOUR_TABLE_COLUMN_NAME>")); } rs.close(); stmt.close(); conn.close(); } catch (Exception var7) { var7.printStackTrace(); } } }
Python
Python 3 で PyMySQL ライブラリを使用して PolarDB for MySQL クラスターに接続します。
PyMySQL ライブラリをインストールします:
pip3 install PyMySQLクラスターに接続します。
<HOST>、<USER>、<PASSWORD>、<DATABASE>、および<YOUR_TABLE_NAME>を実際の値に置き換えてください。import pymysql # データベース接続パラメーター host = '<HOST>' # PolarDB クラスターのエンドポイント port = 3306 # デフォルトのポートは 3306 user = '<USER>' # データベースアカウント password = '<PASSWORD>' # データベースアカウントのパスワード database = '<DATABASE>' # 接続するデータベースの名前 try: # データベース接続を作成 connection = pymysql.connect( host=host, port=port, user=user, passwd=password, db=database ) # カーソルを取得 with connection.cursor() as cursor: # SQL クエリを実行 sql = "SELECT * FROM `<YOUR_TABLE_NAME>`" # 取得するデータテーブルの名前 cursor.execute(sql) # クエリ結果を取得 results = cursor.fetchall() for row in results: print(row) finally: # データベース接続を閉じる if 'connection' in locals() and connection.open: connection.close()
Go
database/sql パッケージと go-sql-driver/mysql ドライバー (Go 1.23.0) を使用して PolarDB for MySQL クラスターに接続します。
go-sql-driver/mysqlドライバーをインストールします:go get -u github.com/go-sql-driver/mysqlクラスターに接続します。
<HOST>、<USER>、<PASSWORD>、<DATABASE>、および<YOUR_TABLE_NAME>を実際の値に置き換えてください。package main import ( "database/sql" "fmt" "log" _ "github.com/go-sql-driver/mysql" ) func main() { // データベース接続パラメーター dbHost := "<HOST>" // PolarDB クラスターのエンドポイント dbPort := "3306" // デフォルトのポートは 3306 dbUser := "<USER>" // データベースアカウント dbPass := "<PASSWORD>" // データベースアカウントのパスワード dbName := "<DATABASE>" // 接続するデータベースの名前 // データソース名 (DSN) を構築 dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local", dbUser, dbPass, dbHost, dbPort, dbName) // データベース接続を開く db, err := sql.Open("mysql", dsn) if err != nil { log.Fatalf("データベースへの接続に失敗しました: %v", err) } defer db.Close() // 接続をテスト err = db.Ping() if err != nil { log.Fatalf("データベースへの PING に失敗しました: %v", err) } // カーソルを作成 var result string err = db.QueryRow("SELECT VERSION()").Scan(&result) if err != nil { log.Fatalf("クエリの実行に失敗しました: %v", err) } // データベースのバージョンを出力 fmt.Printf("データベースに接続しました、バージョン: %s\n", result) // SQL クエリを実行 rows, err := db.Query("SELECT * FROM `<YOUR_TABLE_NAME>`") // 取得するデータテーブルの名前 if err != nil { log.Fatalf("クエリの実行に失敗しました: %v", err) } defer rows.Close() }
クラスター管理
|
ノード管理 |
クラスター仕様 |
高可用性 |
バックアップと復元 |
|
PolarProxy |
モニタリングと最適化 |
バージョン管理 |
バイナリログ管理 |
よくある質問
ECS から PolarDB への接続が失敗する
次のようにトラブルシューティングを行ってください:
PolarDB クラスターが 実行中 の状態であることを確認します。
データベースエンドポイント、ポート、アカウント、パスワードが正しいことを確認します。データベースエンドポイントとポートの取得。
ECS インスタンスから
ping <database endpoint>またはtelnet <database endpoint> <port>を使用してネットワーク接続をテストします。プライベートネットワーク エンドポイントを使用している場合:
ECS インスタンスと PolarDB クラスターが同じ VPC 内にあるかどうかを確認します。同じ VPC 内にない場合、プライベートネットワーク エンドポイントは使用できません。ECS インスタンスと PolarDB クラスターを同じ VPC に配置するには、次のいずれかのソリューションを使用します:
ECS インスタンスの VPC を切り替えます。
ご利用のクラスターが Cluster Edition クラスター の場合、クラスターの VPC を切り替える ことができます。
Cloud Enterprise Network (CEN) を使用して、同じリージョン内の VPC 間の通信 を有効にします。
ECS インスタンスのプライベート IP アドレス、IP アドレス範囲、またはセキュリティグループが クラスターホワイトリスト に追加されているかどうかを確認します。
パブリックネットワーク エンドポイントを使用している場合、ECS インスタンスのパブリック IP アドレスまたはセキュリティグループが クラスターホワイトリスト に追加されているかどうかを確認します。
バーチャルホストおよび Simple Application Server は、プライベートネットワーク エンドポイントを介して PolarDB に接続できません。
オンプレミスから PolarDB への接続が失敗する
次のようにトラブルシューティングを行ってください:
PolarDB クラスターが 実行中 の状態であることを確認します。
データベースエンドポイント、ポート、アカウント、パスワードが正しいことを確認します。データベースエンドポイントとポートの取得。
説明データベースエンドポイントは パブリックネットワーク エンドポイントである必要があります。PolarDB クラスターと同じ VPC 内にある ECS インスタンスを使用している場合は、プライベートネットワーク エンドポイントを使用できます。
オンプレミス環境から
ping <database endpoint>またはtelnet <database endpoint> <port>を使用してネットワーク接続をテストします。オンプレミス環境のパブリック IP アドレスまたは IP アドレス範囲が クラスターホワイトリスト に追加されているかどうかを確認します。
パブリック IP アドレスを取得します:
Linux オペレーティングシステム:ターミナルを開き、
curl ifconfig.meコマンドを実行します。Windows オペレーティングシステム:コマンドプロンプトを開き、
curl ip.meコマンドを実行します。macOS オペレーティングシステム:ターミナルを開き、
curl ifconfig.meコマンドを実行します。
オンプレミスのネットワーク環境がプロキシサーバーを使用しているか、または同様の構成がある場合、上記の方法で取得した IP アドレスは実際のパブリック IP アドレスではない可能性があります。IP アドレス範囲
0.0.0.0/0を PolarDB クラスターのホワイトリストに追加できます。クラスターに正常に接続した後、SHOW PROCESSLIST;コマンドを実行して実際のパブリック IP アドレスを取得し、それをクラスターホワイトリストに追加します。その後、IP アドレス範囲0.0.0.0/0をホワイトリストから削除します。
「Access denied for user 'xxx'@'xxx' (using password: YES)」というエラーで PolarDB クラスターに接続できない
データベースアカウントまたはパスワードが正しくありません。PolarDB コンソール に移動し、設定と管理 > アカウント管理 ページで認証情報を確認またはリセットしてください。
「Unknown MySQL server host 'xxx'」というエラーで PolarDB クラスターに接続できない
データベースエンドポイントが正しくありません。正しい形式は pc-xxxxxx.rwlb.rds.aliyuncs.com です。PolarDB コンソール に移動し、基本情報 > データベース接続 セクションでエンドポイントを確認してください。
「Can't connect to MySQL server on 'xxx'」または「Connection timed out」というエラーで PolarDB クラスターに接続できない
ご利用の環境のパブリック IP アドレスまたは IP アドレス範囲が PolarDB クラスターのホワイトリストに含まれていないか、入力した IP アドレスが間違っている可能性があります。
パブリック IP アドレスを取得します:
Linux オペレーティングシステム:ターミナルを開き、
curl ifconfig.meコマンドを実行します。Windows オペレーティングシステム:コマンドプロンプトを開き、
curl ip.meコマンドを実行します。macOS オペレーティングシステム:ターミナルを開き、
curl ifconfig.meコマンドを実行します。
オンプレミスのネットワーク環境がプロキシサーバーを使用しているか、または同様の構成がある場合、上記の方法で取得した IP アドレスは実際のパブリック IP アドレスではない可能性があります。IP アドレス範囲 0.0.0.0/0 を PolarDB クラスターのホワイトリストに追加できます。クラスターに正常に接続した後、SHOW PROCESSLIST; コマンドを実行して実際のパブリック IP アドレスを取得し、それをクラスターホワイトリストに追加します。その後、IP アドレス範囲 0.0.0.0/0 をホワイトリストから削除します。
