Query Editor UI指南

Query Editor 是Adobe Experience Platform提供的交互式工具 Query Service，允许您在中编写、验证和运行客户体验数据查询 Experience Platform 用户界面。 Query Editor 支持开发用于分析和数据探索的查询，并允许您运行交互式查询以进行开发，以及运行非交互式查询以填充以下位置的数据集： Experience Platform.

有关概念和功能的更多信息 Query Service，请参见 查询服务概述. 要了解有关如何导航查询服务用户界面的更多信息，请访问 Platform，请参见 查询服务UI概述.

快速入门 getting-started

Query Editor 通过连接到 Query Service和查询仅在此连接处于活动状态时运行。

访问 Query Editor accessing-query-editor

在 Experience Platform UI，选择 查询 在左侧导航菜单中打开 Query Service 工作区。 接下来，要开始编写查询，请选择 创建查询 在屏幕的右上角。 此链接可从 Query Service 工作区。

正在连接到 Query Service connecting-to-query-service

查询编辑器需要几秒钟才能初始化，并在打开时连接到查询服务。 控制台将告诉您连接时间，如下所示。 如果在编辑器连接之前尝试运行查询，则会延迟执行，直到连接完成。

如何从运行查询 Query Editor run-a-query

查询执行自 Query Editor 以交互方式运行，这意味着如果您关闭浏览器或离开浏览器，查询将被取消。 对于通过查询输出生成数据集的查询，也是如此。

查询编辑器的增强版允许您在查询编辑器中编写多个查询并按顺序执行所有查询。 请参阅以下部分 执行多个顺序查询 以了解更多信息。

查询创作，使用 Query Editor query-authoring

使用 Query Editor，您可以编写、执行和保存客户体验数据查询。 执行或保存的所有查询 Query Editor 可供您组织中的所有用户使用，他们有权访问 Query Service.

增强的查询编辑器切换开关 enhanced-editor-toggle

通过UI切换，您可以在查询编辑器的旧版本和增强版本之间切换。 尽管增强版本更好地支持辅助功能和多主题，但默认情况下仍启用旧版本。启用增强版本以访问查询编辑器设置。

激活切换开关可将编辑器切换到浅色主题，并改善语法的清晰度。 查询编辑器输入字段上方还会显示一个设置图标，该图标包含自动完成切换功能。 从设置图标中，您可以启用深色主题或禁用/启用自动完成。

要启用深色或浅色主题，请选择设置图标( )，然后显示下拉菜单中的选项。

执行多个顺序查询 execute-multiple-sequential-queries

查询编辑器的增强版允许您在查询编辑器中编写多个查询并按顺序执行所有查询。

按顺序执行多个查询，每个查询都会生成日志条目。 但是，查询编辑器控制台中只显示第一个查询的结果。 如果需要排除问题或确认已执行的查询，请查看查询日志。 请参阅 查询日志文档 以了解更多信息。

执行选定的查询 execute-selected-query

如果您已经编写了多个查询，但只需要执行一个查询，则可以突出显示所选的查询并选择
运行选定的查询 图标。 默认情况下，此图标处于禁用状态，直到您在编辑器中选择查询语法。

结果计数 result-count

查询编辑器的行输出最多为50,000个。 您可以选择在查询编辑器控制台中一次显示的行数。 要更改控制台中显示的行数，请选择 结果计数 下拉菜单并从50、100、150、300和500选项中进行选择。

编写查询 writing-queries

查询编辑器 组织以尽可能方便编写查询。 下面的屏幕截图显示了编辑器在UI中的显示方式，其中包含SQL输入字段和 播放 突出显示。

为了最大限度地缩短开发时间，建议您开发对返回行数具有限制的查询。 例如：SELECT fields FROM table WHERE conditions LIMIT number_of_rows。验证查询是否生成预期输出后，删除限制并使用运行查询 CREATE TABLE tablename AS SELECT 以使用输出生成数据集。

在中编写工具 Query Editor writing-tools

设置文本格式 format-text

此 设置文本格式 功能通过添加标准化的语法样式使查询更易读取。 选择 设置文本格式 标准化查询编辑器中的所有文本。

复制SQL copy-sql

选择复制图标以将SQL从查询编辑器复制到剪贴板。 此复制功能可用于查询模板和查询编辑器中新创建的查询。

自动完成UI配置切换 auto-complete

此 Query Editor 在编写查询时，自动为查询建议可能的SQL关键字以及表或列详细信息。 默认情况下，自动完成功能处于启用状态，通过选择 语法自动完成 切换到“查询编辑器”的右上方。

自动完成配置设置针对每个用户，并在该用户的连续登录中被记住。

禁用此功能会阻止处理多个元数据命令，并提供通常有利于作者在编辑查询时提高速度的建议。

使用切换启用自动完成功能时，在短暂暂停后即可获得有关表和列名称以及SQL关键字的建议建议。 控制台中查询编辑器下方的成功消息指示该功能处于活动状态。

如果禁用自动完成功能，则需要刷新页面才能使功能生效。 禁用时，将显示一个确认对话框，其中包含三个选项 语法自动完成 切换：

要禁用自动完成功能，请选择相应的确认选项。

错误检测 error-detection

Query Editor 在编写查询时自动验证该查询，提供通用SQL验证和特定执行验证。 如果查询下方出现红色下划线（如下图所示），则表示查询中存在错误。

检测到错误时，您可以通过将鼠标悬停在SQL代码上来查看特定错误消息。

查询详细信息 query-details

要在查询编辑器中查看查询，请从中选择任何已保存的模板 模板 选项卡。 查询详细信息面板提供了更多信息和工具来管理所选查询。 它还显示有用的元数据，例如上次修改查询的时间以及修改查询的人员（如果适用）。

在详细信息面板中，您可以直接从UI生成输出数据集，删除或命名显示的查询，查看查询运行计划，并将查询添加到计划中。

要生成输出数据集，请选择 作为CTA运行. 此 输入输出数据集详细信息 出现对话框。 输入名称和说明，然后选择 作为CTA运行. 新数据集显示在中 数据集 浏览选项卡。 请参阅 查看数据集文档 了解有关贵组织可用数据集的更多信息。

在您执行 作为CTA运行 操作，此时会弹出一条确认消息，通知您操作成功。 此弹出消息包含一个链接，为导航到查询日志工作区提供了一种便捷的方式。 请参阅 查询日志文档 以了解有关查询日志的详细信息。

保存查询 saving-queries

此 Query Editor 提供保存功能，允许您保存查询并稍后处理它。 要保存查询，请选择 保存 在的右上角 Query Editor. 在保存查询之前，必须使用为查询提供一个名称 查询详细信息 面板。

在查询编辑器中保存查询时，将会弹出一条确认消息，通知您操作成功。 此弹出消息包含一个链接，为导航到查询计划工作区提供了一种便捷的方法。 请参阅 计划查询文档 以了解如何以自定义节奏运行查询。

计划的查询 scheduled-queries

可以从“查询编辑器”安排已另存为模板的查询。 计划查询允许您以自定义节奏自动运行查询。 您可以根据频率、日期和时间安排查询，还可以在必要时为结果选择输出数据集。 也可以通过UI禁用或删除查询计划。

在查询编辑器中设置计划。 使用查询编辑器时，您只能向已创建、保存和运行的查询添加计划。 同样的限制不适用于 Query Service API：

请参阅查询计划文档，了解如何 在UI中创建查询计划. 或者，要了解如何使用API添加计划，请参阅 计划查询端点指南.

任何计划查询都会添加到的列表 计划的查询 选项卡。 在该工作区中，您可以通过UI监控所有已计划查询作业的状态。 在 计划的查询 选项卡，您可以找到有关查询运行的重要信息并订阅警报。 可用信息包括状态、计划详细信息和运行失败时的错误消息/代码。 请参阅 监视计划查询文档 以了解更多信息。

如何查找以前的查询 previous-queries

从执行的所有查询 Query Editor 将在日志表中捕获。 您可以使用中的搜索功能 日志 选项卡查找查询执行。 已保存的查询列在 模板 选项卡。

如果计划了查询，则 计划的查询 选项卡提高了这些查询作业在UI中的可见性。 请参阅 查询监控文档 以了解更多信息。

使用查询编辑器执行查询 executing-queries

在中运行查询 Query Editor，您可以在编辑器中输入SQL或从以下位置加载以前的查询： 日志 或 模板 选项卡，然后选择 播放. 查询执行的状态显示在 控制台 选项卡，并且输出数据显示在 结果 选项卡。

控制台 console

控制台提供有关以下项目的状态和操作的信息： Query Service. 控制台显示与的连接状态 Query Service、正在执行的查询操作，以及由此查询生成的任何错误消息。

查询结果 query-results

查询完成后，结果将显示在 结果 选项卡，在 控制台 选项卡。 此视图显示查询的表格输出，根据您选择的结果显示50到500行结果 结果计数. 此视图允许您验证查询是否生成预期的输出。 要使用您的查询生成数据集，请删除对返回行的限制，然后运行查询 CREATE TABLE tablename AS SELECT 以使用输出生成数据集。 请参阅 生成数据集教程 有关如何从中的查询结果生成数据集的说明 Query Editor.

用例 use-cases

查询服务为跨行业和业务场景的各种用例提供解决方案。 这些实际示例展示了服务在满足各种需求方面的灵活性和影响。 至 了解查询服务如何为您的特定业务需求带来价值中，了解用例文档的完整集合。 了解如何使用查询服务提供洞察信息和解决方案，以增强运营效率和业务成功。

运行查询 Query Service 教程视频 query-tutorial-video

以下视频介绍了如何在Adobe Experience Platform界面和PSQL客户端中运行查询。 此视频还演示了如何在XDM对象中使用单个属性、Adobe定义的函数，以及如何使用CREATE TABLE AS SELECT (CTAS)查询。

后续步骤

现在您知道了中提供了哪些功能 Query Editor 以及如何导航应用程序，您可以直接在中开始创作自己的查询 Platform. 有关在中针对数据集运行SQL查询的详细信息 Data Lake，请参阅指南，网址为 正在运行查询.