ローカルマシンまたは Compute Engine からデータベースクライアントを使用して接続する

MySQL | PostgreSQL | SQL Server

このページでは、クライアントマシンでローカルに実行しているか、Compute Engine VM または Cloud Shell で実行しているかにかかわらず、mysql クライアントを Cloud SQL インスタンスに接続する方法について説明します。

始める前に

クライアントの使用を開始するには、次の作業を行っておく必要があります。

Cloud SQL インスタンスを作成し、デフォルトユーザーを構成する。

インスタンスの作成とデフォルトユーザーアカウントの構成をご覧ください。
必要に応じて、Compute Engine VM インスタンスを作成し、SSH を使用してインスタンスに接続します。

VM インスタンスの作成と起動、Linux VM への SSH 接続、または Windows VM への接続をご覧ください。
インスタンスに接続する方法を決定します。

接続オプションとその選択方法については、接続の概要ページをご覧ください。

ローカルマシンまたは Compute Engine VM でクライアントを使用する

mysql クライアントを使用して Cloud SQL インスタンスに接続する手順には、大きく分けて次の 3 つのタスクがあります。

クライアントをインストールします。
Cloud SQL インスタンスへのアクセスを構成します。
Cloud SQL インスタンスに接続します。

クライアントをインストールする

クライアントをインストールするには:

プラットフォーム向けの MySQL Community Server を MySQL Community Server ダウンロードページからダウンロードします。
Community Server に MySQL クライアントが含まれています。
ダウンロードページの指示に沿って、Community Server をインストールします。

MySQL のインストールの詳細については、MySQL のインストールとアップグレードをご覧ください。

Cloud SQL インスタンスへのアクセスを構成する

インスタンスへのアクセスを構成するには:

クライアントマシンまたは Compute Engine VM インスタンスで、What's my IP を使用して、クライアントマシンの IP アドレスを確認します。
その IP アドレスをコピーします。
Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
SQL ナビゲーションメニューから [接続] を選択します。
[承認済みネットワーク] セクションで、[ネットワークを追加] をクリックし、クライアントがインストールされているマシンの IP アドレスを入力します。
注: インスタンスの IP アドレスと承認する mysql クライアントの IP アドレスは同じバージョン（IPv4 または IPv6）でなければなりません。
[完了] をクリックし、ページの下部にある [保存] をクリックして変更内容を保存します。
インスタンスに接続します。SSL あり、SSL なしのどちらの接続でもかまいません。

暗号化しないで Cloud SQL インスタンスに接続する

インスタンスに接続するには:

クライアントをインストールし、インスタンスへのアクセスを構成したことを確認します。

MySQL クライアントを起動します。

mysql --host=INSTANCE_IP --user=root --password

パスワードを入力します。
MySQL プロンプトが表示されます。

SSL を使用して Cloud SQL インスタンスに接続する

SSL を使用して接続するには、次のものが必要です。

server-ca.pem ファイル内の認証局（CA）証明書。
client-cert.pem ファイル内のクライアントの公開鍵証明書。
client-key.pem ファイル内のクライアントの秘密鍵。

クライアント証明書と対応する秘密鍵がない場合は、新しいクライアント証明書を作成します。

開始する前に、クライアントをインストールし、インスタンスへのアクセスを構成したことを確認します。

SSL を使用してインスタンスに接続するには:

MySQL クライアントを起動します。
```
mysql --ssl-ca=server-ca.pem --ssl-cert=client-cert.pem --ssl-key=client-key.pem \
             --host=INSTANCE_IP --ssl-mode=verify_ca --user=root --password
```
警告: MariaDB クライアントを使用して MySQL インスタンスに接続する場合は、コマンドに --ssl-mode フラグを含めないでください。代わりに、MySQL コミュニティサーバーのクライアントを使用してください。
パスワードを入力します。
MySQL のプロンプトで \s コマンドを入力し、接続が SSL を使用していることを確認します。
出力行で SSL: を探します。
```
...
SSL:                     Cipher in use is DHE-RSA-AES256-SHA
...
```
警告: バージョン 5.7.3 よりも前の MySQL クライアントは、--ssl オプションを必須としません。サーバーが暗号化された接続を受け付けない場合、何もメッセージを出さずに非暗号化接続にフォールバックします。詳細については、MySQL リファレンスマニュアルの暗号化された接続の使用をご覧ください。この問題を回避するには、SSL 接続のみで接続できるようにインスタンスを構成します（詳しくは、インスタンスに SSL を構成するをご覧ください）。

IP を使用した接続の問題のトラブルシューティングについては、Cloud SQL インスタンスでの問題を診断するをご覧ください。

Cloud Shell でクライアントを使用する

Cloud SQL インスタンスに接続するには（パブリック IP のみ）:

Google Cloud Console に移動します。
Google Cloud Console に移動
ツールバーの右側にある Cloud Shell アイコンをクリックします。
Cloud Shell の初期化には少し時間がかかります。
Cloud Shell プロンプトで、組み込みのクライアントを使用して Cloud SQL インスタンスに接続します。
```
gcloud sql connect INSTANCE_ID \
--user=root
```
パスワードを入力します。

gcloud sql connect コマンドは、プライベート IP または SSL / TLS を使用した Cloud SQL インスタンスへの接続をサポートしていません。暗号化を使用して接続するには、Cloud Shell でプロキシをインストールして使用します。

/home/USER ディレクトリにプロキシ（Linux 64 ビット）をインストールします。
gcloud CLI 認証を使用してプロキシを開始します。
```
./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:3306 &
```
TCP 接続を使用してデータベースに接続します。
```
mysql -u USERNAME -p --host=127.0.0.1
```

次のステップ

Cloud SQL インスタンスの 2 レベルのアクセス制御について学習します。
ユーザーとデータベースを作成します。
プライベート IP アドレスを使用するインスタンスの構成について学習します。
アプリケーションからインスタンスに接続するためのオプションについて学習する。
mysql クライアントについて学習する。
サポートのオプションについて学習する。

使ってみる

Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Cloud SQL のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

Cloud SQL 無料トライアル