电子表格插件中的 UI 选项

电子表格插件提供跨多个功能和特定于单个面板的其他控件的通用 UI 元素。

连接信息

大多数插件面板的顶部显示有关活动连接的信息，包括数据库 URL、方案、连接状态以及连接到期之前的剩余会话时间。对于 OCI IAM 连接，它还会显示连接的用户。

注意：

尽管加载项与数据库保持活动连接，但检索到的数据是电子表格本地数据。如果不活动或连接超时，加载项将显示通知并建议您重新连接到数据库。

使用 SQL 查询编辑器

SQL 查询编辑器是您在运行 SQL 语句之前编写、编辑和查看 SQL 语句的区域。

可以手动输入查询，也可以从对象浏览器中选择表、视图和列，以帮助创建 SQL 语句。SQL 查询编辑器显示查询的行号和语法突出显示。

查询编辑器中可用的操作取决于您使用的加载项功能。通常，您可以将以下选项与 SQL 查询编辑器结合使用：

  • 运行

    第一个按钮以带三角形的圆形显示，是运行按钮。单击此按钮可执行 SQL 语句并在所选工作表中显示查询结果。

  • 清除 SQL Content

    Run（运行）旁边的橡皮擦图标可从查询编辑器中删除当前 SQL 语句。

  • 从工作表检索查询

    此按钮从活动工作表检索 SQL 查询，并将其显示在 SQL 查询编辑器中。然后，您可以重新编辑并运行查询。

  • 共享为表超链接

    此选项仅可用于使用直接 SQL 和数据分析生成的查询结果。创建表超链接并将其与其他用户共享，以便他们可以将只读查询结果加载到电子表格中。

注意：

Add-in for Excel 提供了包含其他选项（例如重新加载插件窗口）的浮动菜单。单击插件窗口右侧的小箭头以打开浮动菜单。

为查询结果选择工作表

您可以使用默认工作表或选择其他工作表来显示结果。

注意：

如果在同一工作表中运行另一个查询，加载项将使用新查询的结果刷新工作表。

要将另一个工作表用于其他查询，请执行以下任一操作：

  • 从电子表格插件中，单击加号 ( + ) 按钮，在添加新工作表下指定名称，然后单击勾选按钮。在运行查询时，插件将插入新工作表。左箭头按钮是取消并返回。

  • 使用 Excel 或 Google Sheets 中的选项插入新工作表。

然后，您可以从选择工作表中选择新工作表并查看结果。

查询消息

除了查询结果外，工作表还显示以下查询信息：

  • 数据库 URL

  • 创建和运行查询的数据库用户或方案

  • 实际 SQL 查询

  • 刷新配置

  • 查询的日期和时间。

在 SQL 查询中使用绑定变量

可以在 SQL 查询中使用绑定变量来在运行时提供值。通过使用冒号 (：) 后跟变量名称，在 SQL 语句中定义绑定变量。

例如：

SELECT *
FROM employees
WHERE city = :ct;

运行查询时，加载项会提示您为绑定变量 :ct 输入值。在提供值（例如 Austin ）后，查询将使用该值运行。结果显示的查询信息包括绑定变量赋值，例如 :ct=Austin。

您可以在查询中包括多个绑定变量。该插件保留每个绑定变量最近使用的值。再次运行查询时，可以选择最近值或输入新值。您还可以从查询参数对话框中清除以前保存的值。

刷新查询结果

您可以使用刷新查询重新运行保存的查询并更新工作表中的结果，而无需打开直接 SQL 、数据分析或自然语言面板。

要刷新查询结果，请执行以下操作：

  1. 选择包含由电子表格插件生成的查询结果的工作表。

  2. 单击刷新查询。

    插件将重新运行保存的查询并使用最新结果更新当前工作表。

如果工作簿包含具有可刷新查询结果的其他工作表，该插件将显示剩余的工作表数并提示您刷新它们。刷新完成后，插件将显示一个报告，该报告指示已成功刷新的工作表并标识任何无法刷新的工作表。

注意：

如果保存并连接了相应的数据库连接，则可以刷新工作表。电子表格插件使用保存的连接信息刷新每个工作表，即使该连接不是活动连接也是如此。

在以下情况下，刷新操作可能会失败：

  • 保存的可视化不再与查询返回的列匹配。

  • 没有与工作表关联的数据库 URL 和用户匹配的已保存连接。

  • 所需的数据库连接已断开连接。

刷新报告提供任何失败工作表的详细信息。根据具体原因，您可以更新查询或可视化，添加或导入匹配的已保存连接，或者在重新刷新之前重新连接所需的数据库连接。

处理大型数据

对于具有大型数据集的查询（例如，包含超过 10,000 条记录的结果），如果要查看整个结果，加载项将显示一个确认窗口。

注意：

在使用数据透视表时，加载完整数据以获得聚合的准确结果。

父主题：使用电子表格插件功能