创建 Spanner 免费试用实例和示例应用

注意： Spanner 免费试用实例支持标准版功能和企业版功能，例如 KNN 向量距离函数、全文搜索和 Spanner Graph。如需了解详情，请参阅 Spanner 版本概览。

本快速入门介绍了如何使用 Spanner 免费试用实例和示例应用。如需了解详情，请参阅 Spanner 免费试用实例概览。

从免费试用实例开始

任何拥有 Google 账号且其项目已启用 Cloud Billing 的用户都可以免费试用 90 天的 Spanner 实例。除非您选择将免费试用实例升级为付费实例，否则我们不会向您收取费用。

您可以使用 Google Cloud 控制台或 Google Cloud CLI 创建免费试用实例。

注意 ：每个项目生命周期只能创建一个免费试用实例，每个 Cloud Billing 账号最多只能创建 5 个免费试用实例。

使用 Google Cloud 控制台创建免费试用实例

以下步骤介绍了如何使用 Google Cloud 控制台创建免费试用实例。

准备工作

1. 在 Google Cloud 控制台中，前往 Spanner 页面。

   转到 Spanner

2. 选择或创建 Google Cloud 项目（如果您尚未创建）。

3. 在 Spanner 页面上，点击开始免费试用。

   

4. 如果您的项目已启用 Cloud Billing，请继续执行下一部分中的创建免费试用实例操作。

   如果您的项目未启用 Cloud Billing，请关联现有 Cloud Billing 账号或创建新的 Cloud Billing 账号。Google 会使用这些付款信息来验证您的身份。除非您明确将 Cloud Billing 账号升级为付费账号，并将 Spanner 免费试用实例升级为付费实例，否则我们不会向您收取 Spanner 实例费用。

   a. 点击前往结算。

   

   b. 然后，点击关联结算账号。

   

   注意 ：如果您是 Google Cloud 新客户，可能还符合Google Cloud 90 天免费试用（赠送 $300）的条件，该试用期可提供 300 美元的 Cloud Billing 赠金，用于支付任何资源费用。 Google Cloud除了 Google Cloud 免费试用提供的 300 美元免费试用赠金之外，您还可以获得 Spanner 免费试用实例。您无需使用任何免费的 Cloud Billing 赠金即可创建免费试用实例。

   c. 按照相应步骤创建结算账号，然后将其关联到您的项目。

   d. 为项目启用 Cloud Billing 后，请前往 Spanner 页面。

   转到 Spanner

   e. 点击开始免费试用，然后继续进行下一部分中的创建免费试用实例。

5. 可选：如果您之前已在项目中创建了 Spanner 实例，则会看到以下 Spanner 实例页面。

   点击开始免费试用。

   

创建免费试用实例

在创建免费试用实例页面上，按照以下步骤操作：

1. 在为实例命名字段中，输入实例名称，例如 Trial instance。

2. 实例 ID 会根据实例名称自动填充，例如 trial-instance。如有必要，请进行更改。

3. 在选择配置部分，从下拉菜单中选择一个配置。

   您的实例配置决定了您的实例会存储和复制到什么地理位置。请注意，此配置列表比付费实例可用的列表要小得多。如需查看可用于免费试用实例的区域配置列表，请参阅可用实例配置。如需查看所有可用实例配置的完整列表，请参阅单区域、双区域和多区域配置。

4. 点击创建免费试用实例。

   创建免费试用实例后，系统会提示您启动分步教程，以便您继续学习和探索 Spanner，教程会介绍如何使用示例应用创建数据库。如需了解详情，请参阅通过示例应用开始使用。

使用 gcloud CLI 创建免费试用实例

准备工作

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Make sure that billing is enabled for your Google Cloud project.

6. 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.

7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

10. Make sure that billing is enabled for your Google Cloud project.

11. 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 spanner instances create 命令。

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

替换以下内容：

• INSTANCE_ID：在您的 Google Cloud 项目中唯一的永久性标识符。实例 ID 创建后便无法更改。

• INSTANCE_CONFIG：实例配置的永久性标识符，用于定义实例的地理位置。您可以使用以下任一区域实例配置创建免费试用实例：

  • 美洲：regional-us-central1（爱荷华州）、regional-us-east1（南卡罗来纳州）、regional-us-east4（北弗吉尼亚州）、regional-us-east5（哥伦比亚）
  • 欧洲：regional-europe-west1（比利时）、regional-europe-west3（法兰克福）
  • 亚洲：regional-asia-northeast1（东京）、regional-asia-south2（德里）、regional-asia-southeast2（雅加达）

• INSTANCE_DESCRIPTION：要在 Google Cloud 控制台中显示的实例名称。此实例名称在您的Google Cloud 项目中必须是唯一的。

例如，如需使用区域实例配置 regional-us-east5 创建一个名为 trial-instance、显示名称为 Trial Instance 的免费试用实例，请输入以下命令：

gcloud spanner instances create trial-instance --config=regional-us-east5 \
    --instance-type=free-instance --description="Trial Instance"

注意 ：在 gcloud CLI 命令中引用实例时，请使用实例 ID，而不是显示名称。

使用示例应用入门

Spanner 提供了一个开源示例应用，可帮助您开始使用 Spanner 免费试用实例。示例应用由后端 gRPC 服务（由 Spanner 数据库提供支持）和用于为服务引入流量的工作负载生成器组成。

您可以使用 Google Cloud 控制台或 Google Cloud CLI 访问示例应用。

控制台

1. 前往 Google Cloud 控制台中的 Spanner 实例页面。

   转到“实例”页面

2. 点击免费试用实例的名称。

3. 在实例概览页面上，点击了解。

4. 在学习：教程面板中，点击创建 Cloud SQL 示例数据库或创建 PostgreSQL 示例数据库，具体取决于您想开始使用哪种方言。

5. 完成本教程后，请返回学习：教程面板，学习第二个教程：查询示例数据库。

gcloud CLI

1. 完成 gcloud CLI 设置中介绍的步骤，包括创建和设置默认 Google Cloud 项目、启用 Cloud Spanner API 以及设置 OAuth 2.0 以获取使用 Cloud Spanner API 所需的身份验证凭据。

   请务必运行 gcloud auth application-default login，以便使用身份验证凭据设置本地开发环境。

2. 运行 gcloud spanner samples run 命令以下载示例应用，并为给定示例应用启动后端 gRPC 服务和工作负载生成器：

   gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
   

3. 如需了解详情以及示例应用的其他可用命令的列表，请参阅 gcloud CLI 文档。

升级免费试用实例

以下步骤介绍了如何升级免费试用版实例。

使用 Google Cloud 控制台

1. 在 Google Cloud 控制台中，前往 Spanner 实例页面。

   转到“实例”页面

2. 点击免费试用实例的名称。

3. 在实例概览页面上，点击修改实例或修改以升级。

   

4. 在更新实例名称字段中，为付费实例输入更适合的名称（如果适用）。

5. 选择升级选项。您可以选择以下任一方法：

   • 立即升级
   • 试用期结束后自动升级为企业版的完整版
   • 以后再提醒我

   摘要部分介绍了您选择的升级付费实例的计算和存储费用。

6. 点击保存以升级您的免费试用实例。

使用 gcloud CLI

如需将免费试用版实例升级为具有相同实例配置的付费企业版实例，请运行以下 gcloud spanner instances update 命令：

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

删除实例

警告：删除实例将永久移除该实例及其所有数据库。您之后无法撤消此操作。此外，删除第一个免费试用实例后，您将无法再创建其他免费试用实例。您可以在每个项目生命周期内创建一个免费试用实例。

控制台

1. 前往 Google Cloud 控制台中的 Spanner 实例页面。

   转到“实例”页面

2. 点击要删除的实例名称。

3. 在实例概览页面上，点击删除实例。

4. 按照说明进行操作，确认您要删除实例。

5. 点击删除。

gcloud CLI

如需删除您的免费试用版实例，请使用以下 gcloud spanner instances delete 命令：

gcloud spanner instances delete INSTANCE_ID

后续步骤

• 详细了解 Spanner 免费试用实例。
• 详细了解 Spanner 实例和数据库。
• 如需详细了解免费试用期结束后 Spanner 的价格，请参阅价格页面。