DataGrip 2026.1 Help

Google CloudSQL インスタンスに接続する

このトピックの範囲では、Google Cloud Platform 上で PostgreSQL インスタンスを使用します。 ただし、同じ手順で Google Cloud SQL の MySQL および Microsoft SQL Server インスタンスに接続できます。

インスタンスをまだ作成していない場合は、 cloud.google.com でインスタンスを作成するを参照してください。

DataGrip から、次のオプションを使用してインスタンスに接続できます。

Google CloudSDK の設定

この構成手順は、 Cloud SQL Proxy clientCloudSQL Connector for Java に共通です。 許可されたネットワークのリストにネットワークを追加する場合は、この部分をスキップできます。

接続の構成を完了するには、 Google Cloud SDK が必要です。

Google Cloud SDK には、認証と Google Cloud Platform API とのやり取りを管理する gcloud ユーティリティが含まれています。 gcloud の詳細については、「cloud.google.com の gcloud リファレンス 」を参照してください。

ステップ 1。 Google CloudSDK のインストール

インストールプロセスの詳細については、「cloud.google.com にある GoogleCloudSDK のインストールガイド 」を参照してください。 この手順では、ガイドの手順の概要を説明します。

  1. Google Cloud SDK アーカイブをダウンロードして展開します。

  2. gcloud init コマンドを実行して SDK を初期化します。 コマンドプロンプトでインストールウィザードに従います。

    ./google-cloud-sdk/bin/gcloud init
    gcloud init を実行して、SDK を初期化する

ステップ 2. アプリケーションを CloudSQL AdminAPI に登録する

  1. クラウド SQL 管理 API を有効にするセクションの API を有効にする ボタンをクリックします。

  2. ドロップダウンでプロジェクトを選択し、 続行 をクリックします。

    このプロジェクト内のデータベースに接続する場合は、各データベースプロジェクトに対して Cloud SQL Admin API を有効にする必要があります。 例:1 つのプロジェクトは PostgreSQL を使用し、別のプロジェクトは MySQL を使用します。 両方のプロジェクトに対して API を有効にする必要があります。

    Cloud SQL Admin API

ステップ 3. 認証を構成する

  1. 次のコマンドを実行して、 gcloud ツールを認証します。

    gcloud auth login

    このコマンドは、資格情報を取得して ~/.config/gcloud/ に保管します。 これで、ターミナルから gcloud コマンドを実行でき、資格情報が自動的に検出されます。

    gcloud ツールを認証する
  2. 次のコマンドを実行して、アプリケーションのデフォルト資格情報(ADC)ライブラリの資格情報を取得します。

    gcloud auth application-default login

    このコマンドは、ADC ライブラリの資格情報を取得します。 これで、コンピューターで実行されているコードまたは SDK は、資格情報を自動的に見つけることができます。

    CloudSQL サーバーへの接続を認証する

CloudSQL プロキシクライアントとの接続の構成

クラウド SQL プロキシクライアントは、安全なトンネルを介してデータベースと通信します。 cloud.google.com の CloudSQLProxy についてでクライアントの詳細を参照してください。

ステップ 1。 CloudSQL プロキシクライアントを実行する

  1. CloudSQL プロキシクライアントをダウンロードします。 cloud.google.com のローカルマシンに CloudSQLProxy クライアントをインストールするインストール手順を参照してください。

  2. コマンドプロンプトでプロキシを起動します。

    ./cloud-sql-proxy --port 3306 <INSTANCE_CONNECTION_NAME>

    connection_name をインスタンスの接続名に置き換えます。 この情報は、インスタンスの 概要 ページにあります。 3306 ポートがすでに使用されている場合は、別のポート(5435 など)に変更します。

    概要ページでのインスタンスの接続名

ステップ 2. データソースを作成する

  1. Cloud SQL プロキシクライアントが実行されていることを確認します(ステップ 1 を参照)。

  2. 次のいずれかの方法でデータソースのプロパティを開きます。

    • ファイル | データソース に移動します。

    • データベースエクスプローラー (⌘ 1) ツールバーで、 The Data Sources iconデータソース をクリックします。

    • Ctrl+Alt+Shift+S を押します。

    データソースとドライバーを開くダイアログ
  3. データソースおよびドライバー ダイアログで、 追加 アイコン(The Add icon )をクリックし、データベースベンダー(この場合は PostgreSQL )を選択します。

  4. 接続設定エリアの下部に「不足しているドライバーファイルのダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。

    不足しているドライバーファイルのダウンロードリンク

    ダウンロードされた JDBC ドライバーの場所は DataGrip 構成ディレクトリです。

    提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。

    不足しているドライバーファイルのダウンロード リンクがない場合は、必要なドライバーがすでに存在します。

  5. 認証 リストから ユーザーパスワード を選択してください。

  6. 接続の詳細を指定します。

    • ホスト127.0.0.1。 Cloud SQL Proxy クライアントを使用しているため、ローカルマシンに接続しています。

    • ポート: 3306 、またはプロキシ用に選択したその他のポート(たとえば、 5435)。

    • ユーザー: データベースにアクセスする権限を持つユーザー。

    • パスワード: ユーザーのパスワード。

    • データベース: 接続するデータベース。

  7. 提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。

    テスト接続リンク

    接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。

  8. (オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがプロジェクトであり、データセットはデータベースであり、スキーマはキースペースであり、名前空間はイントロスペクトされており、使用できます。 他のデータベースとスキーマプロジェクトとデータセット、データベース、スキーマ、共有データベースデータベーススキーマキースペースネームスペースも操作する場合は、「スキーマ 」タブで、イントロスペクションの対象として選択します。

    データソースとドライバーの「スキーマ」タブダイアログ
  9. OK をクリックして、データソースを作成します。

  10. データベースエクスプローラー (⌘ 1) で新しいデータソースを見つけます。

    • データベースエクスプローラー の詳細については、対応する リファレンストピックを参照してください。

    • DataGrip でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。

    • クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。

    • データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。

ステップ -4-run-the-cloud-sql-proxy-client

Cloud SQL Connector forJava との接続の構成

データソースを作成する

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • ファイル | データソース に移動します。

    • データベースエクスプローラー (⌘ 1) ツールバーで、 The Data Sources iconデータソース をクリックします。

    • Ctrl+Alt+Shift+S を押します。

    データソースとドライバーを開くダイアログ
  2. データベースエクスプローラー (⌘ 1) で、ツールバーの 新しいアイコン新規 をクリックし、データソースを作成するデータベースを選択します。

    「データソースの追加」ボタン
  3. 接続タイプ リストで、 URL のみ を選択します。

  4. ドライバー リストで、ドライバーを選択します。

    • PostgreSQL: PostgreSQL (CloudSQL プロキシ)

    • MySQL: MySQL (CloudSQL プロキシ)

    • Microsoft SQL Server : Microsoft SQL Server (CloudSQL プロキシ)

  5. 接続設定エリアの下部に「不足しているドライバーファイルのダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。

    不足しているドライバーファイルのダウンロードリンク
  6. URL フィールドに、次の形式で URL を貼り付けます。

    • PostgreSQL:

      jdbc:postgresql:///<DATABASE_NAME>?cloudSqlInstance=<INSTANCE_CONNECTION_NAME>&user=<USER_NAME>&password=<USER_PASSWORD>
    • MySQL:

      jdbc:mysql:///<DATABASE_NAME>?cloudSqlInstance=<INSTANCE_CONNECTION_NAME>&user=<USER_NAME>&password=<USER_PASSWORD>
    • Microsoft SQL Server :

      jdbc:sqlserver://;databaseName=<DATABASE_NAME>;user=<USER_NAME>;password=<USER_PASSWORD>

    どこ

    • DATABASE_NAME: 接続するデータベース名。

    • INSTANCE_CONNECTION_NAME: インスタンス接続名。 この情報は、インスタンスの 概要 ページにあります。

      概要ページでのインスタンスの接続名
    • USER_NAME: データベースにアクセスできるユーザー名。

    • USER_PASSWORD: ユーザーのパスワード。

    ホストを指定する必要はないことに注意してください。 ドライバに設定したプロパティにより、インスタンスの IP アドレスが自動的に検出されます。

    URL は次のようになります。

    • PostgreSQL:

      jdbc:postgresql:///guest?cloudSqlInstance=crucial-study-301709:us-central1:postgres&user=guest&password=guest
    • MySQL:

      jdbc:mysql:///guest?cloudSqlInstance=mysql-304410:europe-west3:mysql&user=guest&password=guest
    • Microsoft SQL Server :

      jdbc:sqlserver://;databaseName=guest;user=sqlserver;password=guest

    または、 接続タイプ リストで、 デフォルト を選択し、使用可能なフィールドに接続の詳細を入力します。

  7. 接続詳細領域の下部にある 接続のテスト リンクをクリックして、データベースへのテスト接続を開始します。

    テスト接続リンク
  8. 新しいデータソースを保存するには、 OK をクリックします。

PostgreSQL データソース設定

承認されたネットワークへのネットワークの追加

ガイドのこの部分を完了するには、外部 IP アドレスまたは IP アドレスの範囲を知っている必要があります。 CIDR 表記(英語)を使用します(たとえば、 192.168.100.14/24)。

ステップ 1。 承認されたネットワークにネットワークを追加する

  1. CloudSQL インスタンスのページを開きます。

  2. 接続 タブを選択し、 ネットワークを追加する をクリックします。

  3. ネットワーク フィールドに、外部 IP アドレスまたは IP アドレスの範囲を CIDR 表記で入力します。

  4. 終了保存 の順にクリックします。

    インスタンスが更新されるまで待ちます。

    承認されたネットワークにネットワークを追加する

ステップ 2. データソースを作成する

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • ファイル | データソース に移動します。

    • データベースエクスプローラー (⌘ 1) ツールバーで、 The Data Sources iconデータソース をクリックします。

    • Ctrl+Alt+Shift+S を押します。

    データソースとドライバーを開くダイアログ
  2. データソースおよびドライバー ダイアログで、 追加 アイコン(The Add icon )をクリックし、データベースベンダー(たとえば、 PostgreSQL )を選択します。

  3. 接続設定エリアの下部に「不足しているドライバーファイルのダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。

    不足しているドライバーファイルのダウンロードリンク

    ダウンロードされた JDBC ドライバーの場所は DataGrip 構成ディレクトリです。

    提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。

    不足しているドライバーファイルのダウンロード リンクがない場合は、必要なドライバーがすでに存在します。

  4. ホスト フィールドに、PostgreSQL インスタンスの IP アドレスを入力します。 この IP アドレスは、インスタンスの概要ページにあります。

    PostgreSQL インスタンスの IP アドレス
  5. 認証 リストから ユーザーパスワード を選択してください。

  6. ユーザー フィールドに、データベースにアクセスできるユーザー名を入力します。

  7. パスワード フィールドに、ユーザーのパスワードを入力します。

  8. データベース フィールドに、接続先のデータベース名を入力します。

  9. 提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。

    テスト接続リンク

    接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。

  10. (オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがプロジェクトであり、データセットはデータベースであり、スキーマはキースペースであり、名前空間はイントロスペクトされており、使用できます。 他のデータベースとスキーマプロジェクトとデータセット、データベース、スキーマ、共有データベースデータベーススキーマキースペースネームスペースも操作する場合は、「スキーマ 」タブで、イントロスペクションの対象として選択します。

    データソースとドライバーの「スキーマ」タブダイアログ
  11. OK をクリックして、データソースを作成します。

  12. データベースエクスプローラー (⌘ 1) で新しいデータソースを見つけます。

    • データベースエクスプローラー の詳細については、対応する リファレンストピックを参照してください。

    • DataGrip でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。

    • クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。

    • データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。

承認されたネットワークで Cloud SQL に接続する
2026 年 5 月 22 日