Query Editor 用户指南

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

有关的概念和功能的更多信 Query Service息,请参 阅查询服务概述。 要进一步了解如何在上的查询服务用户界面导航, Platform请参阅 查询服务UI概述

入门指南

Query Editor 通过连接提供灵活的查询执 Query Service行,并且查询将仅在此连接处于活动状态时运行。

连接到 Query Service

Query Editor 初始化并连接到打开时 Query Service 需要几秒钟。 控制台会告诉您何时连接,如下所示。 如果尝试在编辑器连接之前运行查询,则会延迟执行,直到连接完成。

图像

查询如何从 Query Editor

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

查询创作使用 Query Editor

使 Query Editor用,您可以编写、执行和保存查询以获得客户体验数据。 在中执行或保 Query Editor存的所有查询对组织中有权访问的所有用户都可用 Query Service。

访问 Query Editor

在UI Experience Platform 中,单击左 侧导 航菜单中的查询以打开工 Query Service 作区。 然后,单 击屏幕右 上方的“创建查询”以开始编写查询。 此链接可从工作区中的任何页面 Query Service 访问。

图像

编写查询

查询编辑器 ,可以尽可能轻松地编写查询。 下面的屏幕截图显示了编辑器在UI中的显示方式,并突 出显示 “播放”按钮和SQL条目字段。

图像

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

在 Query Editor

  • 自动语法突出显示: 使读取和组织SQL更简单。

图像

  • SQL关键字自动完成: 开始键入查询,然后使用箭头键导航到所需的词并按 Enter

图像

  • 表和字段自动完成: 开始键入要从的表名 SELECT 称,然后使用箭头键导航到要查找的表,然后按 Enter。 选择表后,自动完成将识别该表中的字段。

图像

错误检测

Query Editor 在编写查询时自动验证该数据,提供通用SQL验证和特定执行验证。 如果查询下方显示红色下划线(如下图所示),则表示查询内有错误。

图像

检测到错误后,可以将鼠标悬停在SQL代码上,以视图特定的错误消息。

图像

查询详细信息

当您在中查看查询时, Query Editor“查询 详细信息 ”面板提供用于管理选定查询的工具。

图像

此面板允许您直接从UI中生成输出数据集,删除或命名显示的查询,并在SQL查询选项卡上以易于复制的格式视图 SQL代码 。 此面板还显示有用的元数据,如上次修改查询的时间以及修改者(如果适用)。 要生成数据集,请单击“ 输出数据集”。 将显 示“输出数据集 ”对话框。 输入名称和说明,然后单击“ 运行查询”。 新数据集显示在用户界 面的 “数据集 Query Service ”选项卡中 Platform。

保存查询

Query Editor 提供保存功能,允许您保存查询并稍后处理。 要保存查询,请 单击 右上角的“保存” Query Editor。 在保存查询之前,必须使用“查询详细信息”面板为查询提 供名称

如何查找以前的查询

从中执行的所 Query Editor 有查询都捕获在日志表中。 您可以使用“日志”选项卡中的 搜索功 能来查找查询执行。 保存的查询列在“浏 ”选项卡中。

有关更 多信息,请参阅查询 服务UI概述。

注意

未执行的查询不会由日志保存。 要使查询在中可用, Query Service必须在中运行或保存该 Query Editor。

使用查询编辑器执行查询

要在中运行查询 Query Editor,您可以在编辑器中输入SQL,或从“日志”或“浏览”选 项卡加载 以前的 查询,然后单 击“播放 。 查询执行状态显示在下面的 控制台 选项卡中,输出数据显示在结果 选项卡中

控制台

控制台提供有关状态和操作的信息 Query Service。 控制台显示连接状态、 Query Service正在执行的查询操作以及这些查询产生的任何错误消息。

图像

注意

该控制台仅显示因执行查询而导致的错误。 在执行查询之前,它不显示查询验证错误。

查询结果

查询完成后,结果将显示在“结果”选 项卡 (“控制台”选 项卡旁 )。 此视图显示查询的表格输出,最多显示100行。 此视图允许您验证查询是否生成预期输出。 要使用查询生成数据集,请删除对返回行的限制,然后使用运行查询 CREATE TABLE tablename AS SELECT 生成带有输出的数据集。 有关如何 根据查询结果 (在中)生成数据集的说明,请参阅生成数据集教程 Query Editor。

图像

使用教程视频运 Query Service 行查询

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

后续步骤

现在,您已经了解了应用程序中的 Query Editor 哪些功能以及如何导航,您可以直接在中开始创作自己的查询 Platform。 有关针对中的数据集运行SQL查询的 Data Lake详细信息,请参阅运行查询 的指南。 有关使用Adobe Analytics和Adobe Target数据的示例SQL查询,请参阅示 例查询参考

在此页面上