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

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

プロジェクトを設定する

このクイックスタートの手順を行う前に、次のタスクを完了します。

  1. Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

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

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

    プロジェクト セレクタに移動

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

  6. ユーザー アカウントに Cloud SQL 管理者の役割があることを確認します。
    • [IAM] ページに移動します。 IAM ページに移動
    • [Add] をクリックします。
    • [New Principles] で、ユーザー アカウント名を追加します。
    • [ロールを選択] で、[Cloud SQL 管理者] をフィルタして、リストから選択します。
    • [保存] をクリックします。
  7. Cloud SQL Admin API を有効にします。

    API を有効にする

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

この手順では、Google Cloud Console を使用します。gcloud コマンドライン ツール、cURL、または PowerShell を使用するには、インスタンスの作成をご覧ください。

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

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

  2. [インスタンスを作成] をクリックします。
  3. [PostgreSQL] をクリックします。
  4. Compute API を有効にするように求められたら、[API を有効にする] ボタンをクリックします。
  5. [インスタンス ID] に「myinstance」と入力します。
  6. postgres ユーザーのパスワードを入力します。
  7. 他のフィールドはデフォルト値を使用します。
  8. [作成] をクリックします。

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

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

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=>
    

クリーンアップ

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

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

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

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

次のステップ

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

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

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

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

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

以下の詳細を確認する

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