设置

本页面逐步介绍将 Cloud Spanner API 与 gcloud 命令行工具客户端库搭配使用所需的设置步骤。

如果您要将 Cloud Spanner 与 Google Cloud Console 搭配使用,请参阅快速入门:使用控制台

准备工作

您的开发机器应该安装以下内容:

设置 Google Cloud 项目

  1. 转到 Google Cloud Console 中的项目页面。

    转到“项目”页面

  2. 创建新的 Google Cloud 项目,或者点击项目名称以打开现有项目。
  3. 打开一个终端窗口,将您的项目设置为 gcloud 命令行工具的默认项目,注意将 MY_PROJECT_ID 替换为您的项目 ID(不是您的项目名称):

    gcloud config set project MY_PROJECT_ID
  4. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能

  5. 您还可以了解 Cloud Spanner 价格
  6. 为项目启用 Cloud Spanner API。

    启用 Cloud Spanner API

设置身份验证和授权

Cloud Spanner 使用 OAuth 2.0 进行 API 身份验证和授权。

要在开发和测试期间在本地运行代码,请使用 Google Cloud SDKgcloud 命令行工具)以及应用默认凭据。请在命令提示符下运行以下命令:

gcloud auth application-default login

使用 gcloud auth application-default login 命令进行身份验证后,使用应用默认凭据的 API 客户端库会自动选取创建的凭据。每个本地用户环境只需运行该命令一次。

运行 gcloud 命令行工具

在设置了开发环境和身份验证后,请运行 gcloud 命令行工具与 Cloud Spanner 进行交互:

gcloud spanner instance-configs list

您应该会看到您的项目可以访问的 Cloud Spanner 实例配置的列表,包括区域和多区域配置。请参阅实例详细了解相关信息。

您已完成设置!

后续步骤

了解如何使用 Cloud 客户端库创建 Cloud Spanner 实例、数据库、表和索引。然后在 Cloud Spanner 中存储、查询和读取数据。