すべてのプロダクト
Search
ドキュメントセンター

PolarDB:クイックスタート

最終更新日:Jun 23, 2026

このトピックでは、PolarDB for MySQL をすぐに使い始める方法について説明します。具体的には、クラスターの作成、ホワイトリストの設定、データベースアカウントの作成、クラスターへの接続方法を解説します。

チュートリアル

以下のいずれかの手順についてご質問がある場合は、その手順をクリックして詳細な手順をご確認ください。

1. クラスターの作成

PolarDB[クイック購入] ページに移動して、最小限の構成で PolarDB for MySQL クラスターをすばやく作成します。 次の表のパラメーターを設定し、他のすべての設定にはデフォルト値を使用します。 詳細については、「カスタム構成でクラスターを作成する」をご参照ください。

パラメーター

説明

課金方法

クラスターの 課金方法 を選択します。詳細については、「課金方法」をご参照ください。

  • サブスクリプション:クラスター作成時に固定リソースに対して料金を前払いするモデルです。サブスクリプション期間が長いほど、割引率が高くなります。このモデルは、長期的で安定したワークロードに最適です。

  • 従量課金:後払いモデルです。クラスター作成時に固定仕様のリソースを選択しますが、前払いは不要です。実際の使用量に基づいて課金されます。このモデルは、需要が変動するワークロードに最適です。

  • サーバーレス:従量課金モデルです。クラスター作成時に固定仕様のリソースを選択したり、事前に料金を支払ったりする必要はありません。このモデルは、動的で弾力的なスケーリング機能を備えた PolarDB クラスターを提供し、ビジネスワークロードの変動に応じてリソースを自動的に調整できます。このモデルは一般的に、ビジネスの変動、不確定なワークロード、または予測不可能なビジネスシナリオに適しています。

リージョン

クラスターをデプロイするリージョンを選択します。

説明

PolarDB クラスターと接続したい ECS インスタンスは、内部ネットワーク経由で通信するために同じリージョンにある必要があります。

データベースエンジン

クラスターの データベースエンジン を選択します。

  • MySQL 8.0.1

  • MySQL 8.0.2

説明

クイック購入は MySQL 8.0 のみをサポートしています。別の MySQL バージョンを購入するには、左上隅の 購入 タブをクリックしてください。

プロダクトエディション

クラスターの データベースエディション を選択します。

  • Enterprise Edition

  • Standard Edition

説明
  • クラスターの データベースエディション を選択する必要があるのは、課金方法サブスクリプション または 従量課金 の場合のみです。

  • Enterprise EditionStandard Edition では提供される機能が異なります。詳細については、「Enterprise Edition と Standard Edition の機能比較」をご参照ください。

ネットワークタイプ

クラスターの VPC と vSwitch を設定します。

説明
  • ネットワーク要件を満たす既存の VPC がある場合は、その VPC とその vSwitch を選択します。たとえば、既存の ECS インスタンスの VPC を使用できます。

  • 適切な VPC がない場合は、デフォルトの VPC と vSwitch を使用できます。

デプロイモード (オプション)

クラスターのノード数と高可用性モードを選択します。詳細については、「高可用性モード (ホットスタンバイクラスター)」をご参照ください。

  • シングルノード:1つのプライマリノード (読み取り/書き込みノード) のみを含みます。

    • ノード数: 1

    • 高可用性モード:シングル AZ (ホットスタンバイクラスター無効)

  • デュアルノード高可用性:1つのプライマリノード (読み取り/書き込みノード) と1つの読み取り専用ノードを含みます。

    • ノード数: 2

    • 高可用性モード: シングル AZ (ホットスタンバイクラスター無効)

  • クロスゾーン高可用性:1つのプライマリノード (読み取り/書き込みノード) と1つの読み取り専用ノードを含みます。データは複数のアベイラビリティゾーンに分散されます。プライマリとセカンダリのアベイラビリティゾーンはそれぞれデータの完全なコピーを保存します。

    • ノード数: 2

    • 高可用性モード: マルチ AZ (ホットスタンバイクラスター有効)

説明

このオプションは、サブスクリプション および 従量課金課金方法 でのみ利用可能です。

ノード仕様

実際の要件に基づいて、クラスターのコンピューティングノードタイプを選択します。他のタイプを購入する必要がある場合は、左上隅の 購入 タブを選択してください。

ストレージ容量 (オプション)

クラスターのストレージ容量を設定します。

説明

このオプションは、課金方法サブスクリプション または 従量課金 で、かつ データベースエディション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 クラスターを管理できます。

  1. PolarDB コンソール に移動します。クラスターリスト で、対象クラスターの ID をクリックしてクラスター詳細ページに移動します。ページの右上隅にある データベースにログイン をクリックします。image

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

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

クライアントを使用してクラスターに接続

MySQL 互換の任意のクライアントを使用して PolarDB クラスターに接続できます。以下の例では MySQL Workbench 8.0.29 を使用します。

  1. MySQL Workbench をダウンロードしてインストールします。

  2. MySQL Workbench を開き、Database > Connect to Database を選択します。

  3. 接続情報を入力し、OK をクリックします。

    Connection dialog

    パラメーター

    説明

    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 です。

  • ポートがデフォルトポートの場合、このパラメーターは省略できます。

3306

-u

データベースアカウント

polardb_mysql_user

-p

データベースアカウントのパスワード。

説明

このパラメーターは必須です。

  • このパラメーターを省略すると、Enter password の後にパスワードの入力を求められます。

  • このパラメーターを含める場合、-p とパスワードの間にスペースを入れないでください。

Pass***233

アプリケーションを使用してクラスターに接続

PolarDB for MySQL クラスターへの接続は、任意の MySQL データベースへの接続と同じです。エンドポイント、ポート、アカウント、パスワードを、ご利用の PolarDB クラスターの値に置き換えてください。以下に言語別の例を示します:

Java

Maven プロジェクトで MySQL JDBC ドライバーを使用して PolarDB for MySQL クラスターに接続します。

  1. pom.xml ファイルに MySQL JDBC ドライバーの依存関係を追加します:

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.27</version>
    </dependency>
  2. クラスターに接続します。<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 クラスターに接続します。

  1. PyMySQL ライブラリをインストールします:

    pip3 install PyMySQL
  2. クラスターに接続します。<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 クラスターに接続します。

  1. go-sql-driver/mysql ドライバーをインストールします:

    go get -u github.com/go-sql-driver/mysql
  2. クラスターに接続します。<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 への接続が失敗する

次のようにトラブルシューティングを行ってください:

  1. PolarDB クラスターが 実行中 の状態であることを確認します。

  2. データベースエンドポイント、ポート、アカウント、パスワードが正しいことを確認します。データベースエンドポイントとポートの取得

  3. ECS インスタンスから ping <database endpoint> または telnet <database endpoint> <port> を使用してネットワーク接続をテストします。

    1. プライベートネットワーク エンドポイントを使用している場合:

      1. ECS インスタンスと PolarDB クラスターが同じ VPC 内にあるかどうかを確認します。同じ VPC 内にない場合、プライベートネットワーク エンドポイントは使用できません。ECS インスタンスと PolarDB クラスターを同じ VPC に配置するには、次のいずれかのソリューションを使用します:

      2. ECS インスタンスのプライベート IP アドレス、IP アドレス範囲、またはセキュリティグループが クラスターホワイトリスト に追加されているかどうかを確認します。

    2. パブリックネットワーク エンドポイントを使用している場合、ECS インスタンスのパブリック IP アドレスまたはセキュリティグループが クラスターホワイトリスト に追加されているかどうかを確認します。

説明

バーチャルホストおよび Simple Application Server は、プライベートネットワーク エンドポイントを介して PolarDB に接続できません。

オンプレミスから PolarDB への接続が失敗する

次のようにトラブルシューティングを行ってください:

  1. PolarDB クラスターが 実行中 の状態であることを確認します。

  2. データベースエンドポイント、ポート、アカウント、パスワードが正しいことを確認します。データベースエンドポイントとポートの取得

    説明

    データベースエンドポイントは パブリックネットワーク エンドポイントである必要があります。PolarDB クラスターと同じ VPC 内にある ECS インスタンスを使用している場合は、プライベートネットワーク エンドポイントを使用できます。

  3. オンプレミス環境から ping <database endpoint> または telnet <database endpoint> <port> を使用してネットワーク接続をテストします。

  4. オンプレミス環境のパブリック IP アドレスまたは IP アドレス範囲が クラスターホワイトリスト に追加されているかどうかを確認します。

    パブリック IP アドレスを取得します:

    • Linux オペレーティングシステム:ターミナルを開き、curl ifconfig.me コマンドを実行します。

    • Windows オペレーティングシステム:コマンドプロンプトを開き、curl ip.me コマンドを実行します。

    • macOS オペレーティングシステム:ターミナルを開き、curl ifconfig.me コマンドを実行します。

    オンプレミスのネットワーク環境がプロキシサーバーを使用しているか、または同様の構成がある場合、上記の方法で取得した IP アドレスは実際のパブリック IP アドレスではない可能性があります。IP アドレス範囲 0.0.0.0/0PolarDB クラスターのホワイトリストに追加できます。クラスターに正常に接続した後、SHOW PROCESSLIST; コマンドを実行して実際のパブリック IP アドレスを取得し、それをクラスターホワイトリストに追加します。その後、IP アドレス範囲 0.0.0.0/0 をホワイトリストから削除します。

    image

「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/0PolarDB クラスターのホワイトリストに追加できます。クラスターに正常に接続した後、SHOW PROCESSLIST; コマンドを実行して実際のパブリック IP アドレスを取得し、それをクラスターホワイトリストに追加します。その後、IP アドレス範囲 0.0.0.0/0 をホワイトリストから削除します。

image