データベースを作成して接続する

このページでは、AlloyDB for PostgreSQL で最初のデータベースを作成して接続するプロセスについて説明します。

このクイックスタートの最後にある手順に沿って、この新しいデータベースをクリーンアップします。このページの最後にある次のステップでは、独自のアプリケーションで AlloyDB を使用する方法について説明します。

始める前に

コンソール

  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.

    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.

    Go to project selector

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

  6. AlloyDB for PostgreSQL の作成と接続に必要な Cloud API を有効にします。

    API を有効にする

    1. [プロジェクトを確認] の手順で、[次へ] をクリックして、変更するプロジェクトの名前を確認します。

    2. [API を有効にする] の手順で、[有効にする] をクリックして、次の機能を有効にします。

      • AlloyDB API
      • Compute Engine API
      • Cloud Resource Manager API
      • Service Networking API

      AlloyDB と同じ Google Cloud プロジェクトにある VPC ネットワークを使用して AlloyDB へのネットワーク接続を構成する場合は、Service Networking API が必要です。

      別の Google Cloud プロジェクトにある VPC ネットワークを使用して AlloyDB へのネットワーク接続を構成する場合は、Compute Engine API と Cloud Resource Manager API が必要です。

gcloud

  1. Google Cloud プロジェクトを作成するか、既存のプロジェクトを使用します。

    gcloud projects create PROJECT_ID --set-as-default
# For an existing project
gcloud config set project PROJECT_ID

    次のように置き換えます。

    • PROJECT_ID: プロジェクトの永続的な識別子。

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

  3. AlloyDB、Compute Engine、Resource Manager API を有効にします。

    gcloud services enable alloydb.googleapis.com
gcloud services enable compute.googleapis.com
gcloud services enable cloudresourcemanager.googleapis.com

  4. AlloyDB と同じ Google Cloud プロジェクトにある VPC ネットワークを使用して AlloyDB へのネットワーク接続を構成する場合は、プロジェクトで Service Networking API を有効にします。

    gcloud services enable servicenetworking.googleapis.com

  5. 別の Google Cloud プロジェクトにある VPC ネットワークを使用して AlloyDB へのネットワーク接続を構成する場合は、そのプロジェクトで共有 VPC とプライベート サービスのアクセスを構成できるように、そのプロジェクトの Compute Engine API と Service Networking API が有効になっていることを確認します。

    gcloud services list

クラスタとそのプライマリ インスタンスを作成する

注 : プライベート ネットワーキングを使用する場合は、選択したプライベート ネットワーキング設定と AlloyDB インスタンスの両方を、Compute Engine VM などのクライアントとともに、Terraform を使用してデプロイできます。詳細については、 シンプルな Google Cloud ネットワーキング構成ソリューションをご覧ください。

  1. Google Cloud コンソールで、[クラスタ] ページに移動します。

    クラスタに移動

  2. [クラスタを作成] をクリックします。

  3. [クラスタ ID] に「my-cluster」と入力します。

  4. パスワードを入力します。このパスワードは、このクイックスタートで使用するためメモしておきます。

  5. デフォルトのデータベース バージョンを保持します。

  6. us-central1 (Iowa) リージョンを選択します。

  7. デフォルトのネットワークを選択します。

    限定公開アクセス接続がある場合は、次のステップに進みます。接続が設定されていない場合は、[接続をセットアップ] をクリックし、次の手順を行います。

    1. [IP 範囲を割り振る] で、[自動的に割り振られた IP 範囲を使用する] をクリックします。

    2. [続行]、[接続を作成] の順にクリックします。

  8. デフォルトのインスタンス ID my-cluster-primary を保持します。

  9. [ゾーンの可用性] で、[シングルゾーン] が選択されたままにします。本番環境ではシングルゾーン インスタンスはおすすめしませんが、このクイックスタートではコストを最小限に抑えるためにシングルゾーンを使用します。詳細については、基本インスタンスを使用してコストを削減するをご覧ください。

  10. 2 vCPU, 16 GB マシンタイプを選択します。

  11. [接続] と [ネットワーク セキュリティ] のデフォルト設定をそのまま使用します。

  12. [詳細設定を表示] で変更しないでください。

  13. [CREATE CLUSTER] をクリックします。AlloyDB がクラスタを作成してプライマリ クラスタの [概要] ページに表示するまでに数分かかることがあります。

インスタンスに接続してデータベースを作成する

  1. Google Cloud コンソールで、[クラスタ] ページに移動します。

    クラスタに移動

  2. [リソース名] 列でクラスタ名 my-cluster をクリックします。

  3. ナビゲーション パネルで [AlloyDB Studio] をクリックします。

  4. [AlloyDB Studio にログイン] ページで、次の操作を行います。

    1. postgres データベースを選択します。

    2. postgres ユーザーを選択します。

    3. クラスタとそのプライマリ インスタンスを作成するで作成したパスワードを入力します。

    4. [認証] をクリックします。[エクスプローラ] ペインに、postgres データベース内のオブジェクトのリストが表示されます。

  5. データベースを作成するには、[Editor 1] タブに次のステートメントを入力し、[実行] をクリックします。

    CREATE DATABASE guestbook;

    [結果] ペインに Statement executed successfully メッセージが表示されたら、データベースが作成されています。

guestbook データベースに接続する

  1. Google Cloud コンソールで、[クラスタ] ページに移動します。

    クラスタに移動

  2. [リソース名] 列でクラスタ名 my-cluster をクリックします。

  3. ナビゲーション パネルで [AlloyDB Studio] をクリックします。

  4. [AlloyDB Studio にログイン] ページで、次の操作を行います。

    1. guestbook データベースを選択します。

    2. postgres ユーザーを選択します。

    3. クラスタとそのプライマリ インスタンスを作成するで作成したパスワードを入力します。

    4. [認証] をクリックします。[エクスプローラ] ペインに、guestbook データベース内のオブジェクトのリストが表示されます。

データベース接続を確認する

  1. guestbook データベースに接続するの手順に沿って操作します。

  2. guestbook データベースにサンプルデータを挿入するには、[Editor 1] タブに次のように入力します。

    CREATE TABLE entries (guestName VARCHAR(255),
                      content VARCHAR(255),
                      entryID SERIAL PRIMARY KEY);
INSERT INTO entries (guestName, content) values ('Alex', 'I got here!');
INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');

  3. [実行] をクリックします。[結果] ペインに Statement executed successfully メッセージが表示されたら、データがデータベースに挿入されています。

  4. 別のコマンドを実行できるように、[Editor 1] タブからテキストを削除するには、[クリア] をクリックします。

  5. データベース内のすべてのエントリを選択するには、[エディタ 1] タブに次のクエリを入力します。

    SELECT * FROM entries;

  6. [実行] をクリックします。[結果] ペインに次のような出力が表示されます。

        guestname     | content     | entryid
    --------------+-------------+---------
    Alex          | I got here! | 1
    Kai           | Me too!     | 2

クリーンアップ

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

  1. Google Cloud コンソールで、[クラスタ] ページに移動します。

    クラスタに移動

  2. [リソース名] 列でクラスタ名 my-cluster をクリックします。

  3. [クラスタを削除] をクリックします。

  4. Delete cluster my-cluster で my-cluster を入力して、クラスタの削除を確認します。

  5. [削除] をクリックします。

  6. クラスタを作成するときにプライベート接続を作成した場合は、 Google Cloud コンソールの[Networking] ページに移動し、[Delete VPC network] をクリックします。

次のステップ