此页面由 Cloud Translation API 翻译。

设置您的环境

本页将引导您完成将 Cloud Spanner API 与 Google Cloud CLI、客户端库和 Spanner 驱动程序搭配使用所需的设置步骤。

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

设置 Google Cloud 项目

…查看命名准则

打开一个终端窗口，将您的项目设置为 Google Cloud CLI 的默认项目，注意将 MY_PROJECT_ID 替换为您的项目 ID（不是您的项目名称）：
```
gcloud config set project MY_PROJECT_ID
```
Make sure that billing is enabled for your Google Cloud project.

为项目启用 Cloud Spanner API。

启用 Cloud Spanner API

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

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

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

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

gcloud init

如需设置 gcloud CLI 以使用服务账号模拟（而不是您的用户凭据）向 Google API 进行身份验证，请运行以下命令：

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

如需了解详情，请参阅服务账号模拟。

如需在本地开发环境中使用 Terraform 代码，请安装并初始化 gcloud CLI，然后使用您的用户凭据设置应用默认凭据。

Install the Google Cloud CLI.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
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.

如需在本地开发环境中使用客户端库，请安装并初始化 gcloud CLI，然后使用您的用户凭据设置应用默认凭据。

Install the Google Cloud CLI.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
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.

如需设置本地 ADC 文件以使用服务账号模拟（而不是您的用户凭据）向 Google API 进行身份验证，请运行以下命令：

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

如需了解详情，请参阅服务账号模拟。

如需在本地开发环境中使用 REST API，请使用您提供给 gcloud CLI 的凭据。

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

gcloud init

如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

您可以使用服务账号模拟为 REST API 请求生成访问令牌。如需了解详情，请参阅模拟的服务账号。

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

gcloud spanner instance-configs list

您应该会看到您的项目可以访问的 Spanner 实例配置的列表，包括区域、双区域和多区域配置。如需了解详情，请参阅实例概览。

您已完成设置！

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