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

Cloud Code では、Cloud SQL Auth Proxy を実行して 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. [Authentication] フィールドで、メソッドを選択します(デフォルトではユーザー名とパスワードです)。

  3. 構成を保存します。

    Cloud Code によって、新しいデータソース接続が次の形式で名前で作成されます。

    gcp-project:location:db-instance-name

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

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

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

    DataGrip でデータベースを操作する方法については、DataGrip クイック スタートをご覧ください。

Cloud SQL Auth Proxy の接続を解除する

プロキシ プロセスを停止してローカル データベース ポートを解放するには、ターミナルで 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 で問題を報告したり、Stack Overflow で質問したりできます。