Show Menu
主題×

查詢編輯器使用手冊

Query Editor是Adobe Experience Platform Query Service提供的互動式工具,可讓您在Experience Platform使用者介面中編寫、驗證及執行客戶體驗資料查詢。 Query Editor支援開發分析和資料探索的查詢,並可讓您執行互動式查詢以用於開發,以及非互動式查詢以填入Experience Platform中的資料集。
有關查詢服務的概念和功能的詳細資訊,請參閱查 詢服務概述 。 若要進一步瞭解如何導覽平台上的Query Service使用者介面,請參閱 Query Service UI總覽

快速入門

查詢編輯器通過連接到查詢服務提供靈活的查詢執行,並且查詢僅在此連接處於活動狀態時運行。

連接到查詢服務

查詢編輯器在開啟查詢服務時需要幾秒鐘的時間來初始化並連接到查詢服務。 Console會告訴您連線的時間,如下所示。 如果嘗試在編輯器連接之前運行查詢,則會延遲執行,直到連接完成。

如何從查詢編輯器運行查詢

從查詢編輯器執行的查詢以交互方式運行。 這表示如果您關閉瀏覽器或離開瀏覽器,查詢會被取消。 對於通過查詢輸出生成資料集而進行的查詢,也是如此。

使用查詢編輯器進行查詢編輯

使用查詢編輯器,您可以編寫、執行和保存客戶體驗資料的查詢。 在查詢編輯器中執行或保存的所有查詢都可用於組織中具有查詢服務訪問權限的所有用戶。

訪問查詢編輯器

在Experience Platform UI中,按一下左側導 覽功能表中 「查詢」,以開啟「查詢服務」工作區。 接著,按一 下畫面右上角的 「建立查詢」,開始編寫查詢。 此連結可從「查詢服務」工作區中的任何頁面使用。

編寫查詢

查詢編輯器的組織方式使編寫查詢盡可能簡單。 下面的螢幕擷取顯示編輯器如何顯示在UI中,並反白顯 「播放」按鈕和SQL項目欄位。
為了將開發時間減至最少,建議您開發查詢時對傳回的列有限制。 例如 SELECT fields FROM table WHERE conditions LIMIT number_of_rows 。在驗證查詢是否生成了預期的輸出後,請刪除限制並運行查詢,以 CREATE TABLE tablename AS SELECT 便生成包含輸出的資料集。

在查詢編輯器中編寫工具

  • 自動語法反白顯示: 使讀取和組織SQL變得更輕鬆。
  • SQL關鍵字自動完成: 開始鍵入查詢,然後使用箭頭鍵導航到所需的詞語,然後按 Enter
  • 表格和欄位自動完成: 開始鍵入要從的表名,然 SELECT 後使用箭頭鍵導航到要查找的表,然後按 Enter 。 選取表格後,自動完成會識別該表格中的欄位。

錯誤檢測

查詢編輯器會在您編寫查詢時自動驗證查詢,提供一般SQL驗證和特定執行驗證。 如果查詢下方出現紅色下划線(如下圖所示),則表示查詢內有錯誤。
檢測到錯誤時,可以通過將滑鼠懸停在SQL代碼上來查看特定錯誤消息。

查詢詳細資訊

在查詢編輯器中查看查詢時,「查詢詳細 資訊 」面板提供了管理選定查詢的工具。
此面板允許您直接從UI生成輸出資料集、刪除或命名顯示的查詢,並以易於複製的格式在 SQL查詢頁籤上查看SQL代碼。 此面板還顯示有用的中繼資料,例如上次修改查詢的時間以及修改者(如果適用)。 若要產生資料集,請按一下「 ​輸出資料集」 。 將出 現「輸出資料集 」對話框。 輸入名稱和說明,然後按一下「執 ​行查詢」**。 新資料集會顯示在「平台」上 「查詢服務 」使用者介面的「資料集」標籤中。

保存查詢

查詢編輯器提供了一個保存函式,允許您保存查詢並稍後處理。 要保存查詢,請單 「查詢編輯器」右上角的「保存」。 在可以保存查詢之前,必須使用「查詢詳細資訊」面板為查詢提 供名稱

如何尋找先前的查詢

從「查詢編輯器」(Query Editor)中執行的所有查詢都將捕獲到「日誌」(Log)表中。 您可以使用「記錄」標籤中的搜 尋功能 ,來尋找查詢執行。 保存的查詢列在「瀏 」頁籤中。
如需詳細 資訊,請參閱查詢服務 UI總覽。
日誌不保存未執行的查詢。 要使查詢在查詢服務中可用,它必須在查詢編輯器中運行或保存。

使用查詢編輯器執行查詢

要在查詢編輯器中運行查詢,可以在編輯器中輸入SQL,或從「日誌」或「瀏覽」頁籤中載入以 前的​ 查詢,然後按一下 播放 。 查詢執行狀態顯示在下面的「控 制台 」頁籤中,輸出資料顯示在「結果 」頁籤中。

控制台

控制台提供查詢服務的狀態和操作資訊。 控制台顯示與查詢服務的連接狀態、正在執行的查詢操作以及這些查詢產生的任何錯誤消息。
控制台僅顯示因執行查詢而導致的錯誤。 在執行查詢之前,不會顯示查詢驗證錯誤。

查詢結果

查詢完成後,結果將顯示在「控制台」( Console )頁籤旁的「結 果」(Results )頁籤中。 此視圖顯示查詢的表格式輸出,最多顯示100行。 此視圖允許您驗證查詢是否生成了預期輸出。 若要使用查詢產生資料集,請移除傳回的列限制,並執行查詢,以 CREATE TABLE tablename AS SELECT 便使用輸出產生資料集。 有關如何 在查詢編輯器中從查詢結果生成資料集的說明 ,請參見生成資料集教程。

後續步驟

現在您知道查詢編輯器中有哪些功能以及如何導覽應用程式,可以直接在平台中開始編寫您自己的查詢。 有關在Data Lake中對資料集運行SQL查詢的詳細資訊,請參閱運行查詢 的指南 。 如需使用Adobe Analytics和Adobe Target資料的範例SQL查詢,請參閱范 例查詢參考