このクイックスタートでは、Spanner の無料トライアル インスタンスとサンプル アプリケーションを使用する方法について説明します。詳細については、Spanner 無料トライアル インスタンスの概要をご覧ください。
無料トライアルを開始する
Spanner の 90 日間の無料トライアル インスタンスは、プロジェクトで Cloud Billing が有効になっている Google アカウントをお持ちのすべての方にご利用いただけます。無料トライアル インスタンスを有料インスタンスにアップグレードしない限り、課金されることはありません。
無料トライアル インスタンスは、 Google Cloud コンソールまたは Google Cloud CLI を使用して作成できます。
始める前に
コンソール
Google Cloud コンソールで、[Spanner] ページに移動します。
Google Cloud プロジェクトを選択するか、まだ作成していない場合は新しく作成します。
[Spanner] ページで [無料トライアルを開始] をクリックします。
プロジェクトで Cloud Billing がすでに有効になっている場合は、次のセクションの無料トライアル インスタンスを作成するに進みます。
プロジェクトで Cloud Billing が有効になっていない場合は、既存の Cloud 請求先アカウントをリンクするか、新しい Cloud 請求先アカウントを作成します。Google はこのお支払い情報を使用して、お客様の本人確認を行います。明示的に Cloud 請求先アカウントを有料アカウントにアップグレード、および Spanner 無料トライアル インスタンスを有料インスタンスにアップグレードしない限り、Spanner インスタンスに対しては課金されません。
a. [お支払い情報へ移動] をクリックします。
b. 次に、[請求先アカウントをリンク] をクリックします。
c. 手順に沿って請求先アカウントを作成すると、プロジェクトにリンクできます。
d. プロジェクトの Cloud Billing を有効にしてから、[Spanner] ページに移動します。
e. 無料トライアルを開始をクリックして、次のセクションの無料トライアル インスタンスを作成に進みます。
省略可: 以前にプロジェクトで Spanner インスタンスを作成したことがある場合は、次の [Spanner インスタンス] ページが表示されます。
[無料トライアルを開始] をクリックします。
gcloud
- 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.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud 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.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
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.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud 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.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
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.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
無料トライアル インスタンスを作成する
コンソール
次の手順では、Google Cloud コンソールを使用して無料トライアル インスタンスを作成する方法について説明します。
[無料トライアル インスタンスを作成] ページで、次の操作を行います。
[インスタンスの名前を指定] フィールドに、インスタンス名(
Trial instance
など)を入力します。インスタンス ID は、インスタンス名(
trial-instance
など)に基づいて自動的に入力されますが、必要に応じて変更できます。[構成を選択] で、プルダウン メニューから構成を選択します。
インスタンスの構成により、インスタンスが保存および複製される地理的位置が決まります。この構成リストは、有料インスタンスで利用可能なリストよりもはるかに短い点に注意してください。無料トライアル インスタンスで使用できるリージョン構成の一覧については、使用可能なインスタンス構成をご覧ください。使用可能なすべてのインスタンス構成の一覧については、リージョン、デュアルリージョン、マルチリージョン構成をご覧ください。
[無料トライアル インスタンスを作成] をクリックします。
無料トライアル インスタンスを作成すると、サンプル アプリケーションを使用してデータベースを作成する方法を説明するステップ バイ ステップのチュートリアルが起動し、Spanner の確認と探索を継続するように求められます。詳細については、サンプル アプリケーションを使ってみるをご覧ください。
gcloud
無料トライアル インスタンスを作成するには、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: インスタンス構成の永続的な ID。インスタンスの地理的位置を定義します。無料トライアル インスタンスは、次のリージョン インスタンス構成のいずれかで作成できます。
- 南北アメリカ:
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"
サンプル アプリケーションの使用を開始する
Spanner には、Spanner の無料トライアル インスタンスの使用を開始するためのオープンソースのサンプル アプリケーションが用意されています。サンプル アプリケーションは、Spanner データベースを基盤とするバックエンド gRPC サービスと、サービスにトラフィックを誘導するワークロード生成ツールで構成されています。
サンプル アプリケーションにアクセスするには、 Google Cloud コンソールまたは Google Cloud CLI を使用します。
コンソール
Google Cloud コンソールの [Spanner インスタンス] ページに移動します。
無料トライアル インスタンスの名前をクリックします。
[インスタンスの概要] ページで、[詳細] をクリックします。
利用を開始する際に使用する言語に応じて、[詳細: チュートリアル] パネルで [サンプル Cloud SQL データベースを作成する] または [サンプル PostgreSQL データベースを作成する] をクリックします。
チュートリアルを完了したら、[詳細: チュートリアル] パネルに戻り、2 番目のチュートリアルであるサンプル データベースへのクエリを行ってください。
gcloud
gcloud の設定で説明されている手順を終わらせておきます。この手順では、 Google Cloud のデフォルト プロジェクトの作成と設定、Cloud Spanner API の有効化、Cloud Spanner API の使用に必要な認証情報を取得するための OAuth 2.0 の設定を行います。
ローカル開発環境に認証情報を設定するために、必ず
gcloud auth application-default login
を実行してください。gcloud spanner samples run
コマンドを実行してサンプル アプリケーションをダウンロードし、指定されたサンプル アプリケーションのバックエンド gRPC サービスとワークロード生成ツールを起動します。gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
詳細とサンプル アプリケーションで使用可能なコマンドのリストについては、gcloud CLI のドキュメントをご覧ください。
無料トライアル インスタンスをアップグレードする
次の手順では、無料トライアル インスタンスをアップグレードする方法について説明します。
コンソール
- Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
無料トライアル インスタンスの名前をクリックします。
[インスタンスの概要] ページで、[インスタンスを編集] または [編集してアップグレード] をクリックします。
[インスタンス名の更新] フィールドに、有料インスタンスとしてより適切な名前を入力します(該当する場合)。
アップグレード オプションを選択します。次のいずれかを選択できます。
- 今すぐアップグレード
- トライアル終了後に Enterprise エディションのフルバージョンに自動的にアップグレードする
- 後で通知
[概要] セクションには、選択したアップグレード後の有料インスタンスのコンピューティングとストレージの費用に関する説明が記載されています。
[保存] をクリックして、無料トライアル インスタンスをアップグレードします。
gcloud
無料トライアル インスタンスを同じインスタンス構成の有料 Enterprise エディション インスタンスにアップグレードするには、次の gcloud spanner instances update
コマンドを実行します。
gcloud spanner instances update INSTANCE_ID --instance-type=provisioned
インスタンスを削除する
コンソール
Google Cloud コンソールの [Spanner インスタンス] ページに移動します。
削除するインスタンスの名前をクリックします。
[インスタンスの概要] ページで、[インスタンスを削除] をクリックします。
指示を読み、インスタンスを削除することを確認します。
[削除] をクリックします。
gcloud
無料トライアル版インスタンスを削除するには、次の gcloud spanner instances delete
コマンドを使用します。
gcloud spanner instances delete INSTANCE_ID
次のステップ
- Spanner の無料トライアル インスタンスについて確認する。
- Spanner のインスタンスとデータベースについて確認する。
- 無料トライアル期間が経過した後の Spanner の料金について、料金ページで確認する。