外部アプリケーションから Cloud SQL に接続する

MySQL | PostgreSQL | SQL Server

このページでは、Google Cloud の外部で実行されるアプリケーションから Cloud SQL への接続を確立する方法について説明します。

データベース接続は、サーバーと接続元アプリケーションのリソースを消費します。アプリケーションのフットプリントを最小限に抑え、Cloud SQL の接続制限を超える可能性を少なくするには、常に適切な接続管理方法を採用してください。詳細については、データベース接続の管理をご覧ください。

始める前に

アプリケーションへのアクセスを付与しても、データベースユーザーアカウントがインスタンスに自動的に接続できるようになるわけではありません。インスタンスに接続するには、接続に使用できるデータベースユーザーアカウントが必要です。新しいインスタンスの場合、デフォルトのユーザーアカウントを構成しておく必要があります。詳細についてはこちらをご覧ください。

接続オプション

次の表は、外部アプリケーションから Cloud SQL インスタンスに接続するためのオプションを比較したものです。

接続オプション	セキュリティ、暗号化	詳細	注
パブリック IP アドレス、SSL あり	○	インスタンス用に SSL を構成する IP 接続のためのアクセスを構成する SSL を使用して PSQL クライアントを接続する	SSL 証明書管理が必要。
パブリック IP アドレス、SSL なし	×	IP 接続のためのアクセスを構成する	本番インスタンスには推奨されません。
Cloud SQL Proxy	○	Cloud SQL Proxy を使用して外部アプリケーションから接続する Cloud SQL Proxy を使用して PSQL クライアントを接続する Cloud SQL Proxy について
Cloud SQL Proxy Docker イメージ	○	Cloud SQL Proxy Docker イメージを使用して PSQL クライアントを接続する Cloud SQL Proxy について
JDBC ソケットライブラリ	○	Java による外部接続 JDBC ソケットファクトリに関する GitHub のページ	Java プログラミング言語のみ。
Go Proxy ライブラリ	○	Go による外部接続 Cloud SQL Proxy に関する GitHub のページ	Go プログラミング言語のみ。
Cloud Shell	×	Cloud Shell で PSQL クライアントを使用する	Cloud SQL Proxy を使用して Google Cloud Console から接続します。`psql` コマンドラインツールを必要とする管理タスクに最適です。
Apps Script	○	Apps Script による外部接続 Apps Script のサンプルに関する GitHub のページ	Apps Script は、標準の Java データベース接続テクノロジーのラッパーである JDBC サービスを介して外部データベースに接続できます。

プロキシを使用して外部アプリケーションから接続する

ローカルテスト環境用（本番環境用ではなく）に Cloud SQL Proxy を設定する場合は、これらの手順の代わりにプロキシクイックスタートを使用してください。

Java または Go プログラミング言語を使用している場合、Cloud SQL Proxy を使用する以外の代替手段がいくつかあります。詳細についてはこちらをご覧ください。

1. API を有効化する

Cloud SQL Admin API を有効にします。

API を有効にする

2. ローカルマシンにプロキシクライアントをインストールする

Linux 64 ビット

プロキシをダウンロードします。

wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy

プロキシを実行できるようにします。
```
chmod +x cloud_sql_proxy
```

Linux 32 ビット

プロキシをダウンロードします。

wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy

プロキシを実行できるようにします。
```
chmod +x cloud_sql_proxy
```

macOS 64 ビット

プロキシをダウンロードします。

curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64

プロキシを実行できるようにします。
```
chmod +x cloud_sql_proxy
```

macOS 32 ビット

プロキシをダウンロードします。

curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386

プロキシを実行できるようにします。
```
chmod +x cloud_sql_proxy
```

Windows 64 ビット

https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe を右クリックして [名前を付けてリンク先を保存] を選択し、プロキシをダウンロードします。ファイル名を cloud_sql_proxy.exe に変更します。

Windows 32 ビット

https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe を右クリックして [名前を付けてリンク先を保存] を選択し、プロキシをダウンロードします。ファイル名を cloud_sql_proxy.exe に変更します。

お使いのオペレーティングシステムがここに記載されていない場合は、ソースからプロキシをコンパイルすることもできます。

3. プロキシを認証する方法を決定する

プロキシ認証オプションの詳細については、こちらをご覧ください。

4. 認証方法で必要な場合は、サービスアカウントを作成する

注: サービスアカウントを作成して必要な権限を割り当てるには、resourcemanager.projects.setIamPolicy 権限が必要です。この権限は、プロジェクト所有者、プロジェクト IAM 管理者、組織管理者の役割に含まれています。
また、Cloud SQL Admin API を有効にする必要があります。

サービスアカウントを使用してプロキシの認証情報を提示する場合は、十分な権限が付与されたサービスアカウントを作成する必要があります。よりきめ細かい Identity Access and Management（IAM）のロールを使用して Cloud SQL 権限を管理する場合は、サービスアカウントに cloudsql.instances.connect 権限を含むロールを付与する必要があります。この権限を含む事前定義された Cloud SQL のロールは次のとおりです。

Cloud SQL クライアント
Cloud SQL 編集者
Cloud SQL 管理者

以前のプロジェクトのロール（閲覧者、編集者、オーナー）を使用する場合、サービスアカウントには少なくとも編集者のロールが付与されている必要があります。

Google Cloud Console の [サービスアカウント] ページに移動します。
[サービスアカウント] ページに移動
Cloud SQL インスタンスを含むプロジェクトを選択します。
[サービスアカウントを作成] をクリックします。
[サービスアカウントの作成] ダイアログで、わかりやすいサービスアカウント名を指定します。
[役割] で、次のいずれかの役割を選択します。
- [Cloud SQL] > [Cloud SQL クライアント]
- [Cloud SQL] > [Cloud SQL 編集者]
- [Cloud SQL] > [Cloud SQL 管理者]
または、[プロジェクト] > [編集者] の順に選択して、基本的な編集者のロールを使用することもできますが、編集者のロールには Google Cloud 全体に対する権限が含まれています。

これらの役割が表示されない場合、Google Cloud ユーザーに resourcemanager.projects.setIamPolicy 権限がない可能性があります。権限を確認するには、Google Cloud Console の IAM ページにアクセスし、自分のユーザー ID を検索します。
[サービスアカウント ID] を一意のわかりやすい値に変更します。
[新しい秘密鍵の提供] をクリックし、キーのタイプが JSON であることを確認します。
[作成] をクリックします。
秘密鍵ファイルがマシンにダウンロードされます。秘密鍵ファイルは、別の場所に移動できます。安全な場所に鍵ファイルを保管してください。

5. プロキシに対するインスタンスの指定方法を決定する

プロキシインスタンス指定オプションの詳細については、こちらをご覧ください。

6. プロキシを開始する

プロキシに渡すオプションは、前に選択した認証とインスタンス指定のオプションによって異なります。

言語や環境に応じて、TCP ソケットまたは Unix ソケットのどちらかを使用してプロキシを開始できます。

TCP ソケット

[インスタンスの詳細] ページからインスタンス接続名をコピーします。

例: myproject:myregion:myinstance。
サービスアカウントを使用してプロキシを認証する場合は、サービスアカウントを作成したときに作成された秘密鍵ファイルのクライアントマシン上での場所を記録しておきます。
プロキシを開始します。
考えられるプロキシ呼び出し文字列を以下にいくつか示します。
- Cloud SDK 認証を使用する場合
```
./cloud_sql_proxy -instances=<INSTANCE_CONNECTION_NAME>=tcp:5432
```
  指定されたポートは、ローカルデータベースサーバーなどがまだ使用していないものにする必要があります。
- サービスアカウントを使用して、インスタンス接続の名前を明示的に指定する場合（本番環境用に推奨）:
```
./cloud_sql_proxy -instances=<INSTANCE_CONNECTION_NAME>=tcp:5432 \
                  -credential_file=<PATH_TO_KEY_FILE> &
```
プロキシオプションの詳細については、プロキシを認証するためのオプションとインスタンスを指定するためのオプションをご覧ください。

Unix ソケット

明示的なインスタンス指定を使用する場合は、[インスタンスの詳細] ページからインスタンス接続名をコピーします。
プロキシソケットを格納するディレクトリを作成します。
```
sudo mkdir /cloudsql; sudo chmod 777 /cloudsql
```
サービスアカウントを使用してプロキシを認証する場合は、サービスアカウントを作成したときに作成された秘密鍵ファイルのクライアントマシン上での場所を記録しておきます。
新しいターミナルウィンドウを開き、プロキシを開始します。
考えられるプロキシ呼び出し文字列を以下にいくつか示します。
- サービスアカウントを使用して、インスタンス接続の名前を明示的に指定する場合（本番環境用に推奨）:
```
./cloud_sql_proxy -dir=/cloudsql -instances=<INSTANCE_CONNECTION_NAME> \
                  -credential_file=<PATH_TO_KEY_FILE> &
```
- Cloud SDK 認証と自動インスタンス検出を使用する場合
```
./cloud_sql_proxy -dir=/cloudsql &
```
専用のターミナルでプロキシを開始することが最善です。この場合、他のプログラムからの出力と混ざることなく出力をモニタリングできます。

プロキシオプションの詳細については、プロキシを認証するためのオプションとインスタンスを指定するためのオプションをご覧ください。
Unix ソケットを使用して Cloud SQL Proxy を使用する Cloud SQL に接続する場合、ソケットのファイル名の長さがシステムの上限を超えていないことを確認してください。システムによって異なりますが、通常は 91～108 文字です。Linux では、この長さが通常 108 文字と定義され、次のコマンドで確認できます。
cat /usr/include/linux/un.h | grep "define UNIX_PATH_MAX"

7. プロキシを使用して Cloud SQL に接続するようにアプリケーションを更新する

プロキシを使用して Cloud SQL インスタンスに接続するために必要なコードの文の細部は、使用する言語とフレームワークによって異なります。

プロキシへの接続には、TCP や Unix ソケットの場合と同じ方法を使用します。ただし、プロキシの呼び出し方法によって異なります。

TCP ソケット

TCP ソケットでは、プロキシをローカルホストとして使用できます。

127.0.0.1:5432

Unix ソケット

Unix ソケットでは、次のパスを使用してプロキシを使用できます。

PROXY_PATH/INSTANCE_CONNECTION_NAME;

PROXY_PATH は、プロキシを開始するときに -dir オプションで設定したディレクトリへのパスです。このドキュメントの例では、/cloudsql を使用します。インスタンスの接続名を見つけるには、Google Cloud Console のその [インスタンスの詳細] ページで、または PROJECT-ID:REGION:INSTANCE_NAME を使用します。

お困りの場合、プロキシのトラブルシューティングについては、Cloud SQL Proxy 接続のトラブルシューティングをご覧ください。または、Cloud SQL のサポートページをご覧ください。

言語固有の情報と例

Unix または TCP ソケットに接続できる任意の言語を使用して、プロキシに接続できます。アプリケーションでどのように連携するのかを把握できるように、プロキシの呼び出しと接続ステートメントの例をいくつか次に紹介します。

.NET

プロキシを開始したら、appsettings.json ファイルを作成し、CloudSql:ConnectionString で接続文字列を定義します。例:

{
  "CloudSQL" : {
     ConnectionString": "Host=127.0.0.1;Uid=DATABASE_USER;Pwd=PASSWORD;Database=DATABASE_NAME"
  }
}

次に、Startup.cs で、データベース接続を作成します。

var connectionString = new NpgsqlConnectionStringBuilder(
    Configuration["CloudSql:ConnectionString"])
{
    // Connecting to a local proxy that does not support ssl.
    SslMode = SslMode.Disable
};
NpgsqlConnection connection =
    new NpgsqlConnection(connectionString.ConnectionString);

Go

Go プログラミング言語では、次の 2 通りの方法で Cloud SQL Proxy を使用できます。

Go Proxy ライブラリを使用する
Proxy をコンパニオンプロセスとして実行する

Go Proxy ライブラリ

ライブラリを使用する場合、プロキシを独自のプロセスとして明示的に開始する必要がないため、Go プログラムから Cloud SQL に接続するにはこれが最も簡単な方法です。

import (
    "github.com/GoogleCloudPlatform/cloudsql-proxy/proxy/dialers/postgres"
)
...
dsn := fmt.Sprintf("host=%s dbname=%s user=%s password=%s sslmode=disable",
                   INSTANCE_CONNECTION_NAME,
                   DATABASE_NAME,
                   DATABASE_USER,
                   PASSWORD)
db, err := sql.Open("cloudsqlpostgres", dsn)

詳しくは、Cloud SQL Proxy の Github ページをご覧ください。

コンパニオンプロセス

また、プロキシをコンパニオンプロセスとして実行し、アプリケーションから接続することもできます。

わかりやすいように、このプロキシ呼び出しステートメントではローカル Cloud SDK 認証を使用しています。実際の呼び出しステートメントは、認証方法やインスタンスの指定方法によって異なる場合があります。Cloud SQL Proxy を認証するためのオプションをご覧ください。

TCP ソケット

プロキシ呼び出しステートメント:

./cloud_sql_proxy -instances=[INSTANCE_CONNECTION_NAME]=tcp:5432 &

接続ステートメント:

import (
       "database/sql"
        _ "github.com/lib/pq"
)

dsn := fmt.Sprintf("host=localhost port=5432 user=%s password=%s dbname=%s sslmode=disable",
       DATABASE_USER,,
       PASSWORD,
       DATABASE_NAME)
db, err := sql.Open("postgres", dsn)

Unix ソケット

プロキシ呼び出しステートメント:

./cloud_sql_proxy -instances=[INSTANCE_CONNECTION_NAME] -dir=/cloudsql &

接続ステートメント:

import (
       "database/sql"
        _ "github.com/lib/pq"
)

dsn := fmt.Sprintf("host=/cloudsql/%s user=%s password=%s dbname=%s sslmode=disable",
       INSTANCE_CONNECTION_NAME,
       DATABASE_USER,
       PASSWORD,
       DATABASE_NAME)
db, err := sql.Open("postgres", dsn)

Java

Java プログラミング言語では、Unix ソケットの組み込みサポートは提供されていません。TCP ソケット、または Cloud SQL Proxy との UNIX ソケットサポートを提供するライブラリを使用できますが、承認済みネットワークアドレスを追加することなく PostgreSQL インスタンスに接続する最も簡単な方法は、JDBC ソケットファクトリを使用することです。

JDBC ソケットファクトリは、クライアント側プロキシソフトウェアの代わりとなるもので、Cloud SQL Proxy と同様に、Cloud SQL Admin API を有効にする必要があります。ソケットファクトリは、プロキシと同じレベルの暗号化を提供し、Cloud SDK 認証情報を使用して認証します。ソケットファクトリを使用する前に、Cloud SDK をインストールして認証する必要があります。

コードのサンプルについては、JDBC ドライバ用の Cloud SQL ソケットファクトリをご覧ください。手順については、README をご覧ください。

PHP

PDO と TCP

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:5432 &

次の例では、PHP Data Objects（PDO）を使用して Cloud SQL に接続します。

// Use a Data source name (DSN) to connect to Cloud SQL through the proxy
$dsn = 'pgsql:host=127.0.0.1;port=5432;dbname=DATABASE_NAME';
// Instantiate your DB using the DSN, username, and password
$dbUser = 'DATABASE_USER';
$dbPass = 'PASSWORD';
$db = new PDO($dsn, $dbUser, $dbPass);

PDO と Unix ソケット

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME -dir=/cloudsql &

次の例では、PDO を使用して Cloud SQL に接続します。

// Use a Data source name (DSN) to connect to Cloud SQL through the proxy
$dsn = 'pgsql:host=/cloudsql/INSTANCE_CONNECTION_NAME;dbname=DATABASE_NAME';
// Instantiate your DB using the DSN, username, and password
$dbUser = 'DATABASE_USER';
$dbPass = 'PASSWORD';
$db = new PDO($dsn, $dbUser, $dbPass);

PGSQL と TCP

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:5432 &

次の例では、PGSQL を使用して Cloud SQL に接続します。

// Instantiate your DB using the database host, port, name, username, and password
$conn = pg_connect(sprintf('host=127.0.0.1 port=5432 dbname=%s user=%s password=%s',
    'DATABASE_NAME',
    'DATABASE_USER',
    'PASSWORD'
));

PGSQL と Unix ソケット

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME -dir=/cloudsql &

次の例では、PGSQL を使用して Cloud SQL に接続します。

// Instantiate your DB using the database name, socket, username, and password
$conn = pg_connect(sprintf('host=/cloudsql/%s dbname=%s user=%s password=%s',
    'INSTANCE_CONNECTION_NAME',
    'DATABASE_NAME',
    'DATABASE_USER',
    'PASSWORD'
));

Python

わかりやすいように、このプロキシ呼び出しステートメントではローカル Cloud SDK 認証を使用しています。実際の呼び出しステートメントは、認証方法やインスタンスの指定方法によって異なる場合があります。詳細

Psycopg2 と TCP

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:5432 &

接続ステートメント:

import psycopg2
conn = psycopg2.connect(user=DATABASE_USER, password=PASSWORD,
                        host='localhost', port='5432')

Psycopg2 と Unix

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME -dir=/cloudsql &

接続ステートメント:

import psycopg2
conn = psycopg2.connect(user=DATABASE_USER, password=PASSWORD,
host='/cloudsql/INSTANCE_CONNECTION_NAME')

SQLAlchemy と TCP

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:5432 &

接続ステートメント:

from sqlalchemy import create_engine
engine = create_engine('postgresql+psycopg2://DATABASE_USER:PASSWORD@localhost:5432/')

SQLAlchemy と Unix

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME -dir=/cloudsql &

接続ステートメント:

from sqlalchemy import create_engine
engine = create_engine('postgresql+psycopg2://DATABASE_USER:PASSWORD@/?host=/cloudsql/INSTANCE_CONNECTION_NAME')

Ruby

Ruby pg と TCP

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:5432 &

次の例では、Ruby pg RubyGem を使用して Cloud SQL に接続します。

require "pg"
begin
    con = PG.connect host: "127.0.0.1", port: 5432,
        dbname: "DATABASE_NAME", user: "DB_USER",
        password: "PASSWORD"
    puts con.server_version
rescue PG::Error => e
    puts e.message
ensure
    con.close if con
end

Ruby pg と Unix ソケット

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME -dir=/cloudsql &

次の例では、Ruby pg RubyGem を使用して Cloud SQL に接続します。

require "pg"
begin
    con = PG.connect host: "/cloudsql/CONNECTION_NAME",
        dbname: "DATABASE_NAME", user: "DB_USER",
        password: "PASSWORD"
    puts con.server_version
rescue PG::Error => e
    puts e.message
ensure
    con.close if con
end

Rails と TCP

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:5432 &

config/databases.yml では、次の構成を使用します。

postgresql_settings: &postgresql_settings
  adapter: postgresql
  encoding: unicode
  pool: 5
  username: DATABASE_USER
  password: PASSWORD
  database: DATABASE_NAME
  host: 127.0.0.1:5432

Rails と Unix ソケット

プロキシを呼び出します。

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME -dir=/cloudsql &

config/databases.yml では、次の構成を使用します。

postgresql_settings: &postgresql_settings
  adapter: postgresql
  encoding: unicode
  pool: 5
  username: DATABASE_USER
  password: PASSWORD
  database: DATABASE_NAME
  socket: /cloudsql/INSTANCE_CONNECTION_NAME

パブリック IP 接続のアクセスを構成する

アプリケーションが接続に使用するパブリック IP アドレスを承認することで、Cloud SQL インスタンスへのアクセスをアプリケーションに許可できます。

承認済みネットワークとしてプライベートネットワーク（10.x.x.x など）を指定することはできません。

PostgreSQL インスタンスは IPv4 アドレスのみをサポートします。これらは自動的に静的 IP アドレスで構成されます。

パブリック IP 接続によるアクセスを構成するには、次の手順を行います。

Console

アプリケーションの IP アドレスを確認します。詳細
アプリケーションの IP アドレスを承認して、インスタンスに接続します。
詳しくは、承認されたアドレスを追加するをご覧ください。
インスタンスに割り当てられた IP アドレスは [インスタンスの詳細] ページで確認できます。この値は、アプリケーションの接続文字列に必要となります。

gcloud

クライアントマシンの IP アドレスを確認します。詳細
アプリケーションの IP アドレスを承認して、インスタンスに接続します。
詳しくは、承認されたアドレスを追加するをご覧ください。
インスタンスの IP アドレスを取得します。
```
gcloud sql instances describe [INSTANCE_NAME]
```
出力の ipAddress フィールドを探します。この値は、アプリケーションの接続文字列に必要となります。

REST v1beta4

アプリケーションの IP アドレスを確認します。詳細
アプリケーションの IP アドレスを承認して、インスタンスに接続します。
詳しくは、承認されたアドレスを追加するをご覧ください。

インスタンスの IP アドレスを取得します。

後述のリクエストデータは、次のように置き換えてから使用します。

project-id: プロジェクト ID
instance-id: インスタンス ID

HTTP メソッドと URL:

GET https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 以下のコマンドでは、ご利用のユーザーアカウントで gcloud を認証する際に gcloud init または gcloud auth login を使用していることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_5_7",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-f1-micro",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "asia-east1-a",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "08:00",
      "kind": "sql#backupConfiguration",
      "enabled": true,
      "binaryLogEnabled": true
    },
    "settingsVersion": "13",
    "storageAutoResizeLimit": "0",
    "storageAutoResize": true,
    "dataDiskSizeGb": "10"
  },
  "etag": "etag-id",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    "kind": "sql#sslCert",
    "certSerialNumber": "0",
    "cert": "certificate-id",
    "commonName": "C=US,O=Google\\, Inc,CN=Google Cloud SQL Server CA,dnQualifier=dn-qualifier-id",
    "sha1Fingerprint": "sha-id",
    "instance": "instance-id",
    "createTime": "2019-06-28T22:46:35.052Z",
    "expirationTime": "2029-06-25T22:47:35.052Z"
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "project-id",
  "serviceAccountEmailAddress": "service-acct-id@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "backendType": "SECOND_GEN",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "connectionName": "project-id:region:instance-id",
  "name": "instance-id",
  "region": "asia-east1",
  "gceZone": "asia-east1-a"
}

ipAddresses.ipAddress の値をメモします。この値は、アプリケーションの接続文字列に必要となります。

IP アドレスが動的に割り当てられるアプリケーションのアクセスを構成する

一部のアプリケーションでは、動的に割り当てられる一時的な IP アドレスを使用して、Cloud SQL インスタンスに接続する必要があります。これは、特に Platform as a Service（Paas）アプリケーションの場合に該当します。

この場合、Cloud SQL Proxy を使用する必要があります。

接続をテストする

PSQL クライアントを使用して、ローカル環境から接続できるかどうかテストできます。詳細については、IP アドレスを使用して PSQL クライアントを接続すると Cloud SQL Proxy を使用して PSQL クライアントを接続するをご覧ください。

アプリケーションの IP アドレスを確認する

アプリケーションを実行しているパソコンの IP アドレスから Cloud SQL インスタンスへのアクセスを承認できるようにするため、そのパソコンの IP アドレスを確認するには、次のいずれかのオプションを使用します。

パソコンがプロキシの背後にない場合は、パソコンにログインし、このリンクを使用して IP アドレスを確認します。
パソコンがプロキシの背後にある場合は、パソコンにログインし、whatismyipaddress.com などのサービスやツールを使用して実際の IP アドレスを確認します。

次のステップ

アプリケーションでデータベース接続を管理する方法を学習します。
外部アプリケーション用の接続オプションについて学習します。
PSQL クライアントを使用して接続する方法の詳細を確認します。
IP 接続を構成する方法を学習します。
プロキシについて学習します。
サポート用オプションについて学習します。

外部アプリケーションから Cloud SQL に接続する

始める前に

接続オプション

プロキシを使用して外部アプリケーションから接続する

1. API を有効化する

2. ローカルマシンにプロキシ クライアントをインストールする

Linux 64 ビット

Linux 32 ビット

macOS 64 ビット

macOS 32 ビット

Windows 64 ビット

Windows 32 ビット

3. プロキシを認証する方法を決定する

4. 認証方法で必要な場合は、サービス アカウントを作成する

5. プロキシに対するインスタンスの指定方法を決定する

6. プロキシを開始する

TCP ソケット

Unix ソケット

7. プロキシを使用して Cloud SQL に接続するようにアプリケーションを更新する

TCP ソケット

Unix ソケット

言語固有の情報と例

.NET

Go

Go Proxy ライブラリ

コンパニオン プロセス

TCP ソケット

Unix ソケット

Java

PHP

PDO と TCP

PDO と Unix ソケット

PGSQL と TCP

PGSQL と Unix ソケット

Python

Psycopg2 と TCP

Psycopg2 と Unix

SQLAlchemy と TCP

SQLAlchemy と Unix

Ruby

Ruby pg と TCP

Ruby pg と Unix ソケット

Rails と TCP

Rails と Unix ソケット

パブリック IP 接続のアクセスを構成する

Console

gcloud

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

IP アドレスが動的に割り当てられるアプリケーションのアクセスを構成する

接続をテストする

アプリケーションの IP アドレスを確認する

次のステップ

2. ローカルマシンにプロキシクライアントをインストールする

4. 認証方法で必要な場合は、サービスアカウントを作成する

コンパニオンプロセス