Query Service 疑难解答指南

SELECT * FROM customers LIMIT 0;

• 将查询转换为CTAS查询 并计划运行。 计划运行可以执行以下任一操作 通过UI 或 API.
• 通过应用附加数据块，对较小的数据块执行查询 筛选条件.
• 执行EXPLAIN命令 收集更多细节。
• 查看数据集中数据的统计信息。
• 将查询转换为简化表单，然后使用 准备报表.

• 登录Experience Platform后，选择 数据集 在UI的左侧导航中导航到 数据集 功能板。
• 数据集 浏览 选项卡。 您可以使用搜索栏优化可用选项。 从显示的列表中选择一个数据集。

• 的 数据集活动 屏幕。 选择 预览数据集 打开XDM架构对话框以及所选数据集中扁平化数据的表格视图。 有关更多详细信息，请参阅 预览数据集文档

• 从架构中选择任意字段，以在扁平列中显示其内容。 列的名称显示在页面右侧其内容上方。 您应复制此名称以用于查询此数据集。

有关 如何使用嵌套数据结构 使用查询编辑器或第三方客户端。

处理过程中查询卡住的原因可能有多种。 要确定确切原因，需要逐个案例进行深入分析。 联系Adobe客户支持 这个过程。

Adobe客户支持电话号码的完整列表 可在Adobe帮助页面上找到。 或者，也可以通过完成以下步骤在线找到帮助：

• 导航到 https://www.adobe.com/ 在Web浏览器中。
• 在顶部导航栏的右侧，选择 登录.

• 使用您在Adobe ID许可证中注册的Adobe和密码。
• 选择 帮助和支持 中。

此时会显示包含 帮助和支持 中。 选择 联系我们 要打开Adobe客户关怀虚拟助理，请选择 企业支持 为大型组织提供专门帮助。

请参阅 匿名块文档 以了解更多详细信息。

1. 使用现有 Adobe定义的函数 以确定是否满足用例需求。
2. 如果上一个建议不符合您的用例，则应使用 窗口函数. 窗口函数查看序列中的所有事件。 它们还允许您查看历史数据，并可用于任何组合。

使用GET命令检索多个查询。 有关如何对API进行调用的信息，请参阅 示例API调用文档.

在响应中，确定要调查的查询，然后使用其发出另一个GET请求 id 值。 有关完整说明，请参阅 按ID文档检索查询.

成功响应会返回HTTP状态200，并包含 errors 数组。 为简便起见，缩短了响应。

{
    "isInsertInto": false,
    "request": {
                "dbName": "prod:all",
                "sql": "SELECT *\nFROM\n  accounts\nLIMIT 10\n"
            },
    "clientId": "8c2455819a624534bb665c43c3759877",
    "state": "SUCCESS",
    "rowCount": 0,
    "errors": [{
      'code': '58000',
      'message': 'Batch query execution gets : [failed reason ErrorCode: 58000 Batch query execution gets : [Analysis error encountered. Reason: [sessionId: f055dc73-1fbd-4c9c-8645-efa609da0a7b Function [varchar] not defined.]]]',
      'errorType': 'USER_ERROR'
      }],
    "isCTAS": false,
    "version": 1,
    "id": "343388b0-e0dd-4227-a75b-7fc945ef408a",
}

的 查询服务API参考文档 提供有关所有可用端点的更多信息。

以下示例演示了CTAS语法和struct数据类型的用法：

CREATE TABLE table_name WITH (SCHEMA='schema_name')

AS SELECT '1' as _id,

 STRUCT

  ('2021-02-17T15:39:29.0Z' AS taskActualCompletionDate,

    '2020-09-09T21:21:16.0Z' AS taskActualStartDate,

    'Consulting' AS taskdescription,

    '5f6527c10011e09b89666c52d9a8c564' AS taskguide,

    'Stakeholder Consulting Engagement' AS taskname,

    '2020-09-09T15:00:00.0Z' AS taskPlannedStartDate,

    '2021-02-15T11:00:00.0Z' AS taskPlannedCompletionDate

  ) AS _workfront ;

您还可以使用小查询确认数据集包含数据，例如：

SELECT count(1) FROM myTableName

您还应查看相关文档，以获取有关如何执行操作的指导 UI中的计划查询 通过 API.

以下是使用 Query Editor. 它们不适用于 Query Service API:
您只能向已创建、保存和运行的查询添加计划。
您 无法 向参数化查询添加计划。
计划查询 无法 包含匿名块。
您只能计划 one 使用UI查询模板。 如果要向查询模板添加其他计划，则需要使用API。 如果已使用API添加计划，则您将无法使用UI添加其他计划。

SELECT * FROM <table> WHERE 1=0

例如，您可以创建临时表：

CREATE temp TABLE temp_dataset AS
SELECT *
FROM actual_dataset
WHERE 1 = 0;

然后，您可以按如下方式使用临时表：

INSERT INTO temp_dataset
SELECT a._company AS _company,
a._id AS _id,
a.timestamp AS timestamp
FROM actual_dataset a
WHERE timestamp >= TO_TIMESTAMP('2021-01-21 12:00:00')
AND timestamp < TO_TIMESTAMP('2021-01-21 13:00:00')
LIMIT 100;

查询服务支持内置的SQL函数，以将给定时间戳转换为UTC格式和从UTC格式转换为SQL函数。 和 to_utc_timestamp() 和 from_utc_timestamp() 方法采用两个参数：时间戳和时区。

转换为UTC时间戳

的 to_utc_timestamp() 方法解释给定参数并转换它 到本地时区的时间戳 UTC格式。 例如，韩国首尔的时区是UTC/GMT +9小时。 通过提供仅限日期的时间戳，方法会使用上午的默认值“午夜”。 时间戳和时区将转换为UTC格式，从该区域的时间转换为本地区域的UTC时间戳。

SELECT to_utc_timestamp('2021-08-31', 'Asia/Seoul');

查询在用户的本地时间中返回时间戳。 在这种情况下，首尔会提前9小时，前一天下午3点。

2021-08-30 15:00:00

再举一个示例，如果给定的时间戳是 2021-07-14 12:40:00.0 对于 Asia/Seoul 时区，返回的UTC时间戳为 2021-07-14 03:40:00.0

查询服务UI中提供的控制台输出是一种更易读的格式：

8/30/2021, 3:00 PM

从UTC时间戳转换

的 from_utc_timestamp() 方法解释给定参数 从本地时区的时间戳 和以UTC格式提供所需区域的等效时间戳。 在以下示例中，小时为用户本地时区中的下午2:40。 作为变量传递的首尔时区比本地时区提前九小时。

SELECT from_utc_timestamp('2021-08-31 14:40:00.0', 'Asia/Seoul');

查询会为作为参数传递的时区返回UTC格式的时间戳。 结果会比运行查询的时区早九小时。

8/31/2021, 11:40 PM

如何过滤我的时间序列数据？

SELECT a._company  AS _company,
       a._id       AS _id,
       a.timestamp AS timestamp
FROM   dataset a
WHERE  timestamp >= To_timestamp('2021-01-21 12:00:00')
       AND timestamp < To_timestamp('2021-01-21 13:00:00')

例如，如下所示，缺少时间组件将导致错误：

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021' AS timestamp)

正确使用 CAST 运算符如下所示：

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021 00:00:00' AS timestamp)

而不是使用 NOT IN，则可以使用 NOT EXISTS 或 LEFT OUTER JOIN.

例如，如果您创建了以下表：

CREATE TABLE T1 (ID INT)
CREATE TABLE T2 (ID INT)
INSERT INTO T1 VALUES (1)
INSERT INTO T1 VALUES (2)
INSERT INTO T1 VALUES (3)
INSERT INTO T2 VALUES (1)
INSERT INTO T2 VALUES (2)

如果您使用 NOT EXISTS 运算符，您可以使用 NOT IN 运算符：

SELECT ID FROM T1
WHERE NOT EXISTS
(SELECT ID FROM T2 WHERE T1.ID = T2.ID)

或者，如果您使用 LEFT OUTER JOIN 运算符，您可以使用 NOT IN 运算符：

SELECT T1.ID FROM T1
LEFT OUTER JOIN T2 ON T1.ID = T2.ID
WHERE T2.ID IS NULL

使用PSQL客户端时，有两种方法可保存查询结果。 您可以使用 COPY TO 命令或使用以下格式创建语句：

SELECT column1, column2
FROM <table_name>
\g <table_name>.out

关于使用 COPY TO 命令 可在SQL语法参考文档中找到。

如果要缩短功能板的响应时间，您应当实施Business Intelligence(BI)服务器作为查询服务和BI工具之间的缓存层。 通常，大多数BI工具都为服务器提供附加服务。

添加缓存服务器层的目的是缓存来自查询服务的数据，并利用这些数据对功能板来加速响应。 这是可能的，因为每天都会在BI服务器中缓存执行查询的结果。 然后，缓存服务器会向具有相同查询的任何用户提供这些结果，以减少延迟。 有关此设置的说明，请参阅您所使用的实用工具或第三方工具的文档。

ErrorCode: 58000 Internal System Error [Invalid table your_table_name. historyMeta can be used on datalake tables only.]

发生此错误是因为查询没有返回值。 此行为现已修复，可返回以下消息：

Query complete in {timeframe}. 0 rows returned.