Cloud SQL for PostgreSQL のクイックスタート

このページでは、PostgreSQL インスタンスを作成して接続し、Google Cloud Console とクライアントを使用して基本的な SQL オペレーションを実行する方法を説明します。このクイックスタートで作成されるリソースにかかる費用は、クリーンアップを含む手順を適切なタイミングで完了した場合、通常 1 ドル未満です。

始める前に

  1. Google アカウントにログインします。

    Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    [プロジェクトの選択] ページに移動

  3. Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する。

インスタンスの作成

この手順では、Cloud Console を使用します。gcloud または cURL を使用するには、インスタンスの作成をご覧ください。

  1. Google Cloud Console の Cloud SQL インスタンス ページに移動します。

    Cloud SQL インスタンス ページに移動

  2. プロジェクトを選択し、[続行] をクリックします。

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

  4. [PostgreSQL] をクリックします。

  5. [インスタンス ID] に「myinstance」と入力します。

  6. postgres ユーザーのパスワードを入力します。

  7. 他のフィールドはデフォルト値を使用します。

  8. [作成] をクリックします。

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

Cloud Shell での PSQL クライアントを使用したインスタンスへの接続

  1. Google Cloud Console で、右上隅の Cloud Shell アイコン（Cloud Shell アイコン）をクリックします。

    Cloud Shell の初期化が完了すると、次のように表示されます。

    Welcome to Cloud Shell! Type "help" to get started.
username@example-id:~$

  2. Cloud Shell プロンプトで、Cloud SQL インスタンスに接続します。

    gcloud sql connect myinstance --user=postgres

  3. postgres のパスワードを入力します。

    psql のプロンプトが表示されます。

データベースの作成とデータのアップロード

  1. Cloud SQL インスタンスに SQL データベースを作成します。 
    CREATE DATABASE guestbook;
  2. データベースに接続します。
    \connect guestbook;
  3. データベースにサンプルデータを挿入します。
    CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                        entryID SERIAL PRIMARY KEY);
INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');
  4. データを取得します。
    SELECT * FROM entries;
    結果は次のとおりです。 
      guestname   |   content   | entryid
--------------+-------------+---------
 first guest  | I got here! |       1
 second guest | Me too!     |       2
(2 rows)
postgres=>

クリーンアップ

このクイックスタートで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を行います。

  1. Google Cloud Console の Cloud SQL インスタンス ページに移動します。
    [Cloud SQL インスタンス] ページに移動
  2. myinstance インスタンスを選択して [インスタンスの詳細] ページを開きます。
  3. ページ上部にあるアイコンバーで、[削除] をクリックします。

  4. [インスタンスの削除] ウィンドウで「myinstance」と入力してから、[削除] をクリックしてインスタンスを削除します。

    インスタンスの削除後、約 7 日はそのインスタンス名を再利用できません。

次のステップ

必要に応じて、詳細についてはCloud SQL インスタンスの作成をご覧ください。

Cloud SQL インスタンスの PostgreSQL ユーザーとデータベースの作成についても学習できます。

Cloud SQL の料金情報もご覧ください。

このクイックスタートでは、Cloud Shell を使用してインスタンスに接続します。ほとんどのユースケースで、接続方法は次のようなネットワーク構成によって異なります。

  • Cloud SQL インスタンスにパブリック IP アドレスまたはプライベート IP アドレスがある場合。
  • Google Cloud の内側から（同じプロジェクト、または別のプロジェクトから）接続している場合。
  • Google Cloud の外側から接続している場合。

以下の詳細を確認する

また、他の Google Cloud アプリケーションから Cloud SQL インスタンスへの接続についても確認できます。