クライアントまたはCLIを使用してApsaraDB RDS for MySQLインスタンスに接続する - ApsaraDB RDS

ApsaraDB RDS for MySQLインスタンスを作成し、アカウントの作成やホワイトリスト設定などの必要な設定を完了した後、クライアントまたはCLIを使用してRDSインスタンスに接続できます。このトピックでは、インターネットまたは内部ネットワークを介してクライアントまたはCLIを使用してRDSインスタンスに接続する方法について説明します。このトピックでは、接続障害に関連する一般的なエラーを処理する方法についても説明します。

前提条件

RDSインスタンスが作成され、そのRDSインスタンスのデータベースとアカウントが作成されます。詳細については、「手順1: ApsaraDB RDS For MySQLインスタンスの作成とデータベースの設定」をご参照ください。
RDSインスタンスにIPアドレスホワイトリストが設定されています。詳細については、「IPアドレスホワイトリストの設定」をご参照ください。

提案事項

内部ネットワークを介した接続の条件が満たされている場合は、内部エンドポイントを使用してRDSインスタンスに接続し、低レイテンシと高い安定性を実現することを推奨します。
内部ネットワーク接続の条件
内部ネットワークを介してECS (Elastic Compute Service) インスタンスをRDSインスタンスに接続する場合は、次の条件を満たす必要があります。
- ECSインスタンスとRDSインスタンスは同じネットワークタイプを使用しています。
- ECSインスタンスとRDSインスタンスの両方が仮想プライベートクラウド (VPC) に存在する場合、インスタンスは同じVPCに存在する必要があります。
- ECSインスタンスのプライベートIPアドレスがRDSインスタンスのIPアドレスホワイトリストに追加されます。詳細は、ホワイトリストの構成をご参照ください。
インターネット経由でRDSインスタンスに接続する場合は、インスタンスのアップグレードまたは仕様変更中にパブリックIPアドレスが変更される可能性があるため、パブリックIPアドレスではなくインスタンスエンドポイントを使用することを推奨します。
説明
curl ipinfo.io/ipコマンドを実行して、オンプレミスクライアントのパブリックIPアドレスを照会できます。

手順

CLIを使用したRDSインスタンスへの接続

次の例では、Linuxを実行するサーバーからRDSインスタンスに接続する方法を説明します。接続前にサーバーにMySQLをインストールする必要があります。次のコマンドを実行してMySQLをインストールできます。

CentOSオペレーティングシステムを使用している場合は、sudo yum install mysqlコマンドを実行します。
Ubuntuオペレーティングシステムを使用している場合は、sudo apt-get updateコマンドを実行してから、sudo apt install mysql-serverコマンドを実行します。

RDSインスタンスに接続するサーバーにログインします。たとえば、サーバーはECSインスタンスまたはオンプレミスデバイスです。
説明
ECSインスタンスへのログイン方法の詳細については、「ECSコンソール (エクスプレスバージョン) を使用したECSインスタンスの作成と管理」の「インスタンスへの接続」をご参照ください。

接続コマンドを実行します。

mysql -hEndpoint -PPort -uUsername -pPassword

説明

コマンドの実行後にパスワードを入力できます。
大文字のPはポート番号を指定し、小文字のpはパスワードを指定します。

エンドポイントとポート番号: RDSインスタンスへの接続に使用されるエンドポイントとポート番号を入力します。

シナリオ	エンドポイントを取得	エンドポイントの取得方法
ECSインスタンスからRDSインスタンスに接続します。 ECSインスタンスとRDSインスタンスが、内部ネットワークを介した通信の条件を満たしていること。	RDSインスタンスの内部エンドポイント	ApsaraDB RDSコンソールにログインし、[インスタンス] ページに移動します。上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。 RDSインスタンスを見つけ、インスタンスIDをクリックします。表示されるページの [基本情報] セクションで、[ネットワークタイプ] パラメーターの右側にある [詳細の表示] をクリックして、RDSインスタンスへの接続に使用されるエンドポイントとポート番号を表示します。説明 RDSインスタンスへの接続に使用されるエンドポイントとポート番号を表示する前に、RDSインスタンスのIPアドレスホワイトリストを設定する必要があります。パブリックエンドポイントは、[パブリックエンドポイントに申請] をクリックしてRDSインスタンスにパブリックエンドポイントが適用された後にのみ表示されます。 [クラスター読み書き接続] セクションでRDSクラスターの読み書きエンドポイントを変更し、[クラスター読み取り専用接続] セクションでRDSクラスターの読み取り専用エンドポイントを変更できます。
ECSインスタンスからRDSインスタンスに接続します。 ECSインスタンスとRDSインスタンスは、内部ネットワークを介した通信の条件を満たしていません。	RDSインスタンスのパブリックエンドポイント
オンプレミスのデバイスからRDSインスタンスに接続します。	RDSインスタンスのパブリックエンドポイント

ユーザー名とパスワード: RDSインスタンスへの接続に使用されているアカウントのユーザー名とパスワードは、インスタンス詳細ページの [アカウント] ページから取得できます。

クライアントを使用したRDSインスタンスへの接続

汎用MySQLクライアントを使用して、RDSインスタンスに接続できます。次の例では、MySQL Workbench 8.0.29を使用してRDSインスタンスに接続する方法を説明します。別のクライアントを使用する場合、接続操作は似ています。

MySQL Workbenchをインストールします。詳細については、MySQL Workbenchダウンロードページをご覧ください。
MySQL Workbenchを起動し、データベース > データベースへの接続.

接続情報を入力し、OK.

连接界面

ホスト名とポート: RDSインスタンスへの接続に使用されるエンドポイントとポート番号を入力します。

シナリオ	エンドポイントを取得	エンドポイントの取得方法
ECSインスタンスからRDSインスタンスに接続します。 ECSインスタンスとRDSインスタンスが、内部ネットワークを介した通信の条件を満たしていること。	RDSインスタンスの内部エンドポイント	ApsaraDB RDSコンソールにログインし、[インスタンス] ページに移動します。上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。 RDSインスタンスを見つけ、インスタンスIDをクリックします。表示されるページの [基本情報] セクションで、[ネットワークタイプ] パラメーターの右側にある [詳細の表示] をクリックして、RDSインスタンスへの接続に使用されるエンドポイントとポート番号を表示します。説明 RDSインスタンスへの接続に使用されるエンドポイントとポート番号を表示する前に、RDSインスタンスのIPアドレスホワイトリストを設定する必要があります。パブリックエンドポイントは、[パブリックエンドポイントに申請] をクリックしてRDSインスタンスにパブリックエンドポイントが適用された後にのみ表示されます。 [クラスター読み書き接続] セクションでRDSクラスターの読み書きエンドポイントを変更し、[クラスター読み取り専用接続] セクションでRDSクラスターの読み取り専用エンドポイントを変更できます。
ECSインスタンスからRDSインスタンスに接続します。 ECSインスタンスとRDSインスタンスは、内部ネットワークを介した通信の条件を満たしていません。	RDSインスタンスのパブリックエンドポイント
オンプレミスのデバイスからRDSインスタンスに接続します。	RDSインスタンスのパブリックエンドポイント

ユーザー名とパスワード: RDSインスタンスへの接続に使用されているアカウントのユーザー名とパスワードは、インスタンス詳細ページの [アカウント] ページから取得できます。 .

一般的な接続エラー

mysqlコマンドが見つかりません

このエラーは、MySQLがインストールされていないために発生します。次のコマンドを実行してMySQLをインストールします。

CentOSオペレーティングシステムを使用している場合は、sudo yum install mysqlコマンドを実行します。
Ubuntuオペレーティングシステムを使用している場合は、sudo apt-get updateコマンドを実行してから、sudo apt install mysql-serverコマンドを実行します。

SSL接続エラー: SSLが必要ですが、サーバーがサポートしていません

MySQL Workbenchの特定のバージョンを使用しています。これらのバージョンでは、標準TCP/IP接続にSSL暗号化が必要です。ただし、接続サーバーはSSL暗号化をサポートしていません。この場合、このセクションで説明するMySQL Workbenchのバージョンをダウンロードして、通常の接続を確立できます。

エラーコード10060: 'rm -bpxxx.mysql.rds.aliyuncs.com 'でMySQLサーバーに接続できません (10060)

ほとんどの場合、このエラーは、設定したIPアドレスのホワイトリストが不適切なために発生します。詳細については、「IPアドレスホワイトリストの設定」をご参照ください。
このエラーは、RDSインスタンスとECSインスタンスが [提案] セクションに記載されている条件を満たしていないために発生する場合があります。ただし、RDSインスタンスの内部エンドポイントに接続しようとします。

エラーコード113: 'rm -bpxxx.mysql.rds.aliyuncs.com 'でMySQLサーバーに接続できません (113)

このエラーは、ルートの競合が発生したために発生します。詳細については、「ApsaraDB RDSインスタンスに接続できず、インスタンスの内部エンドポイントへのping時に「Destination Host Unreachable」というエラーメッセージが表示された場合はどうすればよいですか。」をご参照ください。

データベースサーバーに接続できません

ほとんどの場合、このエラーは、設定したIPアドレスのホワイトリストが不適切なために発生します。詳細については、「IPアドレスホワイトリストの設定」をご参照ください。
いくつかのケースでは、RDSインスタンスとECSインスタンスが提案セクションに記載されている条件を満たしていないため、このエラーが発生します。ただし、RDSインスタンスの内部エンドポイントに接続しようとします。

ユーザー 'xx "のMySQLサーバーへの接続に失敗しました

ほとんどの場合、このエラーは、設定したIPアドレスのホワイトリストが不適切なために発生します。詳細については、「IPアドレスホワイトリストの設定」をご参照ください。
いくつかのケースでは、RDSインスタンスとECSインスタンスが提案セクションに記載されている条件を満たしていないため、このエラーが発生します。ただし、RDSインスタンスの内部エンドポイントに接続しようとします。

RDSインスタンスの内部エンドポイントにpingを送信すると、"Destination Host Unreachable" というエラーメッセージが表示されます。

ユーザー 'xxx' @ 'xxx' のアクセスが拒否されました (パスワード: はい)

このエラーは、入力したユーザー名とパスワードが正しくないために発生します。インスタンス詳細ページの [アカウント] ページから正しいユーザー名とパスワードを取得できます。

不明なMySQLサーバーホスト 'xxx'(11001)

このエラーは、入力したエンドポイントが無効なために発生します。有効なエンドポイントはe rm-xxxxxx.mysql.rds.aliyuncs.com形式です。

よくある質問

RDSインスタンスはelastic IPアドレス (EIP) をサポートしていますか。
いいえ、RDSインスタンスはEIPをサポートしていません。
ECSインスタンスとRDSインスタンスが同じVPCまたはリージョンにない場合、どうすれば接続できますか。
VPCピアリング接続またはCloud Enterprise Network (CEN) インスタンスを使用して、VPC間通信を有効にできます。詳細については、「VPCピアリング接続」および「VPCをCENインスタンスにアタッチする」をご参照ください。
Telnetを使用してコンピューターをRDSインスタンスに接続できない問題を解決するにはどうすればよいですか。
Telnetを使用してコンピューターをRDSインスタンスに接続できない場合は、次の項目を確認できます。
- RDSインスタンスのサービスポートが正しく、インターネット経由でアクセスできるかどうか。
- RDSインスタンスのセキュリティグループまたはファイアウォールルールが、コンピューターのIPアドレスからのアクセス要求を許可するかどうか。
- ホスト名やポート番号などの接続パラメーターが正しく設定されているかどうか。
- 問題がTelnet固有の問題であるかどうか。 mysqlクライアントやデータベース管理ツールなどの他の方法を使用して、チェックのためにRDSインスタンスに接続できます。

ApsaraDB RDS:クライアントまたはCLIを使用してApsaraDB RDS for MySQLインスタンスに接続する