安装 gcloud CLI 并设置 Cloud Spanner API

本页面介绍了将 Cloud Spanner API 与 Google Cloud CLI、客户端库和 Spanner 驱动程序搭配使用所需的设置步骤。

如果您想将 Spanner 与 Google Cloud 控制台搭配使用，请参阅快速入门：使用控制台。

准备工作

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

设置 Google Cloud 项目

  1. 前往 Google Cloud 控制台中的项目页面。

    转到“项目”页面

  2. 创建新的 Google Cloud 项目，或者点击项目名称以打开现有项目。

  3. 打开一个终端窗口，将您的项目设置为 Google Cloud CLI 的默认项目，注意将 MY_PROJECT_ID 替换为您的项目 ID（不是您的项目名称）：

    gcloud config set project MY_PROJECT_ID

  4. 确保您的 Google Cloud 项目已启用结算功能。

    5. 您还可以了解 Spanner 价格。

  5. 为项目启用 Cloud Spanner API。

    启用 Cloud Spanner API

    注意：如果您使用其他项目中的服务帐号访问 Spanner 实例，则需要在这两个项目中启用 Spanner API。

设置身份验证和授权

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

要在开发和测试期间在本地运行代码，请使用 Google Cloud CLI 以及应用默认凭据。请在命令提示符下运行以下命令：

gcloud auth application-default login

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

运行 Google Cloud CLI

现在，您已设置好开发环境和身份验证，接下来请运行 gcloud 命令行工具与 Spanner 进行交互：

gcloud spanner instance-configs list

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

您已完成设置！

后续步骤

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