Spanner 無料トライアル インスタンスとサンプル アプリケーションを作成する

注: Spanner の無料試用インスタンスは、Standard エディションの機能と、KNN ベクトル距離関数、全文検索、Spanner Graph などの Enterprise エディションの機能をサポートしています。詳細については、Spanner エディションの概要をご覧ください。

このクイックスタートでは、Spanner の無料トライアル インスタンスとサンプル アプリケーションを使用する方法について説明します。 詳細については、Spanner 無料インスタンスの概要をご覧ください。

無料トライアル インスタンスの使用を開始する

Spanner の 90 日間の無料トライアル インスタンスは、プロジェクトで Cloud Billing が有効になっている Google アカウントをお持ちのすべてのユーザーが利用できます。無料トライアル インスタンスを有料インスタンスにアップグレードしない限り、課金されることはありません。

無料トライアル インスタンスは、Google Cloud コンソールまたは Google Cloud CLI を使用して作成できます。

注: プロジェクトのライフサイクルごとに 1 つの無料試用インスタンスのみを作成できます。また、Cloud 請求先アカウントごとに最大 5 つの無料試用インスタンスを作成できます。

Google Cloud コンソールを使用して無料トライアル インスタンスを作成する

次の手順では、Google Cloud コンソールを使用して無料トライアル インスタンスを作成する方法について説明します。

始める前に

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

   Spanner に移動

2. Google Cloud プロジェクトを選択するか、新しく作成します（まだ作成していない場合）。

3. [Spanner] ページで [無料トライアルを開始] をクリックします。

   

4. プロジェクトで Cloud Billing がすでに有効になっている場合は、次のセクションの無料トライアル インスタンスを作成するに進みます。

   プロジェクトで Cloud Billing が有効になっていない場合は、既存の Cloud 請求先アカウントをリンクするか、新しい Cloud 請求先アカウントを作成します。Google はこのお支払い情報を使用して、お客様の本人確認を行います。明示的に Cloud 請求先アカウントを有料アカウントにアップグレード、および Spanner 無料トライアル インスタンスを有料インスタンスにアップグレードしない限り、Spanner インスタンスに対しては課金されません。

   a. [お支払いに移動] をクリックします。

   

   b. 次に、[請求先アカウントをリンク] をクリックします。

   

   注: Google Cloud を初めてご利用になる場合は、Google Cloud 90 日間 $300 分の無料トライアルをご利用いただけます。無料トライアルでは、Google Cloud のリソースの支払いに $300 分の Cloud Billing クレジットを無料で提供いたします。Google Cloud の無料トライアルで提供される $300 分の無料トライアル クレジットに Spanner の無料トライアル インスタンスが追加されています。無料トライアル インスタンスを作成するのに Cloud Billing の無料クレジットを使用する必要はありません。

   c. 手順に沿って請求先アカウントを作成すると、プロジェクトにリンクできます。

   d. プロジェクトの Cloud Billing を有効にしてから、[Spanner] ページに移動します。

   Spanner に移動

   e. 無料トライアルを開始をクリックして、次のセクションの無料トライアル インスタンスを作成に進みます。

5. 省略可: 以前にプロジェクトで Spanner インスタンスを作成したことがある場合は、次の [Spanner Instances] ページが表示されます。

   [無料トライアルを開始] をクリックします。

   

無料トライアル インスタンスを作成する

[Create your free trial instance] ページで、次の操作を行います。

1. [インスタンスに名前を付ける] フィールドに、インスタンス名（Trial instance など）を入力します。

2. インスタンス ID は、インスタンス名（trial-instance など）に基づいて自動的に入力されます。必要に応じて変更します。

3. [構成を選択] で、プルダウン メニューから構成を選択します。

   インスタンスの構成により、インスタンスが保存および複製される地理的なロケーションが決まります。この構成リストは、有料インスタンスで利用可能なリストよりもはるかに短い点に注意してください。無料トライアル インスタンスで使用できるリージョン構成の一覧については、使用可能なインスタンス構成をご覧ください。使用可能なすべてのインスタンス構成の一覧については、リージョン、デュアルリージョン、マルチリージョン構成をご覧ください。

4. [無料試用インスタンスを作成] をクリックします。

   無料試用インスタンスを作成すると、サンプル アプリケーションを使用してデータベースを作成する方法を説明するチュートリアルが起動します。このチュートリアルに沿って、Spanner の学習と探索を続けます。詳細については、サンプル アプリケーションを使ってみるをご覧ください。

gcloud CLI を使用して無料トライアル インスタンスを作成する

始める前に

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. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select 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.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

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

6. If you're using a local shell, then create local authentication credentials for your user account:

   gcloud auth application-default login

   You don't need to do this if you're using Cloud Shell.

7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Create or select 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.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

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

11. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

無料トライアル インスタンスを作成する

無料トライアル インスタンスを作成するには、gcloud spanner instances create コマンドを使用します。

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

以下を置き換えます。

• INSTANCE_ID: Google Cloud プロジェクト内で一意の永続的な識別子。インスタンス ID は後で変更できません。

• INSTANCE_CONFIG: インスタンス構成の永続的な識別子。インスタンスの地理的位置を定義します。無料トライアル インスタンスは、次のリージョン インスタンス構成のいずれかで作成できます。

  • 南北アメリカ: regional-us-central1（アイオワ）、regional-us-east1（サウスカロライナ）、regional-us-east4（北バージニア）、regional-us-east5（コロンビア）
  • ヨーロッパ:　regional-europe-west1（ベルギー）、regional-europe-west3 （フランクフルト）
  • アジア:　regional-asia-northeast1（東京）、regional-asia-south2（デリー）、 regional-asia-southeast2（ジャカルタ）

• INSTANCE_DESCRIPTION: Google Cloud コンソールに表示されるインスタンスの名前。インスタンス名は、Google Cloud プロジェクト内で一意である必要があります。

たとえば、リージョン インスタンス構成 regional-us-east5 を使用して、表示名が Trial Instance の trial-instance という名前の無料トライアル インスタンスを作成するには、次の操作を行います。

gcloud spanner instances create trial-instance --config=regional-us-east5 \
    --instance-type=free-instance --description="Trial Instance"

注: gcloud CLI コマンドでインスタンスを参照するときは、表示名ではなくインスタンス ID を使用します。

サンプル アプリケーションの使用を開始する

Spanner には、Spanner の無料トライアル インスタンスの使用を開始するためのオープンソースのサンプル アプリケーションが用意されています。サンプル アプリケーションは、Spanner データベースを基盤とするバックエンド gRPC サービスと、サービスにトラフィックを誘導するワークロード生成ツールで構成されています。

サンプル アプリケーションにアクセスするには、Google Cloud コンソールまたは Google Cloud CLI を使用します。

コンソール

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

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

2. 無料トライアル インスタンスの名前をクリックします。

3. [インスタンスの概要] ページで、[詳細] をクリックします。

4. 利用を開始する際に使用する言語に基づいて、[詳細: チュートリアル] パネルで、[サンプル Cloud SQL データベースを作成する] または [サンプル PostgreSQL データベースを作成する] をクリックします。

5. チュートリアルを完了したら、[詳細: チュートリアル] パネルに戻り、2 番目のチュートリアルであるサンプル データベースをクエリするを行ってください。

gcloud CLI

1. gcloud CLI の設定に示されている手順を完了します。この手順では、Google Cloud のデフォルト プロジェクトの作成と設定、Cloud Spanner API の有効化、Cloud Spanner API の使用に必要な認証情報を取得するための OAuth 2.0 の設定について説明しています。

   ローカル開発環境に認証情報を設定するために、必ず gcloud auth application-default login を実行してください。

2. gcloud spanner samples run コマンドを実行してサンプル アプリケーションをダウンロードし、指定されたサンプル アプリケーションのバックエンド gRPC サービスとワークロード生成ツールを起動します。

   gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
   

3. 詳細とサンプル アプリケーションで使用可能なコマンドのリストについては、gcloud CLI のドキュメントをご覧ください。

無料トライアル インスタンスをアップグレードする

次の手順では、無料トライアル インスタンスをアップグレードする方法について説明します。

Google Cloud コンソールを使用する

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

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

2. 無料トライアル インスタンスの名前をクリックします。

3. [インスタンスの概要] ページで、[インスタンスを編集] または [編集してアップグレード] をクリックします。

   

4. [更新名] フィールドに、該当する場合は有料インスタンスのより適切な名前を入力します。

5. アップグレード オプションを選択します。次のいずれかを選択できます。

   • 今すぐアップグレード
   • トライアル終了後に Enterprise エディションのフルバージョンに自動的にアップグレードする
   • 後で通知

   [概要] セクションには、選択したアップグレード後の有料インスタンスのコンピューティングとストレージの費用に関する説明が記載されています。

6. [保存] をクリックして、無料トライアル インスタンスをアップグレードします。

gcloud CLI を使用する

無料試用インスタンスを同じインスタンス構成の有料 Enterprise エディション インスタンスにアップグレードするには、次の gcloud spanner instances update コマンドを実行します。

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

インスタンスの削除

警告: インスタンスを削除すると、インスタンスとそのすべてのデータベースが完全に削除されます。この操作は元に戻せません。また、最初の無料トライアル インスタンスを削除した後に、別の無料トライアル インスタンスを作成することはできません。プロジェクトごとに 1 つの無料試用インスタンスを作成できます。

コンソール

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

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

2. 削除するインスタンスの名前をクリックします。

3. [インスタンスの概要] ページで、[インスタンスを削除] をクリックします。

4. 指示に従って、インスタンスを削除することを確認します。

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

gcloud CLI

無料試用版インスタンスを削除するには、次の gcloud spanner instances delete コマンドを使用します。

gcloud spanner instances delete INSTANCE_ID

次のステップ

• Spanner の無料インスタンスの詳細を確認する。
• Spanner のインスタンスとデータベースの詳細。
• 無料トライアル期間が経過した後の Spanner の料金について、料金ページで確認する。