安装 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. Make sure that billing is enabled for your Google Cloud project.

    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 中的数据。