使用 SQL Workbench 探索数据
使用 SQL Workbench 对数据进行故障排除并开发 SQL 查询。您可以在项目上下文中跨准备好的任务和数据仓库层探索数据并验证 SQL。
SQL Workbench 适用于使用数据仓库的数据管道项目。您可以在连接到项目的数据仓库中运行查询。
限制
-
仅支持只读 SQL 查询。数据修改语句将被阻止。
-
对象浏览器中不支持数据湖登陆和知识集市。
-
不支持宏。如果转换包含宏，则满负载转换将显示在 源查询 中。
所需权限
-
要运行查询，您必须在项目连接所在的空间中具有 可查看数据 权限。
-
要保存、编辑、重命名或删除 SQL 脚本，您必须在项目空间中具有 可编辑 权限。
有关空间角色的更多信息，请参阅 数据空间角色和权限。
打开 SQL Workbench
在数据管道项目中打开 SQL Workbench。SQL Workbench 始终在当前项目的上下文中运行。
-
单击顶部菜单中的 SQL Workbench。
浏览表
表 列出了以下位置中准备好的任务的表：
-
当前项目。
-
同一数据平台上的引用项目。
仅显示外部模式上的物理表。
对于 Qlik Open Lakehouse 项目，表 列出了当前项目和引用项目中的镜像任务。SQL Workbench 仅显示与项目的湖仓一体类型匹配的镜像任务：Snowflake、Redshift 或 Databricks。
对于每个表，您可以查看数据库、模式、列和数据类型。
-
单击 按任务类型筛选 以筛选任务。
-
单击 排序和分组 以排列任务并设置排序顺序。
添加更多项目
从一开始，您将只能看到当前项目中的任务。您可以添加更多项目以便在查询中使用它们。
-
单击
以添加更多可用项目。您可以从使用相同数据仓库的项目中进行选择。
选择项目并单击 应用。
所选项目中所有准备好的任务现在都可用。
对于 Qlik Open Lakehouse 项目，SQL Workbench 仅显示与项目的湖仓一体类型匹配的镜像任务。
创建查询
您可以使用一个或多个选项卡来编写 SQL 并运行选定的语句或当前语句。
每个选项卡都在其自己的会话中运行，这允许并行执行查询。
编辑查询时，您可以使用以下工具：
-
撤消上一次编辑 -
重做之前撤消的操作 -
自动格式化 SQL 代码 -
注释/取消注释当前行 -
在代码中搜索并替换文本
为表添加 SELECT 语句
您可以添加一个返回表的所有字段的 SELECT 语句。
-
单击 表 中表上的
，然后单击 添加 SELECT 语句。
返回所选表中所有字段的 SELECT 语句将添加到查询编辑器中。
从转换数据集添加查询
您可以添加在转换任务中创建的数据集的源查询。
-
单击 表 中数据集上的
，然后单击 添加源查询。
用于创建所选数据集的查询将添加到查询编辑器中。
运行查询
您可以运行整个查询，或通过单击 运行查询 来运行选定的语句。
-
如果您未在查询编辑器中选择任何内容，则将运行整个查询。
-
如果您在编辑器中选择了一条语句，则将运行该语句。
运行查询后，您可以在以下位置检查结果：
-
结果
查询返回的样本数据。
信息注释您必须在连接空间中具有 可查看数据 角色。此外，必须在您的租户中开启 在 Data Integration 中查看数据。 -
元数据
列出包含有关数据类型和可空性信息的列。
保存和管理 SQL 脚本
您可以通过单击 保存 在 SQL Workbench 中保存 SQL 脚本以供重复使用。脚本保存在项目中，所有项目用户都可以查看。您可以在 已保存的脚本 中列出、打开、重命名和删除脚本。
-
要删除脚本，请单击脚本上的
，然后单击 删除。 -
要重命名脚本，请单击脚本上的
，然后单击 编辑。
故障排除
-
如果查询执行因权限错误而失败，请验证您在项目空间和连接空间中是否具有所需的角色。
-
如果缺少对象，请验证源任务是否已准备好。
-
如果语句被阻止，请验证它是否为只读 SQL。
有关一般故障排除，请参阅 数据任务故障排除。