本快速入门介绍如何使用 Google Cloud Console 在 Cloud Spanner 中执行基本操作。在快速入门中,您将执行以下操作:
- 创建 Cloud Spanner 实例、数据库和表。
- 添加架构。
- 写入和修改数据。
- 运行查询。
准备工作
-
登录您的 Google 帐号。
如果您还没有 Google 帐号,请注册新帐号。
-
在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。
-
确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。
-
为项目启用 Cloud Spanner API。
创建实例
首次使用 Cloud Spanner 时,您必须创建一个实例,用于分配 Cloud Spanner 数据库在该实例中使用的资源。
转到 Cloud Console 中的 Cloud Spanner 实例页面。
点击创建实例。
对于实例名称,请输入测试实例。
对于实例 ID,请输入 test-instance。
使用区域配置。
从下拉菜单中选择任意区域配置。
您的实例配置决定了您的实例会存储和复制到什么地理位置。
对于节点计数,请使用 1。
实例创建页面现在如下所示:
点击创建。
您的实例将显示在实例列表中。
创建数据库
转到 Cloud Console 中的 Cloud Spanner 实例页面。
点击测试实例实例。
点击创建数据库。
对于数据库名称,请输入 example-db。
数据库创建页面现在如下所示:
点击继续。
暂时跳过定义数据库架构步骤。您将在本快速入门的下一部分中定义架构。
点击创建。
创建数据库后,Cloud Console 将显示数据库详细信息页面。
创建数据库的架构
Cloud Console 提供了两种方法来创建、修改和删除数据库中的表和索引:
- 使用默认的数据库编辑器来指定表、列和索引的每个部分。
- 将编辑器切换到以文字形式修改模式,并按 Cloud Spanner 数据定义语言 (DDL) 语法规则输入 SQL 语句。
本快速入门使用 DDL。
- 在 Cloud Console 的左侧窗格中,点击 example-db 数据库。
- 点击创建表。
- 点击以文字形式修改切换开关。
-
CREATE TABLE Singers ( SingerId INT64 NOT NULL, FirstName STRING(1024), LastName STRING(1024), SingerInfo BYTES(MAX), BirthDate DATE, ) PRIMARY KEY(SingerId);
点击创建。
此过程可能需要几分钟时间。操作完成后,Cloud Console 会显示您创建的表的详细信息:
插入和修改数据
Cloud Console 提供了用于插入、修改和删除数据的界面。
插入数据
- 在 Cloud Console 的左侧窗格中,点击 Singers。
- 点击数据。
- 点击插入。
输入以下值:
字段 值 SingerID:INT64 1
BirthDate:DATE [留空] FirstName:STRING Marc
LastName:STRING Richards
SingerInfo:BYTES [留空] 点击保存。
Singers 表现在有一行:
点击插入以再添加一行。
输入以下值:
字段 值 SingerID:INT64 2
BirthDate:DATE [留空] FirstName:STRING Catalina
LastName:STRING Smith
SingerInfo:BYTES [留空] 点击保存。
Singers 表现在有两行:
在输入数据时您也可以插入空字符串值。
- 在左侧窗格中,点击 Singers。
- 点击数据。
- 点击插入。
输入以下值:
字段 值 SingerID:INT64 3
BirthDate:DATE [留空] FirstName:STRING Kena
LastName:STRING [勾选空字符串] SingerInfo:BYTES [留空] 点击保存。
Singers 表现在有三行,并且对于 SingerID 为
3
的行,LastName 是空字符串:
修改数据
- 在 Cloud Console 的左侧窗格中,点击 Singers。
- 点击数据。
- 勾选 SingerId 为
3
的行旁边的复选框,然后点击修改。 输入以下值:
字段 值 BirthDate:DATE 1961-04-01
[所有其他字段] [保持不变] 点击保存。
Singers 表中 SingerId 为
3
的行现在具有一个 BirthDate 值:
删除数据
- 在 Cloud Console 的左侧窗格中,点击 Singers。
- 点击数据。
- 勾选 SingerId 为
2
的行旁边的复选框,然后点击删除。 在显示的对话框中,点击确定。
Singers 表现在有两行:
运行查询
您现在可以在查询页面上执行 SQL 语句。
- 在 Cloud Console 的左侧窗格中,点击 example-db 以转到数据库详细信息页面。
- 在数据库详细信息页面上,点击查询。
输入以下查询:
SELECT * FROM Singers
点击运行查询。
Cloud Console 会显示查询结果:
恭喜!您已成功创建了一个 Cloud Spanner 数据库,并使用查询编辑器执行了一条 SQL 语句!
清理
为避免系统向您的 Google Cloud 帐号收取额外费用,请删除您创建的数据库和实例。
删除数据库
转到 Google Cloud Console 中的 Cloud Spanner 实例页面。
点击测试实例。
点击 example-db。
在数据库详情页面中,点击 delete 删除数据库。
确认您要删除数据库并点击删除。
删除实例
删除实例会自动删除在该实例中创建的所有数据库。
转到 Google Cloud Console 中的 Cloud Spanner 实例页面。
点击测试实例。
点击 delete 。
确认您要删除实例并点击删除。