快速入门：使用控制台

本快速入门介绍如何使用 Google Cloud Console 在 Cloud Spanner 中执行基本操作。在快速入门中，您将执行以下操作：

• 创建 Cloud Spanner 实例、数据库和表。
• 添加架构。
• 写入和修改数据。
• 运行查询。

注意：如需了解 Cloud Spanner 的使用费，请参阅价格。

准备工作

1. 登录您的 Google 帐号。

   如果您还没有 Google 帐号，请注册新帐号。

2. 在 Google Cloud Console 的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到项目选择器页面

3. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。

4. 为项目启用 Cloud Spanner API。

   启用 Cloud Spanner API

创建实例

首次使用 Cloud Spanner 时，您必须创建一个实例，用于分配 Cloud Spanner 数据库在该实例中使用的资源。

1. 转到 Cloud Console 中的 Cloud Spanner 实例页面。

   转到实例页面

2. 点击创建实例。

3. 对于实例名称，请输入测试实例。

4. 对于实例 ID，请输入 test-instance。

5. 使用区域配置。

6. 从下拉菜单中选择任意区域配置。

   您的实例配置决定了您的实例会存储和复制到什么地理位置。

7. 对于节点计数，请使用 1。

   实例创建页面现在如下所示：

   

8. 点击创建。

   您的实例将显示在实例列表中。

创建数据库

1. 转到 Cloud Console 中的 Cloud Spanner 实例页面。

   转到实例页面

2. 点击测试实例实例。

3. 点击创建数据库。

4. 对于数据库名称，请输入 example-db。

   数据库创建页面现在如下所示：

   

5. 点击继续。

6. 暂时跳过定义数据库架构步骤。您将在本快速入门的下一部分中定义架构。

7. 点击创建。

   创建数据库后，Cloud Console 将显示数据库详细信息页面。

创建数据库的架构

Cloud Console 提供了两种方法来创建、修改和删除数据库中的表和索引：

• 使用默认的数据库编辑器来指定表、列和索引的每个部分。
• 将编辑器切换到以文字形式修改模式，并按 Cloud Spanner 数据定义语言 (DDL) 语法规则输入 SQL 语句。

本快速入门使用 DDL。

1. 在 Cloud Console 的左侧窗格中，点击 example-db 数据库。
2. 点击创建表。
3. 点击以文字形式修改切换开关。

4. 在 DDL 语句字段中输入：

   CREATE TABLE Singers (
     SingerId   INT64 NOT NULL,
     FirstName  STRING(1024),
     LastName   STRING(1024),
     SingerInfo BYTES(MAX),
     BirthDate  DATE,
   ) PRIMARY KEY(SingerId);
   

5. 点击创建。

   此过程可能需要几分钟时间。操作完成后，Cloud Console 会显示您创建的表的详细信息：

   

插入和修改数据

Cloud Console 提供了用于插入、修改和删除数据的界面。

插入数据

1. 在 Cloud Console 的左侧窗格中，点击 Singers。
2. 点击数据。
3. 点击插入。

4. 输入以下值：

   字段	值
   SingerID:INT64	1
   BirthDate:DATE	[留空]
   FirstName:STRING	Marc
   LastName:STRING	Richards
   SingerInfo:BYTES	[留空]

5. 点击保存。

   Singers 表现在有一行：

   

6. 点击插入以再添加一行。

7. 输入以下值：

   字段	值
   SingerID:INT64	2
   BirthDate:DATE	[留空]
   FirstName:STRING	Catalina
   LastName:STRING	Smith
   SingerInfo:BYTES	[留空]

8. 点击保存。

   Singers 表现在有两行：

   

在输入数据时您也可以插入空字符串值。

1. 在左侧窗格中，点击 Singers。
2. 点击数据。
3. 点击插入。

4. 输入以下值：

   字段	值
   SingerID:INT64	3
   BirthDate:DATE	[留空]
   FirstName:STRING	Kena
   LastName:STRING	[勾选空字符串]
   SingerInfo:BYTES	[留空]

5. 点击保存。

   Singers 表现在有三行，并且对于 SingerID 为 3 的行，LastName 是空字符串：

   

修改数据

1. 在 Cloud Console 的左侧窗格中，点击 Singers。
2. 点击数据。
3. 勾选 SingerId 为 3 的行旁边的复选框，然后点击修改。

4. 输入以下值：

   字段	值
   BirthDate:DATE	1961-04-01
   [所有其他字段]	[保持不变]

5. 点击保存。

   Singers 表中 SingerId 为 3 的行现在具有一个 BirthDate 值：

   

删除数据

1. 在 Cloud Console 的左侧窗格中，点击 Singers。
2. 点击数据。
3. 勾选 SingerId 为 2 的行旁边的复选框，然后点击删除。

4. 在显示的对话框中，点击确定。

   Singers 表现在有两行：

   

运行查询

您现在可以在查询页面上执行 SQL 语句。

1. 在 Cloud Console 的左侧窗格中，点击 example-db 以转到数据库详细信息页面。
2. 在数据库详细信息页面上，点击查询。

3. 输入以下查询：

   SELECT * FROM Singers
   

4. 点击运行查询。

   Cloud Console 会显示查询结果：

   

恭喜！您已成功创建了一个 Cloud Spanner 数据库，并使用查询编辑器执行了一条 SQL 语句！

清理

为避免系统向您的 Google Cloud 帐号收取额外费用，请删除您创建的数据库和实例。

删除数据库

1. 转到 Google Cloud Console 中的 Cloud Spanner 实例页面。

   转到实例页面

2. 点击测试实例。

3. 点击 example-db。

4. 在数据库详情页面中，点击 删除数据库。

5. 确认您要删除数据库并点击删除。

删除实例

删除实例会自动删除在该实例中创建的所有数据库。

1. 转到 Google Cloud Console 中的 Cloud Spanner 实例页面。

   转到实例页面

2. 点击测试实例。

3. 点击 。

4. 确认您要删除实例并点击删除。

后续步骤

• 了解实例。
• 了解 Cloud Spanner 的架构和数据模型。
• 详细了解数据定义语言 (DDL)。
• 详细了解查询执行计划。
• 了解如何通过 C++、C#、Go、Java、Node.js、PHP、Python、Ruby、REST 或 gcloud 使用 Cloud Spanner。