環境の設定

このページでは、Google Cloud CLI、クライアント ライブラリ、Spanner ドライバで Cloud Spanner API を使用するために必要な設定手順について説明します。

Google Cloud コンソールで Spanner を使用する場合は、コンソールを使用したクイックスタートをご覧ください。

Google Cloud プロジェクトを設定する

  1. Google Cloud コンソール内のプロジェクト ページに移動します。

    プロジェクト ページに移動

  2. 新しい Google Cloud プロジェクトを作成するか、プロジェクト名をクリックして既存のプロジェクトを開きます。

  3. ターミナル ウィンドウを開き、MY_PROJECT_ID をプロジェクト ID（プロジェクト名ではない）を置き換えることで、Google Cloud CLI のデフォルト プロジェクトとしてプロジェクトを設定します。 

    gcloud config set project MY_PROJECT_ID

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

    5. Spanner の料金についてもご確認いただけます。

  5. プロジェクトに対して Cloud Spanner API を有効化します。

    Cloud Spanner API を有効にする

    注: 別のプロジェクトのサービス アカウントを使用して Spanner インスタンスにアクセスする場合は、両方のプロジェクトで Spanner API を有効にする必要があります。

認証を設定する

Select the tabs for how you plan to access the API:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

Install the Google Cloud CLI, then initialize it by running the following command: 

gcloud init

ユーザー認証情報ではなく、サービス アカウントの権限借用を使用して Google API の認証を行うように gcloud CLI を設定するには、次のコマンドを実行します。

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

詳細については、サービス アカウントの権限借用をご覧ください。

Terraform

ローカル開発環境で Terraform コードを使用するには、gcloud CLI をインストールして初期化し、ユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定します。

  1. Install the Google Cloud CLI.

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

    gcloud init

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

詳細については Set up authentication for a local development environment をご覧ください。

クライアント ライブラリ

ローカル開発環境でクライアント ライブラリを使用するには、gcloud CLI をインストールして初期化し、ユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定します。

  1. Install the Google Cloud CLI.

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

    gcloud init

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

詳細については Set up authentication for a local development environment をご覧ください。

ユーザー認証情報ではなく、サービス アカウントの権限借用を使用して Google API の認証を行うようにローカル ADC ファイルを設定するには、次のコマンドを実行します。

gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

詳細については、サービス アカウントの権限借用をご覧ください。

REST

ローカル開発環境で REST API を使用するには、gcloud CLI に指定した認証情報を使用します。

    Install the Google Cloud CLI, then initialize it by running the following command: 

    gcloud init

詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

サービス アカウントの権限借用を使用して、REST API リクエスト用のアクセス トークンを生成できます。詳細については、権限借用されたサービス アカウントをご覧ください。

Google Cloud CLI を実行する

開発環境と認証を設定したら、gcloud コマンドライン ツールを実行して、Spanner を操作します。

gcloud spanner instance-configs list

プロジェクトからアクセスできる Spanner インスタンスの構成一覧（リージョン構成、デュアルリージョン構成およびマルチリージョン構成を含む）が表示されます。詳細については、インスタンスの概要をご覧ください。

これで設定は完了しました。

次のステップ

Cloud クライアント ライブラリとドライバを使用して Spanner インスタンス、データベース、テーブル、インデックスを作成する方法をご覧ください。さらに、Spanner でデータの保存、読み取り、クエリを実行します。