常見問答

SELECT * FROM customers LIMIT 0;

• 將查詢轉換為CTAS查詢 並排程執行。 排程執行可以執行以下任一操作 透過UI 或 API.
• 套用其他選項，在較小的資料區塊上執行查詢 篩選條件.
• 執行EXPLAIN命令 以收集更多詳細資訊。
• 檢閱資料集中的資料統計資料。
• 將查詢轉換為簡化表單，然後使用重新執行 準備的陳述式.

• 登入Experience Platform後，選取 資料集 在UI的左側導覽中導覽至 資料集 儀表板。
• 資料集 瀏覽 標籤開啟。 您可以使用搜尋列來調整可用選項。 從顯示的清單中選取資料集。

• 此 資料集活動 畫面隨即顯示。 選取 預覽資料集 以開啟XDM結構描述的對話方塊，以及所選資料集中平面化資料的表格檢視。 如需詳細資訊，請參閱 預覽資料集檔案

• 從結構描述中選取任何欄位，以在平面化欄中顯示其內容。 欄的名稱會顯示在頁面右側的內容上方。 您應複製此名稱以用於查詢此資料集。

如需下列專案的完整指引，請參閱檔案： 如何使用巢狀資料結構 使用查詢編輯器或第三方使用者端。

查詢在處理期間卡住的原因不勝列舉。 若要判斷確切的原因，需要逐案進行深入分析。 聯絡Adobe客戶支援 成為這個程式。

Adobe客戶支援電話號碼的完整清單 可在Adobe說明頁面上取得。 或者，您也可以完成下列步驟，線上上找到說明：

• 導覽至 https://www.adobe.com/ 在網頁瀏覽器中。
• 在頂端導覽列的右側，選取 登入.

• 使用已在您的Adobe授權中註冊的Adobe ID和密碼。
• 選取 說明與支援 從頂端導覽列取得。

下拉式清單橫幅隨即出現，其中包含 說明與支援 區段。 選取 聯絡我們 開啟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語法和結構資料型別：

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：
您只能將排程新增至已建立、儲存和執行的查詢。
您 無法 將排程新增至引數化查詢。
排定的查詢 無法 包含匿名區塊。
您只能排程 一 使用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格式轉換。 兩者皆有 to_utc_timestamp() 和 from_utc_timestamp() 方法會採用兩個引數：timestamp和timezone。

轉換為UTC時間戳記

此 to_utc_timestamp() 方法會解譯指定引數並將其轉換 至您當地時區的時間戳記 UTC格式。 例如，韓國首爾的時區是UTC/GMT +9小時。 藉由提供僅限日期的時間戳記，方法會使用早上午夜的預設值。 時間戳記和時區會從該地區的時間轉換為UTC格式，再轉換為您當地地區的UTC時間戳記。

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

查詢會傳回以使用者當地時間為單位的時間戳記。 在此案例中，前一天下午3點（因為首爾）比前一天晚9小時。

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

• 以時間系列資料為基礎的時間篩選。
• 已針對結構資料型別最佳化向下推送。
• 針對陣列和對應資料型別最佳化成本與記憶體下壓。
• 使用快照進行增量處理。
• 持續存在的資料格式。

• 使用僅SELECT陳述式並賦予資料集唯讀存取權。 此外，指派管理查詢許可權。
• 使用SELECT/INSERT/CREATE陳述式，並賦予資料集寫入許可權。 此外，指派查詢管理許可權。
• 使用具有上述建議的整合帳戶，並指派查詢整合許可權。

使用PSQL使用者端時，有兩種方式可儲存查詢結果。 您可以使用 COPY TO 命令或使用下列格式建立陳述式：

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

使用指南 COPY TO 命令 可在SQL語法參考檔案中找到。

SELECT * FROM prod_table LIMIT 1;

應該寫成：

SELECT * FROM prod_table
WHERE
timestamp >= to_timestamp('2022-07-22')
and timestamp < to_timestamp('2022-07-23');

請參閱檔案，深入瞭解如何 使用認證連線到外部使用者端.

如果您想要改善儀表板的回應時間，您應該實作Business Intelligence(BI)伺服器，作為Query Service和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.