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

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

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

このクイックスタートの最後では、ここで作成したデータベースをクリーンアップする手順を説明します。このページの最後にある「次のステップ」では、独自のアプリケーションで AlloyDB を使用する方法を紹介するリンクを示します。

始める前に

コンソール

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

   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 が必要です。

2. AlloyDB への接続方法を選択します。

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 と Service Networking API が有効になっていることを確認します。

   gcloud services list
   

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

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

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

   [クラスタ] に移動

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

3. [クラスタを構成する] で、次の操作を行います。

   1. [クラスタ ID] フィールドに「my-cluster」と入力します。

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

   3. デフォルトのデータベース バージョンはそのままにします。

   4. [ロケーション] の [リージョン] プルダウンで、us-central1 (Iowa) リージョンを選択します。

4. ]プライマリ インスタンスの構成] で、次の操作を行います。

   1. [インスタンス ID] フィールドに「my-cluster-primary」と入力します。

   2. [ゾーンの可用性] で、[シングルゾーン] をクリックします。

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

   3. [マシンタイプ] プルダウンで、2 vCPU, 16 GB マシンタイプを選択します。

   4. [接続] の [ネットワーク] プルダウンで、default ネットワークを選択します。

      プライベート アクセス接続がある場合は、クラスタの作成ステップに進みます。接続が設定されていない場合は、[接続を設定] をクリックして、次の操作を行います。

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

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

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

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

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

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

   [クラスタ] に移動

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

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

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

   1. データベースの認証方法を選択します。

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

   3. [認証] をクリックします。[エクスプローラ] ペインに、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. データベース内のすべてのエントリを選択するには、[Editor 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 コンソールの [ネットワーキング] ページに移動し、[VPC ネットワークの削除] をクリックします。

次のステップ

• プロジェクトの AlloyDB へのアクセスを有効にする

• 他のユーザーにアクセス権を付与する

• プライベート サービス アクセスを有効にする

• AlloyDB マシンタイプを選択する。

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

• サイズ設定の推奨事項について