Cloud SQL Auth Proxy を使用して Cloud SQL for SQL Server に接続する

Cloud SQL Auth Proxy を使用して Cloud SQL for SQL Server に接続する

MySQL   |  PostgreSQL   |  SQL Server

このページでは、Cloud SQL Auth Proxy を使用して、ローカルテスト環境から Cloud SQL に接続する方法を示します。Cloud SQL Auth Proxy を使用すると、承認済みネットワークや SSL の構成を必要とせずに、安全に Cloud SQL インスタンスへアクセスできます。Cloud SQL Auth Proxy を使用すると、Cloud SQL インスタンスに安全に接続できます。

このページの手順はテスト環境専用です。本番環境では使用しないでください。本番環境に必要な構成の詳細については、本番環境で Cloud SQL Auth Proxy を使用すると Cloud SQL Auth Proxy を使用して接続するをご覧ください。

始める前に

注: プロジェクトに使用する名前は 4～30 文字にする必要があります。名前を入力すると、フォームにプロジェクト ID の候補が示されます。これは編集できます。プロジェクト ID は 6～30 文字で、先頭を小文字にします。残りの文字には、ダッシュ、小文字、数字を使用できますが、最後の文字にダッシュは使えません。

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. 必要な Google Cloud APIs を有効にします。

   コンソール

   Google Cloud コンソールの [API] ページに移動します。

   [API] に移動

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

   gcloud

   次のボタンをクリックして Cloud Shell を開きます。これにより、ブラウザから Google Cloud リソースにコマンドラインで直接アクセスできます。Cloud Shell を使用して、このクイックスタートで紹介する gcloud コマンドを実行できます。

   Cloud Shell を開く

   Cloud Shell を使用して、次のように gcloud services enable コマンドを実行し、このクイックスタートに必要な API を有効にします。

   gcloud services enable sqladmin.googleapis.com

   このコマンドにより、次の API が有効になります。

   • Cloud SQL Admin API

Cloud SQL インスタンスを作成する

このクイックスタートでは、Google Cloud コンソールを使用します。gcloud CLI、cURL、PowerShell を使用するには、インスタンスの作成をご覧ください。

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. [インスタンスを作成] をクリックします。
3. [SQL Server を選択] をクリックします。
4. [インスタンス ID] フィールドに「myinstance」と入力します。
5. [パスワード] フィールドに、sqlserver ユーザーのパスワードを入力します。

6. [インスタンスを作成] をクリックします。

   インスタンスのリストに戻ります。新しいインスタンスをすぐにクリックして詳細を表示できますが、初期化と起動が完了するまで他のオペレーションには使用できません。

   注: この例では、デフォルトの設定を使用してパブリック IP アドレスを含むインスタンスを作成しています。

Debian、Ubuntu

Debian / Ubuntu については、こちらの手順を使用して、該当する SQL Server コマンドライン ツールをインストールします。

CentOS / RHEL

CentOS / RHEL については、こちらの手順を使用して、該当する SQL Server コマンドライン ツールをインストールします。

openSUSE

openSUSE については、こちらの手順を使用して、該当する SQL Server コマンドライン ツールをインストールします。

他のプラットフォーム

SQL サーバーをインストールするためのランディング ページと、SQL Server のダウンロード ページをご覧ください。

Cloud SQL Auth Proxy クライアントをインストールする

インストールについては、Cloud SQL Auth Proxy のインストールをご覧ください。

インスタンス接続名を取得する

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. インスタンス名をクリックして [概要] ページを開きます。
3. [このインスタンスと接続] セクションで接続名をコピーします。接続名の形式は projectID:region:instanceID です。

Cloud SQL Auth Proxy を起動する

専用のターミナルで Cloud SQL Auth Proxy を起動して、その出力をモニタリングできるようにします。INSTANCE_CONNECTION_NAME を、前のステップでコピーしたインスタンス接続名に置き換えます。

Linux 環境の場合は、次のコマンドを使用して Cloud SQL Auth Proxy を起動します。

./cloud-sql-proxy INSTANCE_CONNECTION_NAME

Windows の PowerShell では、次のコマンドを使用して Cloud SQL Auth Proxy を起動します。

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

次のようなメッセージが表示されます。

Listening on 127.0.0.1:1433 for INSTANCE_CONNECTION_NAME
Ready for new connections

次のコマンドを実行します。USER_NAME は SQL Server のユーザー名に置き換えます。

sqlcmd -S 127.0.0.1 -U USER_NAME

Cloud SQL Auth Proxy を起動したターミナル ウィンドウに戻ります。次のようなメッセージが表示されます。

New connection for myInstance

クリーンアップ

このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の操作を行います。

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. myinstance インスタンスを選択して [インスタンスの詳細] ページを開きます。
3. ページ上部にあるアイコンバーで、[削除] をクリックします。
4. インスタンスの削除ウィンドウでインスタンスの名前を入力し、[削除] をクリックします。

省略可能なクリーンアップ手順

このクイックスタートで有効にした API を使用しない場合は、無効にすることができます。

• このクイックスタートで有効にした API:
  • Cloud SQL Admin API

1. Google Cloud コンソールの [API] ページに移動します。

   [API] に移動

2. Cloud SQL Admin API を選択し、[API を無効にする] ボタンをクリックします。

次のステップ

• Cloud SQL Auth Proxy のトラブルシューティングを確認する。

• Cloud SQL Auth Proxy の詳細を確認する。