Cloud Code では、Cloud SQL Auth Proxy を実行して Cloud SQL データベースに接続し、Cloud SQL インスタンスを表示して、新しいデータソースを作成できます。
始める前に
Cloud Code をインストールします(まだインストールしていない場合)。
新しいデータソースを作成するには、次のいずれかのプレミアム JetBrains IDE を使用します。
データベース ツールと SQL プラグインが含まれている IntelliJ Ultimate または別のプレミアム JetBrains IDE(デフォルトで有効になっています)。
DataGrip。スタンドアロン データベース管理環境。
他の推奨データベース ツール(DBeaver、MySQL Workbench、SQL 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 データベースに接続するには、次の手順を行います。
IDE でサイドバーの [Google Cloud Databases] をクリックするか、[View] > [Tool Windows] > [Google Cloud Databases] をクリックします。
Google Cloud プロジェクトがまだ選択されていない場合は、[Google Cloud プロジェクトを選択] をクリックして、プロンプトに従って Google Cloud プロジェクトを読み込みます。
Google Cloud プロジェクト内の Cloud SQL インスタンスは [Cloud SQL] に表示されます。
Cloud SQL インスタンスに接続するには、インスタンスを右クリックして [Cloud SQL Proxy を使用した接続] を選択します。[Cloud SQL Proxy(プライベート IP)を使用して接続] を選択して、プライベート IP を使用することもできます。
SQL インスタンスへの接続の詳細については、接続オプションについてをご覧ください。
新しいデータソースを作成
Cloud SQL Auth Proxy 接続が確立されると、[Cloud SQL Instance Connect] ダイアログが表示され、ローカルで使用可能なデータベース用の新しいデータソースを作成する、または既存のデータを表示するオプションを選択できます。
新しいデータソースを作成するには、[新しいデータソースを作成] を選択します。
または、インスタンスを右クリックして、[新しいデータソースの作成] を選択します。
[Authentication] フィールドで、メソッドを選択します(デフォルトではユーザー名とパスワードです)。
構成を保存します。
Cloud Code によって、新しいデータソース接続が次の形式で名前で作成されます。
gcp-project:location:db-instance-name
。JetBrains の Database Tools と SQL プラグインの機能、または DataGrip を使用して、データベース インスタンスの操作を開始できます。
(オプション)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