Query Editor UI指南

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

在Experience Platform UI的左侧导航菜单中,选择​查询​以打开Query Service工作区。 接下来,选择屏幕右上方的​创建查询​以开始编写查询。 此链接可从Query Service工作区中的任意页面访问。

图像

编写查询

查询编 辑器的组织方式,可尽可能轻松地编写查询。以下屏幕截图显示了编辑器在UI中的显示方式,其中​Play​按钮和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中生成输出数据集、删除或命名显示的查询,以及向查询添加计划。

此面板还显示有用的元数据,例如上次修改查询的时间以及修改查询的人员(如果适用)。 要生成数据集,请选择​输出数据集。 出现​输出数据集​对话框。 输入名称和描述,然后选择​运行查询。 新数据集显示在Platform用户界面的Query ServiceDatasets 选项卡中。

计划查询

注意

您只能向已创建、保存和运行的查询添加计划。 此外,您还将能够向参数化查询添加计划​

要向查询添加计划,请选择​添加计划

图像

此时将显示​计划详细信息​页。 在此页面上,您可以选择计划查询的频率、计划查询运行的日期以及要将查询导出到的数据集。

图像

您可以为​Frequency​选择以下选项:

  • 每小时:在您选择的日期期间,计划查询将每小时运行一次。
  • 每日:计划查询将在您选择的时间和日期期间每X天运行一次。请注意,选择的时间在​UTC​中,而不是您的本地时区。
  • 每周:所选查询将在您选择的周、时间和日期期间的天数运行。请注意,选择的时间在​UTC​中,而不是您的本地时区。
  • 每月:选定的查询将每月在您选择的日期、时间和日期期间运行。请注意,选择的时间在​UTC​中,而不是您的本地时区。
  • 每年:选定的查询将每年在您选择的日期、月、时间和日期期间运行。请注意,选择的时间在​UTC​中,而不是您的本地时区。

对于数据集,您可以选择使用现有数据集或创建新数据集。

重要

由于您使用的是现有数据集或创建了新数据集,因此​not​需要在查询中包含INSERT INTOCREATE TABLE AS SELECT ,因为数据集已经设置。 将INSERT INTOCREATE TABLE AS SELECT作为计划查询的一部分包含将导致错误。

确认所有这些详细信息后,选择​保存​以创建计划。

此时将重新显示查询详细信息页面,并显示新创建计划的详细信息,包括计划ID、计划本身和计划的输出数据集。 您可以使用计划ID查找有关计划查询本身运行的更多信息。 要了解更多信息,请阅读计划查询运行端点指南

注意

您只能使用UI计划​一个​查询模板。 如果要向查询模板添加其他计划,则需要使用API。 如果已使用API添加计划,您将使用UI添加​not​其他计划。 如果已将多个计划附加到查询模板,则只会显示最早的计划。 要了解如何使用API添加计划,请阅读计划查询端点指南

此外,如果要确保所查看的计划具有最新状态,则应刷新页面。

删除计划

您可以通过选择​删除计划​来删除计划。

图像

重要

如果要删除查询的计划,必须先禁用该计划。

保存查询

Query Editor 提供了保存函数,用于保存查询并稍后对其进行处理。要保存查询,请选择Query Editor右上角的​Save。 在保存查询之前,必须使用​查询详细信息​面板为查询提供名称。

如何查找以前的查询

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

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

注意

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

使用查询编辑器执行查询

要在Query Editor中运行查询,可以在编辑器中输入SQL,或从​Log​或​Browse​选项卡加载上一个查询,然后选择​Play。 查询执行状态显示在下面的​Console​选项卡中,输出数据显示在​Results​选项卡中。

控制台

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

图像

注意

控制台仅显示执行查询所导致的错误。 在执行查询之前,不会显示查询验证错误。

查询结果

查询完成后,结果显示在​Console​选项卡旁边的​Results​选项卡中。 此视图以表格形式显示查询的输出,最多显示100行。 利用此视图,可验证查询是否生成预期的输出。 要使用您的查询生成数据集,请删除对返回行的限制,然后运行查询CREATE TABLE tablename AS SELECT以生成带有输出的数据集。 有关如何从Query Editor中的查询结果生成数据集的说明,请参阅生成数据集教程

图像

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

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

后续步骤

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

在此页面上