为查询 / DML / DDL 使用工作表¶

功能概述¶

1. 对象浏览器。

2. 添加工作表。

3. 下拉菜单：

   • 管理工作表（搜索、打开或删除、重命名）。

   • 打开教程。

   • 加载脚本。

4. 下拉菜单：

   • 为当前工作表更改当前数据库、架构或仓库，同时避免工作丢失。

   • 恢复/暂停当前仓库或为其调整大小。

5. 下拉菜单：

   • 加载脚本。

   • 启用或禁用文本突出显示。

   • 显示/隐藏运行确认。

   • 删除当前工作表。

6. SQL 编辑器。

7. 下载结果。

8. 将结果复制到剪贴板。

9. 最大化或恢复结果。

10. 隐藏或显示列。

工作表旨在满足所有业务和工作流程需求，其中包括：

• 运行临时查询并执行其他 SQL 操作。

• 打开多个并发工作表，每个工作表都有自己单独的会话，允许在具有不同上下文的不同工作表中运行查询，而不会造成性能下降。

• 保存工作表以供后续使用。

• 打开您保存的工作表库中的工作表。

  备注

  • 保存的工作表无法在 Classic Console 外部访问。

  • 目前无法与其他用户共享已保存的工作表。

• 将工作站或网络中的 SQL 脚本文件加载到工作表中。加载脚本文件后，可以选择对其进行编辑，并将其保存到已保存工作表库中。

• 在不丢失工作的情况下退出登录。Snowflake 会保留每个工作表的静态内容，因此您后续可以再次登录，并恢复到上次离开的位置。Snowflake 会显示您退出登录时打开的工作表。

  调整窗格大小或折叠窗格时，宽度更改为 result 和 data preview 列，并且在 SQL 编辑器中，在以下情况下光标位置持续存在：

  • 在打开的工作表之间切换时。

  • 关闭并再次打开同一个工作表时。

  • 在多个用户会话之间。

• 为每个工作表指定不同的角色，并在不丢失工作的情况下切换角色。您可以执行工作表中的特定语句，然后切换角色，再继续在同一工作表中工作。

  备注

  您当前的界面角色决定了您打开的工作表的默认角色，但工作表不会与界面角色绑定。每个工作表都有自己的角色，可以单独进行设置。

• 在另一个浏览器或选项卡中登录 Snowflake。您在一个 Snowflake 实例中所做的任何工作表更改都会在几分钟后保留到另一个实例中。您可以继续在其他浏览器（或选项卡）中工作，而不需要重新输入工作内容。

• 如有必要，请刷新浏览器。如果您正在运行查询，在刷新完毕后，它们会恢复运行。如果您在 Snowflake 中退出登录，任何处于活跃状态的查询都会停止运行。

您还可以在此页面上执行其他任务，包括：

• 调整当前仓库的大小，从而动态增加或减少用于执行查询和其他 DML 语句的计算资源量。

• 导出选定查询/语句的结果（如结果仍然可用）。有关更多信息，请参阅 导出查询结果。

保存和管理工作表¶

在您输入的过程中，Snowflake 会自动保存工作表，并在用户会话之间保留工作表的当前状态。要组织工作表，请双击选项卡中的工作表标签（例如 Worksheet 2）并为工作表输入一个新的、更有意义的名称（例如 Sales Analysis）。

要打开已关闭的工作表，请点击打开的工作表选项卡右侧的向下箭头，然后点击 Open Worksheet。

1. 按标签搜索工作表。

2. 删除选定工作表。

3. 点击一行即可选择单个工作表。

   按 CMD (Mac) 或 CTRL (Windows) 键一次，然后点击多行即可选择多个工作表。

4. 双击标签可对其进行编辑。

5. 打开选定的工作表。

Open Worksheet 对话框支持以下操作：

使用对象浏览器¶

1. 预览表数据。

2. 双击将名称插入 SQL 编辑器。

通过对象浏览器，用户可以浏览为工作表选择的角色可访问的所有数据库、架构、表和视图。

在工作表上下文发生更改时，数据库和其他对象的列表会自动刷新。您还可以选择对象浏览器顶部的 Refresh 以立即查看对象变化。

对象浏览器可以随时折叠，为 SQL 编辑器和结果/历史记录窗格腾出更多空间。

管理仓库¶

点击上下文菜单可为工作表选择不同的活动仓库。您可以恢复或暂停所选仓库，或者调整仓库大小。

管理查询¶

查看查询详细信息¶

在执行查询时，状态栏中会显示当前查询的总持续时间。将鼠标悬停在该栏上可查看持续时间详情。

1. 悬停鼠标即可查看查询指标。点击 Query ID 链接可探索查询详情。弹出窗口提供将查询 ID 复制到操作系统临时内存中的链接，或者导航到查询历史记录的链接。

   

2. 点击以复制查询 ID。

3. 点击以导航至查询历史记录。

使用键盘快捷键为查询设置格式¶

工作表中的 SQL 编辑器支持使用以下键盘按键和组合键为查询和其他 SQL 语句设置格式：

制表位:

要在一行中插入制表位（使用 4 个字符的间隔），请按 Tab 键：

• 如果光标位于行首，则会插入 4 个空格。

• 如果光标行中间，则添加足够的空格，以到达下一个制表位。

缩进/减少缩进:

要按 2 个空格为一行（或多行）缩进/减少缩进，请将光标置于该行中的任意位置（或突出显示所需行），按住 CMD (Mac) 或 CTRL (Windows) 键，并输入以下一项或多项：

• 右方括号 (])，按照按下方括号按键的次数为行进行缩进。

• 左方括号 ([)，按照按下方括号按键的次数为行减少缩进。

如果缩进了一行，则缩进行之后的所有新行都会自动按相同数量的空格缩进。

注释:

要注释掉一行（或多行），请将光标置于该行中的任意位置（或突出显示所需行），按住 CMD (Mac) 或 CTRL (Windows) 键，并输入正斜杠 (/)。

文本突出显示:

要在打开的所有工作表中启用或禁用文本突出显示，请将光标置于工作表中的任意位置，按住 SHIFT + CMD (Mac) 或 SHIFT + CTRL (Windows) 键，并输入字母 K。

添加多个光标:

要在同一个工作表中添加多个光标，请按住 CMD (Mac) 或 CTRL (Windows) 键，并使用鼠标左键或触摸板点击每个新位置。

选择文本区域:

要选择文本区域，请按住 option (Mac) 或 ALT (Windows) 键。此时光标会变成十字准星的样式。使用鼠标左键或触摸板点击并拖动。

查找和替换文本字符串:

要搜索和替换工作表中的文本字符串，请执行以下操作：

1. 按下 CMD + option + F (Mac) 或 SHIFT + CTRL + F (Windows) 键。此时会显示一个 Replace 字段。

   要替换文本字符串的 全部 实例，请按下 CMD + option + SHIFT + F (Mac) 或 ALT + CTRL + SHIFT + F (Windows) 键。此时会显示一个 Replace All 字段。

2. 输入要替换的字符串，然后按 Enter 键。此时会显示一个 With 字段。

3. 输入替换字符串，然后按 Enter 键。此时将显示一组选项。

4. 点击所需选项：

   是:

   将字符串的当前实例替换为指定的替换项，然后跳转到下一个实例。

   否:

   保留字符串的当前实例，并跳转到下一个实例。

   全部:

   将字符串的所有实例替换为指定的替换项。

   Stop:

   停止搜索字符串实例。

备份您的工作表¶

Snowflake 建议您备份重建难度较大的复杂工作表或关键工作表。将各工作表的内容复制并粘贴到您可以保护的文件中。备份工作表可以防止其意外删除。

工作表元数据会存储在 Snowflake 用户暂存区的 worksheet_data 目录中。如您执行 REMOVE 命令并移除 worksheet_data 目录，则会删除您自己的工作表。已删除的工作表无法恢复。