gcloud CLI をインストールし、Cloud Spanner API を設定する

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

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

始める前に

開発マシンには、以下がインストールされている必要があります。

Google Cloud プロジェクトの設定

  1. Google Cloud Console の [スナップショット] ページに移動します。

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

  2. 新しい Google Cloud プロジェクトを作成するか、プロジェクト名をクリックして既存のプロジェクトを開きます。
  3. ターミナル ウィンドウを開き、MY_PROJECT_ID をプロジェクト ID(プロジェクト名ではない)を置き換えることで、Google Cloud CLI のデフォルト プロジェクトとしてプロジェクトを設定します。

    gcloud config set project MY_PROJECT_ID
  4. Google Cloud プロジェクトで課金が有効になっていることを確認します

  5. Spanner の料金についてもご確認いただけます。
  6. プロジェクトに対して Cloud Spanner API を有効化します。

    Cloud Spanner API を有効にする

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

認証と権限付与の設定

Spanner は、API の認証と権限付与に OAuth 2.0 を使用します。

開発およびテスト中に、ローカルでコードを実行するには、Google Cloud CLIアプリケーションのデフォルト認証情報を使用します。 コマンド プロンプトで次のコマンドを実行します。

gcloud auth application-default login

gcloud auth application-default login コマンドを使用して認証すると、アプリケーションのデフォルト認証情報を使用する API クライアント ライブラリが、作成された認証情報を自動的に選択します。このコマンドは、ローカル ユーザー環境ごとに 1 回だけ実行する必要があります。

Google Cloud CLI を実行する

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

gcloud spanner instance-configs list

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

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

次のステップ

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