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

Google Cloud コンソール

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

   [Spanner] に移動

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

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

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

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

   

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

   

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

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

   [Spanner] に移動

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

4. 省略可: 以前にプロジェクトで 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.

外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

gcloud CLI を初期化するには、次のコマンドを実行します。

gcloud init

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

• 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.

Verify 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.

外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

gcloud CLI を初期化するには、次のコマンドを実行します。

gcloud init

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

• 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.

Verify 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 コンソール

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

[無料トライアル インスタンスを作成] ページで、次の操作を行います。

1. Google Cloud コンソールに表示するインスタンス名を入力します。インスタンスは、 Google Cloud プロジェクト内で一意である必要があります。
2. インスタンスを永続的に識別するためのインスタンス ID を入力します。インスタンス ID も、 Google Cloud プロジェクト内で一意にする必要があります。インスタンス ID を後で変更することはできません。

3. [リージョン] プルダウン メニューから構成のロケーションを選択します。

   インスタンス構成により、インスタンスが保存およびレプリケーションされるロケーションが決定されます。無料トライアル インスタンスは、Spanner のリージョン インスタンス構成のいずれかで作成できます。使用可能なすべてのインスタンス構成の一覧については、リージョン、デュアルリージョン、マルチリージョン構成をご覧ください。

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

   無料トライアル インスタンスを作成すると、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。インスタンスの地理的位置を定義します。無料トライアル インスタンスは、Spanner のリージョン インスタンス構成のいずれかで作成できます。

• 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 の確認と探索を継続するように求めるメッセージが表示されます。詳細については、サンプル アプリケーションを使ってみるをご覧ください。

Google Cloud コンソール

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

   [Spanner インスタンス] ページに移動

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

3. サンプル データベースの名前をクリックします。

サンプル データベースのテーブルとデータを表示できます。保存済みクエリには、Spanner Studio ページからアクセスして表示することもできます。保存されたクエリは、さまざまな Spanner の機能と機能を示しています。

gcloud

1. gcloud の設定で説明されている手順を終わらせておきます。この手順では、 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 インスタンス] ページに移動します。

   [Spanner インスタンス] に移動

2. データベースを作成するインスタンスを選択します。

3. [独自のデータをインポート] をクリックします。

4. 次の値を入力します。

   • [ファイル形式] を選択します。

   • パソコンからファイルをアップロードするか、ファイルへの Cloud Storage バケットパスを選択します。

   • （省略可）CSV ファイルを使用する場合は、データベース スキーマを含む別の JSON ファイルもアップロードする必要があります。JSON ファイルでは、スキーマを定義するために次の構造を使用する必要があります。

     {
       "name": "COLUMN_NAME",
       "type": "TYPE",
       "notNull": NOT_NULL_VALUE,
       "primaryKeyOrder": PRIMARY_KEY_ORDER
     }

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

     • COLUMN_NAME: テーブルの列の名前。

     • TYPE: 列のデータ型。

     • （省略可）NOT_NULL_VALUE: 列に null 値を格納できるかどうか。有効な入力は true または false です。デフォルトは false です。

     • （省略可）: PRIMARY_KEY_ORDER: 主キーの順序を決定します。主キー以外の列の場合、値は 0 に設定されます。値を整数に設定します。たとえば、主キー列の場合は 1 です。番号の小さい列は、複合主キーの早い段階で表示されます。

     CSV ファイルでは、デフォルトでフィールド区切り文字にカンマ、行区切り文字に改行が使用されます。カスタム区切り文字の使用について詳しくは、gcloud alpha spanner databases import リファレンスをご覧ください。

   • 宛先として新しいデータベースまたは既存のデータベースを選択します。

5. [インポート] をクリックします。

6. Spanner は Cloud Shell を開き、Spanner 移行ツールをインストールして gcloud alpha spanner databases import コマンドを実行するコマンドを入力します。ENTER キーを押して、データベースにデータをインポートします。

Google Cloud コンソール

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

   [Spanner インスタンス] ページに移動

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

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

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

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

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

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

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

gcloud

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

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

Google Cloud コンソール

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

   [Spanner インスタンス] ページに移動

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

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

4. 指示を読み、インスタンスを削除することを確認します。

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

gcloud

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

gcloud spanner instances delete INSTANCE_ID