在Query Service中執行查詢的一般指引
本檔案詳細說明在Adobe Experience Platform Query Service中撰寫查詢時需要瞭解的重要詳細資訊。
如需Query Service中所使用SQL語法的詳細資訊，請閱讀SQL語法檔案。
查詢執行模型
Adobe Experience Platform Query Service有兩個查詢執行模型：互動式和非互動式。 互動式執行用於商務智慧工具中的查詢開發和報表產生，而非互動式則用於大型作業和作業查詢，作為資料處理工作流程的一部分。
互動式查詢執行
透過Query Service UI或透過連線的使用者端提交查詢，便能以互動方式執行查詢。 透過連線的使用者端執行Query Service時，在使用者端與Query Service之間執行使用中的工作階段，直到提交的查詢傳回或逾時。
互動式查詢執行有下列限制：
LIMIT 0。 10分鐘的查詢逾時仍然適用。依預設，互動式查詢的結果會傳回使用者端，且 不會 持續存在。 為了將結果作為資料集保留在Experience Platform中，查詢必須使用CREATE TABLE AS SELECT語法。
非互動式查詢執行
透過Query Service API提交的查詢是以非互動方式執行。 非互動式執行表示Query Service會接收API呼叫，並以接收順序執行查詢。 非互動式查詢一律會在Experience Platform中產生新資料集以接收結果，或將新列插入現有資料集中。
存取物件中的特定欄位
若要存取查詢中物件內的欄位，您可以使用點標籤法(.)或方括弧標籤法([])。 下列SQL陳述式使用點標籤法，將endUserIds物件向下周遊至mcid物件。
SELECT endUserIds._experience.mcid
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1
{ANALYTICS_TABLE_NAME}下列SQL陳述式使用方括弧標籤法將endUserIds物件向下周遊至mcid物件。
SELECT endUserIds['_experience']['mcid']
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1
{ANALYTICS_TABLE_NAME}上述兩個範例查詢都傳回平面化的物件，而不是單一值：
endUserIds._experience.mcid
--------------------------------------------------------
(48168239533518554367684086979667672499,"(ECID)",true)
(1 row)
傳回的endUserIds._experience.mcid物件包含下列引數的對應值：
idnamespaceprimary
當欄只宣告為向下至物件時，會將整個物件以字串形式傳回。 若只要檢視ID，請使用：
SELECT endUserIds._experience.mcid.id
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1
endUserIds._experience.mcid.id
----------------------------------------
48168239533518554367684086979667672499
(1 row)
引號
單引號、雙引號與後引號在「查詢服務」查詢中的使用方式不同。
單引號
單引號(')可用來建立文字字串。 例如，它可以在SELECT陳述式中用來傳回結果中的靜態文字值，以及在WHERE子句中用來評估資料行的內容。
下列查詢為資料行宣告靜態文字值('datasetA')：
SELECT
'datasetA',
timestamp,
web.webPageDetails.name
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10
下列查詢在其WHERE子句中使用單引號字串('homepage')來傳回特定頁面的事件。
SELECT
timestamp,
endUserIds._experience.mcid.id
FROM {ANALYTICS_TABLE_NAME}
WHERE web.webPageDetails.name = 'homepage'
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10
雙引號
雙引號(")用來宣告含有空格的識別碼。
當一欄的識別碼中包含空格時，下列查詢會使用雙引號來傳回指定欄的值：
SELECT
no_space_column,
"space column"
FROM
( SELECT
'column1' as no_space_column,
'column2' as "space column"
)
後引號
使用點標籤法時，反引號`僅用來逸出保留的欄名稱 。 例如，由於order是SQL中的保留字，因此您必須使用反引號來存取欄位commerce.order：
SELECT
commerce.`order`
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10
後引號也可用來存取以數字開頭的欄位。 例如，若要存取欄位30_day_value，您必須使用舊引號標籤法。
SELECT
commerce.`30_day_value`
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10
如果您使用方括弧標籤法，則 不需要 後引號。
SELECT
commerce['order']
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10
檢視表格資訊
連線到查詢服務後，您可以使用\d或SHOW TABLES命令，在Platform上檢視所有可用的表格。
標準表格檢視
\d命令顯示用於列出資料表的標準PostgreSQL檢視。 此命令的輸出範例如下所示：
List of relations
Schema | Name | Type | Owner
--------+-----------------+-------+----------
public | luma_midvalues | table | postgres
public | luma_postvalues | table | postgres
(2 rows)
詳細表格檢視
SHOW TABLES命令是自訂命令，可提供表格的詳細資訊。 此命令的輸出範例如下所示：
name | dataSetId | dataSet | description | resolved
-----------------+--------------------------+----------------+-------------+----------
luma_midvalues | 5bac030c29bb8d12fa992e58 | Luma midValues | | false
luma_postvalues | 5c86b896b3c162151785b43c | Luma midValues | | false
(2 rows)
結構描述資訊
若要檢視資料表中結構描述的詳細資訊，您可以使用\d {TABLE_NAME}命令，其中{TABLE_NAME}是您要檢視其結構描述資訊之資料表的名稱。
下列範例顯示luma_midvalues資料表的結構描述資訊，使用\d luma_midvalues即可看到該資訊：
Table "public.luma_midvalues"
Column | Type | Collation | Nullable | Default
-------------------+-----------------------------+-----------+----------+---------
timestamp | timestamp | | |
_id | text | | |
productlistitems | anyarray | | |
commerce | luma_midvalues_commerce | | |
receivedtimestamp | timestamp | | |
enduserids | luma_midvalues_enduserids | | |
datasource | datasource | | |
web | luma_midvalues_web | | |
placecontext | luma_midvalues_placecontext | | |
identitymap | anymap | | |
marketing | marketing | | |
environment | luma_midvalues_environment | | |
_experience | luma_midvalues__experience | | |
device | device | | |
search | search | | |
此外，您可以將欄的名稱附加至表格名稱，以取得特定欄的詳細資訊。 這會以\d {TABLE_NAME}_{COLUMN}格式撰寫。
下列範例顯示web資料行的其他資訊，將會使用下列命令叫用： \d luma_midvalues_web：
Composite type "public.luma_midvalues_web"
Column | Type | Collation | Nullable | Default
----------------+-----------------------------------+-----------+----------+---------
webpagedetails | luma_midvalues_web_webpagedetails | | |
webreferrer | web_webreferrer | | |
聯結資料集
您可以將多個資料集聯結在一起，將其他資料集的資料納入查詢。
下列範例會加入下列兩個資料集（your_analytics_table和custom_operating_system_lookup），並依據頁面檢視次數為前50個作業系統建立SELECT陳述式。
查詢
SELECT
b.operatingsystem AS OperatingSystem,
SUM(a.web.webPageDetails.pageviews.value) AS PageViews
FROM your_analytics_table a
JOIN custom_operating_system_lookup b
ON a._experience.analytics.environment.operatingsystemID = b.operatingsystemid
WHERE TIMESTAMP >= TO_TIMESTAMP('2018-01-01') AND TIMESTAMP <= TO_TIMESTAMP('2018-12-31')
GROUP BY OperatingSystem
ORDER BY PageViews DESC
LIMIT 50;
結果
去重複化
查詢服務支援重複資料刪除，或從資料中刪除重複列。 如需重複資料刪除的詳細資訊，請參閱查詢服務重複資料刪除指南。
查詢服務中的時區計算
查詢服務會使用UTC時間戳記格式，標準化Adobe Experience Platform中的持續資料。 如需有關如何將您的時區要求轉換為UTC時間戳記及從UTC時間戳記轉譯的詳細資訊，請參閱常見問題集一節，瞭解如何將時區更改為UTC時間戳記及從UTC時間戳記變更時區。
後續步驟
閱讀本檔案後，您已經瞭解使用Query Service撰寫查詢時的一些重要考量。 如需有關如何使用SQL語法撰寫您自己的查詢的詳細資訊，請參閱SQL語法檔案。
如需可在查詢服務中使用的更多查詢範例，請參閱以下使用案例檔案：