文档Experience Platform查询服务指南

使用SQL创建派生数据集

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 用户
  • 开发人员

了解如何使用SQL查询处理和转换现有数据集的数据，以创建为用户档案启用的派生数据集。 此工作流提供了一种高效、替代的方法，可为您的Real-time Customer Profile业务用例创建派生数据集。

本文档概述了各种方便的SQL扩展，这些扩展可生成派生的数据集以用于Real-time Customer Profile。 该工作流简化了原本必须通过各种API调用或Platform UI交互完成的流程。

通常，生成和发布针对Real-time Customer Profile的派生数据集需要以下步骤：

  • 创建身份命名空间（如果尚不存在）。
  • 如有必要，创建数据类型以存储派生的数据集。
  • 使用该数据类型创建字段组以存储派生的数据集信息。
  • 使用之前创建的命名空间创建或分配主标识列。
  • 使用之前创建的字段组和数据类型创建架构。
  • 使用架构创建新数据集，并根据需要为用户档案启用该数据集。
  • 可以选择将数据集标记为已启用配置文件。

完成上述步骤后，即可填充数据集。 如果为用户档案启用了数据集，则还可以创建引用新数据集的区段并开始生成见解。

查询服务允许您使用SQL查询执行上面列出的所有操作。 这包括在需要时更改数据集和字段组。

创建一个表，并带有一个为配置文件启用该表的选项 enable-dataset-for-profile

NOTE
下面提供的SQL查询假定使用预先存在的命名空间。

使用创建表作为选择(CTAS)查询创建数据集、分配数据类型、设置主标识、创建架构并将其标记为启用配置文件。 下面的示例SQL语句创建一个数据集，并将其用于Real-time Customer Data Platform (Real-Time CDP)。 您的SQL查询将遵循以下示例中显示的格式：

CREATE TABLE <your_table_name> [IF NOT EXISTS] (fieldname <your_data_type> primary identity namespace <your_namespace>, [field_name2 <your_data_type>]) [WITH(LABEL='PROFILE')];

支持的数据类型包括：布尔值、日期、日期时间、文本、浮点、bigint、整数、映射、数组和结构/行。

下面的SQl代码块提供了用于定义结构/行、映射和数组数据类型的示例。 第一行演示了行语法。 第二行演示映射语法，第三行演示数组语法。

ROW (Column_name <data_type> [, column name <data_type> ]*)
MAP <data_type, data_type>
ARRAY <data_type>

或者，也可以通过Platform UI为配置文件启用数据集。 有关将数据集标记为已为配置文件启用的详细信息，请参阅为实时客户配置文件启用数据集文档。

在下面的示例查询中，decile_table数据集是以id作为主标识列创建的，具有命名空间IDFA。 它还具有映射数据类型的名为decile1Month的字段。 已为配置文件启用创建的表(decile_table)。

CREATE TABLE decile_table (id text PRIMARY KEY NAMESPACE 'IDFA',
            decile1Month map<text, integer>) WITH (label='PROFILE');

成功执行查询时，数据集ID将返回到控制台，如下面的示例所示。

Created Table DataSet Id
>
637fd84969ba291e62dba79f
(1 row)

在CREATE TABLE命令上使用label='PROFILE'创建启用配置文件的数据集。 默认情况下，upsert功能处于打开状态。 可以使用ALTER命令覆盖upsert功能，如下面的示例所示。

ALTER TABLE <your_table_name> DROP label upsert;

有关在CTAS查询🔗中使用ALTER TABLE命令和标签的详细信息，请参阅SQl语法文档。

帮助通过SQL管理派生数据集的构造

下面介绍的功能在通过SQL管理派生数据集时非常有用。

更改要为配置文件启用的现有数据集 enable-existing-dataset-for-profile

ALTER TABLE SQL构造可用于为配置文件启用现有数据集。 这要求向架构和相应的数据集中添加启用配置文件的标记。

ALTER TABLE your_decile_table ADD label 'PROFILE';
NOTE
成功执行ALTER TABLE命令后，控制台返回ALTER SUCCESS。

向现有数据集添加主要身份 add-primary-identity

将数据集中的现有列标记为主标识集，否则会导致错误。 要使用SQL设置主标识，请使用下面显示的查询格式。

ALTER TABLE <your_table_name> ADD CONSTRAINT primary identity NAMESPACE

例如：

ALTER TABLE test1_dataset ADD CONSTRAINT PRIMARY KEY(id2) NAMESPACE 'IDFA';

在提供的示例中，id2是test1_dataset中的现有列。

为配置文件禁用数据集 disable-dataset-for-profile

如果要为配置文件禁用表，则必须使用DROP命令。 下面显示了使用DROP的示例SQL语句。

ALTER TABLE table_name DROP LABEL 'PROFILE';

例如：

ALTER TABLE decile_table DROP label 'PROFILE';

此SQL语句提供了使用API调用的高效替代方法。 有关详细信息，请参阅有关如何使用数据集API禁用用于Real-Time CDP的数据集的文档。

允许为数据集更新和插入功能 enable-upsert-functionality-for-dataset

UPSERT命令允许您在表中插入新记录或更新现有数据。 具体来说，如果表中已存在指定的值，它允许您更新现有行；如果指定的值不存在，它允许您插入新行。

下面显示了使用正确格式的示例语句。

ALTER TABLE table_name ADD LABEL 'UPSERT';

例如：

ALTER TABLE table_with_a_decile ADD label 'UPSERT';

此SQL语句提供了使用API调用的高效替代方法。 有关详细信息，请参阅有关如何使用数据集API🔗启用用于Real-Time CDP和UPSERT的数据集的文档。

禁用数据集的更新和插入功能 disable-upsert-functionality-for-dataset

此命令禁用更新行并将其插入到数据集的功能。

下面显示了使用正确格式的示例语句。

ALTER TABLE table_name DROP LABEL 'UPSERT';

例如：

ALTER TABLE table_with_a_decile DROP label 'UPSERT';

显示与每个表关联的其他表信息 show-labels-for-tables

为启用配置文件的数据集保留其他元数据。 使用SHOW TABLES命令显示一个额外的labels列，该列提供有关与表关联的任何标签的信息。

此命令的输出示例如下所示：

       name          |        dataSetId         |     dataSet    | description | labels
---------------------+--------------------------+----------------+-------------+----------
 luma_midvalues      | 5bac030c29bb8d12fa992e58 | Luma midValues |             | false
 luma_postvalues     | 5c86b896b3c162151785b43c | Luma midValues |             | false
 table_with_a_decile | 5c86b896b3c162151785b43c | Luma midValues |             | 'UPSERT', 'PROFILE'
(3 rows)

从示例中可以看到table_with_a_decile已为配置文件启用，并应用于标签，如'UPSERT'，'PROFILE'，如前所述。

使用SQL创建字段组

现在可以通过使用SQL创建字段组。 为在平台UI中使用架构编辑器或对架构注册表进行API调用提供了替代方法。

下面显示了创建字段组的示例语句。

CREATE FIELDGROUP <field_group_name> [IF NOT EXISTS]  (field_name <data_type> primary identity namespace <namespace>, [field_name_2 >data_type>]) [ WITH(LABEL='PROFILE') ];
IMPORTANT
如果语句中未提供label标志或字段组已存在，则通过SQL创建字段组将失败。
请确保查询包含IF NOT EXISTS子句，以避免查询失败，因为该字段组已存在。

现实世界的例子可能与下面所示的例子类似。

CREATE FIELDGROUP field_group_for_test123 (decile1Month map<text, integer>, decile3Month map<text, integer>, decile6Month map<text, integer>, decile9Month map<text, integer>, decile12Month map<text, integer>, decilelietime map<text, integer>) WITH (LABEL-'PROFILE');

成功执行此语句将返回创建的字段组ID。 例如：c731a1eafdfdecae1683c6dca197c66ed2c2b49ecd3a9525。

有关替代方法的详细信息，请参阅有关如何在架构编辑器🔗中创建新字段组或使用架构注册表API的文档。

放置字段组

有时可能需要从架构注册表中删除字段组。 这是通过执行具有字段组ID的DROP FIELDGROUP命令来完成的。

DROP FIELDGROUP [IF EXISTS] <your_field_group_id>;

例如：

DROP FIELDGROUP field_group_for_test123;
IMPORTANT
如果字段组不存在，则通过SQL删除字段组将失败。 请确保语句包含IF EXISTS子句以避免查询失败。

显示表的所有字段组名和ID

SHOW FIELDGROUPS命令返回一个表，其中包含表的名称、fieldgroupId和所有者。

此命令的输出示例如下所示：

       name                      |        fieldgroupId                             |     owner      |
---------------------------------+-------------------------------------------------+-----------------
 AEP Mobile Lifecycle Details    | _experience.aep-mobile-lifecycle-details        | Luma midValues |
 AEP Web SDK ExperienceEvent     | _experience.aep-web-sdk-experienceevent         | Luma midValues |
 AJO Classification Fields       | _experience.journeyOrchestration.classification | Luma midValues |
 AJO Entity Fields               | _experience.customerJourneyManagement.entities  | Luma midValues |
(4 rows)

后续步骤

阅读本文档后，您对如何使用SQL基于派生数据集创建用户档案和启用更新插入的数据集有了更好的了解。 现在，您可以将此数据集与批量摄取工作流一起使用，以更新用户档案数据。 要了解有关将数据摄取到Adobe Experience Platform的更多信息，请从阅读数据摄取概述开始。

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb