在 Gemini 协助下编写 SQL

预览 — Gemini in Spanner

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

本文档介绍了如何使用 Gemini Code Assist 在 Spanner 中获得依托 AI 技术的助理，帮助您执行以下操作：

• 使用自然语言提示生成 SQL 查询。
• 在查询编辑器中补全 SQL 语句。
• 在查询编辑器中解释 SQL 查询。

了解 Google Cloud 专用 Gemini 如何以及何时使用您的数据。

本文档适用于熟悉 Spanner、SQL 和数据分析的数据库管理员和数据工程师。如果您刚开始接触 Spanner，请参阅使用 Google Cloud 控制台创建和查询数据库。

注意：编码协助功能是 Gemini Code Assist 的一部分，在 Gemini Code Assist Standard 版中提供之前，可免费使用。我们日后会通知您这项变更。届时，您需要获取 Gemini Code Assist Standard 版许可，才能继续在 Spanner Studio 中使用编码协助功能。

准备工作

1. 可选：设置 Gemini Code Assist。

2. 如需完成本文档中的任务，请确保您拥有必要的 Identity and Access Management (IAM) 权限。

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

   转到 Spanner

4. 从列表中选择一个实例。

5. 选择一个数据库。

6. 在导航菜单中，点击 Spanner Studio。

7. 在任务栏中，点击 pen_spark Gemini 以查看 Spanner 中的 Gemini 功能。

8. 选择您要启用的 Gemini 功能，例如 SQL 补全 和 根据注释生成查询。您可以自行选择和试用功能，而不会影响项目中其他人的操作。

9. 可选：如果您想按照本文档中的示例操作，请先按照为数据库创建架构中的说明创建 Singers 表。

如需在 Spanner 中停用 Gemini 功能，请重复上述步骤，然后取消选择要停用的 Gemini 功能。

所需的角色

如需获得完成本文档中的任务所需的权限，请让您的管理员为您授予项目的 Gemini for Google Cloud User (roles/cloudaicompanion.user) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

使用自然语言提示生成 SQL 查询

作为一项尚处于早期发展阶段的技术，适用于 Google Cloud产品的 Gemini 可能会生成看似合理但实际上不正确的输出。我们建议您先验证适用于 Google Cloud 产品的 Gemini 的所有输出，然后再使用。 如需了解详情，请参阅 适用于 Google Cloud 的 Gemini 和 Responsible AI。

您可以提供 Gemini 自然语言注释（或提示），以生成基于您的架构的查询。例如，您可以提示 Gemini 生成 SQL 来回答以下提示：

• “创建一个表来跟踪客户满意度调查问卷结果。”
• “将一个名为 birthday 的列添加到 Singers 表中。”
• “90 年代出生的歌手有多少？”

注意： 在 Spanner 中输入 Gemini 提示时，有关数据库架构的信息会包含在该提示中。这可能包括表和列的名称、数据类型及列说明。您的数据库架构和数据会保留在 Spanner 中，不会发送到 Gemini。

如需在 Spanner 中借助 Gemini 生成 SQL，请按照以下步骤操作：

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

   转到 Spanner

2. 从列表中选择一个实例。

3. 选择一个数据库。

4. 在导航窗格中，点击 Spanner Studio。探索器窗格会显示数据库中的对象列表。

5. 如需查询数据库，请点击 新的 SQL 编辑器标签页。确保已启用 SQL 生成功能。

6. 如需生成 SQL，请在查询编辑器中输入以 -- 开头后跟单行注释的注释，然后按 Return 键。

   例如，如果您输入提示 -- add a row to table singers 并按 Return，则 Gemini 会生成如下所示的 SQL：

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   如需使用 Singers 表继续此示例，如果您输入提示 -- show all singers born in the 70s，则 Gemini 会生成如下所示的 SQL：

   SELECT *
   FROM Singers
   WHERE Singers.BirthDate
   BETWEEN '1970-01-01' AND '1979-12-31'
   
   

   注意：每次输入相同的提示时，Gemini 可能会建议不同的语法。

7. 查看生成的 SQL 并执行以下任一操作：

   • 如需接受 Gemini 生成的 SQL，请按 Tab，然后点击运行以执行建议的 SQL。
   • 如需修改 Gemini 生成的 SQL，请按 Tab，修改 SQL，然后点击运行。
   • 如需忽略建议，请按 Esc 或继续输入。

在查询编辑器中补全 SQL 语句

为了帮助您编写 SQL 代码，Spanner 中的 Gemini 提供了 AI 辅助的代码补全建议。启用 Gemini 后，当您在 Spanner Studio 查询编辑器中输入文本时，Gemini 会预测并自动填充 SQL 代码。

内嵌代码建议

如需使用内嵌代码建议，请按照以下步骤操作：

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

   转到 Spanner

2. 从列表中选择一个实例。

3. 选择一个数据库。

4. 在导航窗格中，点击 Spanner Studio。

5. 如需查询数据库，请点击 新的 SQL 编辑器标签页。确保已启用 SQL 补全。

6. 输入查询并在行尾输入空格或换行符。输入文本时，Gemini 会显示根据所选数据库架构中支持的对象建议的 SQL。

   例如，如需向 Singers 表中添加一行，请开始编写以下 SQL：INSERT INTO Singers。

   Gemini 会建议如下所示的 SQL：

   INSERT INTO Singers
   (SingerId, FirstName, LastName, BirthDate)
   VALUES
     (1, 'Marc', 'Singer', '1970-03-24')
   

   注意 ：每次输入相同的 SQL 语句时，Gemini 可能会建议不同的 SQL 语法。

7. 查看 SQL 建议，然后执行以下任一操作：

   • 如需接受 Gemini 生成的 SQL，请按 Tab，然后点击运行以执行建议的 SQL。
   • 如需修改 Gemini 生成的 SQL，请按 Tab，修改 SQL，然后点击运行。
   • 如需忽略建议，请按 Esc 或继续输入。

“帮我编码”工具

如需使用帮我写代码工具，请按照以下步骤操作：

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

   转到 Spanner

2. 从列表中选择一个实例。

3. 选择一个数据库。

4. 在导航窗格中，点击 Spanner Studio。

5. 如需查询数据库，请点击 新建标签页。

6. 点击查询编辑器旁边的 pen_spark 帮我写代码。

7. 在帮我写代码窗口中，输入提示。例如，执行 add a row to table singers 操作，然后点击生成。

   Gemini 会生成如下所示的 SQL：

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   注意：每次输入相同的提示时，Gemini 可能会建议不同的语法。

8. 查看生成的 SQL 并执行以下任一操作：

   • 如需接受 Gemini 生成的 SQL，请点击插入以将语句插入查询编辑器中。然后，点击运行以执行建议的 SQL。
   • 如需让 Gemini 生成新查询，请点击修改。修改提示完成后，点击更新。然后，您可以决定接受新生成的语句或忽略建议。
   • 如需忽略建议，请关闭帮我写代码窗口。

在查询编辑器中解释 SQL 语句

您可以在 Spanner 中使用 Gemini 以自然语言解释 SQL 查询。此解释可帮助您了解复杂查询或长查询的语法、底层架构和业务上下文。

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

   转到 Spanner

2. 从列表中选择一个实例。

3. 选择一个数据库。

4. 在导航窗格中，点击 Spanner Studio。

5. 如需查询数据库，请点击 新建标签页。

6. 在查询编辑器中，粘贴查询。

7. 突出显示您希望 Gemini 解释的查询，然后点击 spark 解释此次查询。

   SQL 解释即会显示在 Gemini 窗格中。

后续步骤

• 阅读 Gemini for Google Cloud 概览。
• 了解 Gemini 如何使用您的数据。