Cloud SQL データベースに接続する

Cloud Code は、Cloud SQL Auth プロキシの実行、Cloud SQL データベースへの接続、Cloud SQL インスタンスの表示、新しいデータソースの作成をサポートしています。

始める前に

  • Cloud Code をインストールします(まだインストールしていない場合)。

  • 新しいデータソースを作成するには、次のいずれかのプレミアム JetBrains IDE を使用します。

  • 他の推奨データベース ツール(DBeaverMySQL WorkbenchSQL Server Management Studio など)で接続し、Cloud Code によって提供されるローカルポートを使用して Cloud SQL インスタンスに接続することもできます。

Cloud SQL Auth プロキシを使用して Cloud SQL データベースに接続する

Cloud Code を使用して、Cloud SQL データベースに接続し、IntelliJ またはその他の サポートされている JetBrains IDE で Cloud SQL インスタンスのリストを表示できます。

Cloud Code を使用して Cloud SQL データベースに接続するには、次の操作を行います。

  1. IDE でサイドバーの [Google Cloud Databases] をクリックするか、[View] > [Tool Windows] > [Google Cloud Databases] をクリックします。

  2. Google Cloud プロジェクトがまだ選択されていない場合は、[Google Cloud プロジェクトを選択する] をクリックし、プロンプトに従って Google Cloud プロジェクトを読み込みます。

    Google Cloud プロジェクトの Cloud SQL インスタンスは [Cloud SQL] に表示されます。

    Cloud SQL ツール ウィンドウ

  3. Cloud SQL インスタンスに接続するには、インスタンスを右クリックして [Cloud SQL Proxy を使用して接続する] を選択します。[Cloud SQL Proxy(プライベート IP)を使用して接続] を選択して、プライベート IP を使用するようにすることもできます。

SQL インスタンスへの接続の詳細については、接続オプションについてをご覧ください。

新しいデータソースを作成

Cloud SQL Auth Proxy 接続が確立されると、[Cloud SQL Instance Connect] ダイアログが表示され、ローカルで使用可能なデータベース用の新しいデータソースを作成する、または既存のデータを表示するオプションを選択できます。

  1. 新しいデータソースを作成するには、[新しいデータソースを作成] を選択します。

    または、インスタンスを右クリックして [新しいデータソースを作成] を選択します。

    [データソース] ダイアログと [ドライバ] ダイアログ

  2. [認証] フィールドで、メソッドを選択します(デフォルトでは、ユーザー名とパスワードです)。

  3. 構成を保存します。

    Cloud Code は、次の形式の名前を持つ新しいデータソース接続を作成します。

    gcp-project:location:db-instance-name

    データベース インスタンスの操作は、JetBrains のデータベース ツールと SQL プラグイン機能、または DataGrip を使用して開始できます。

  4. (オプション)IDE のデータソースのリストを表示するには、サイドバーで [Database] または [View] > [Tool Windows] > データベース をクリックします。データソースを右クリックすると、スキーマやテーブルの表示、その他のデータベース オペレーションなどのオプションのリストが表示されます。

    データベース ツールのオプション

    DataGrip でのデータベースの操作の詳細については、DataGrip のクイックスタートをご覧ください。

Cloud SQL Auth プロキシの接続を解除する

プロキシ プロセスを停止してローカル データベース ポートを解放するには、ターミナルで Ctrl+C を押します。

既知の問題

このセクションでは、既知の問題とその現在の解決策について説明します。

別のポートを設定して複数のデータベースに接続する

Cloud SQL Auth Proxy は、ビジー状態の場合はポートを自動的に選択せず、常に 1 つのポートを使用するため、特定のタイプのデータベースに接続されている 1 つのインスタンスに制限されます。

Cloud Code がターミナルで Cloud SQL Auth Proxy を実行し、ポートの競合が発生した場合は、カスタム --port フラグ付きで同じコマンドをターミナルで実行すると、別のポートを設定してデータベースに接続できます。次に例を示します。

--port=PORT_NUMBER

このポートは、データベース接続で使用できます。コマンドは自動生成されます。次に例を示します。

path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING

サポートを受ける

IntelliJ IDE でフィードバックを送信するか、問題を報告するには、[Tools] > [Cloud Code] > [Help / About] > [Submit feedback or report an issue] を選択します。ここから、GitHub で問題を報告できます。