このクイックスタートでは、Spanner の無料トライアル インスタンスとサンプル アプリケーションを使用する方法について説明します。
詳細については、Spanner 無料インスタンスの概要をご覧ください。
無料トライアル インスタンスの使用を開始する
Spanner の 90 日間の無料トライアル インスタンスは、プロジェクトで Google Cloud Billing が有効になっている Google アカウントを持つすべてのユーザーが利用できます。無料トライアル インスタンスを有料インスタンスにアップグレードしない限り、課金されません。
無料トライアル インスタンスは、Google Cloud コンソールまたは Google Cloud CLI を使用して作成できます。
Google Cloud コンソールを使用して無料トライアル インスタンスを作成する
始める前に
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 Instances] ページが表示されます。
[無料トライアルを開始] をクリックします。
無料トライアル インスタンスを作成する
[無料トライアル インスタンスの作成] ページで、次の操作を行います。
[インスタンスに名前を付ける] フィールドに、インスタンス名(
Trial instance
など)を入力します。インスタンス ID は、インスタンス名に基づいて自動的に入力されます(例:
trial-instance
)。必要に応じて変更します。[構成を選択] セクションで、プルダウン メニューから構成を選択します。
インスタンスの構成により、インスタンスが保存および複製される地理的なロケーションが決まります。この構成リストは、有料インスタンスで使用できるリストよりもはるかに小さいことに注意してください。無料トライアル インスタンスで使用できるリージョン構成の一覧については、利用可能なインスタンス構成をご覧ください。使用可能なすべてのインスタンス構成の完全なリストについては、リージョン構成とマルチリージョン構成をご覧ください。
[無料トライアル インスタンスを作成する] をクリックします。
無料トライアル インスタンスを作成した後、サンプル アプリケーションを使用してデータベースを作成する方法を順を追ったチュートリアルで開始し、Spanner の学習と探索を続けるように求められます。詳しくは、サンプル アプリケーションを使ってみるをご覧ください。
gcloud CLI を使用して無料トライアル インスタンスを作成する
始める前に
- 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.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Google Cloud プロジェクトを作成または選択します。
-
Google Cloud プロジェクトを作成します。
gcloud projects create PROJECT_ID
PROJECT_ID
は、作成する Google Cloud プロジェクトの名前に置き換えます。 -
作成した Google Cloud プロジェクトを選択します。
gcloud config set project PROJECT_ID
PROJECT_ID
は、実際の Google Cloud プロジェクト名に置き換えます。
-
-
Create local authentication credentials for your user account:
gcloud auth application-default login
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Google Cloud プロジェクトを作成または選択します。
-
Google Cloud プロジェクトを作成します。
gcloud projects create PROJECT_ID
PROJECT_ID
は、作成する Google Cloud プロジェクトの名前に置き換えます。 -
作成した Google Cloud プロジェクトを選択します。
gcloud config set project PROJECT_ID
PROJECT_ID
は、実際の Google Cloud プロジェクト名に置き換えます。
-
-
Create local authentication credentials for your user account:
gcloud auth application-default login
無料トライアル インスタンスを作成する
- リージョン インスタンス構成
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 CLI
gcloud CLI の設定に示されている手順を完了します。この手順では、Google Cloud のデフォルト プロジェクトの作成と設定、Cloud Spanner API の有効化、Cloud Spanner API の使用に必要な認証情報を取得するための OAuth 2.0 の設定について説明しています。
gcloud auth application-default login
を実行して、認証情報を使用してローカル開発環境を設定します。gcloud alpha spanner samples run
コマンドを実行して、サンプル アプリケーションをダウンロードし、指定されたサンプル アプリケーションのバックエンド gRPC サービスとワークロード生成ツールを起動します。gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
詳細とサンプル アプリケーションで使用可能なコマンドのリストについては、gcloud CLI のドキュメントをご覧ください。
無料トライアル インスタンスをアップグレードする
Google Cloud Console を使用する
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
無料トライアル インスタンスの名前をクリックします。
[インスタンスの概要] ページで、[インスタンスを編集] または [編集してアップグレード] をクリックします。
[更新名] フィールドに、該当する場合は有料インスタンスのより適切な名前を入力します。
アップグレード オプションを選択します。
[概要] セクションには、選択したアップグレード後の有料インスタンスのコンピューティングとストレージの費用に関する説明が記載されています。
[保存] をクリックして、無料トライアル インスタンスをアップグレードします。
gcloud CLI の使用
無料トライアル インスタンス trial-instance
を、同じインスタンス構成の有料インスタンスにアップグレードするには、次のコマンドを実行します。
gcloud spanner instances update trial-instance --instance-type=provisioned
インスタンスの削除
コンソール
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
削除するインスタンスの名前をクリックします。
インスタンスの概要ページで、[インスタンスを削除] をクリックします。
指示に従って、インスタンスを削除することを確認します。
[削除] をクリックします。
gcloud CLI
無料トライアル インスタンス trial-instance
を削除するには、次のコマンドを使用します。
gcloud spanner instances delete trial-instance
次のステップ
- Spanner の無料インスタンスの詳細を確認する。
- Spanner のインスタンスとデータベースの詳細。
- 無料トライアル期間が経過した後の Spanner の料金について、料金ページで確認する。