查詢編輯器UI指南

查詢編輯器是Adobe Experience Platform查詢服務提供的互動式工具，可讓您在Experience Platform使用者介面中撰寫、驗證及執行客戶體驗資料的查詢。 查詢編輯器支援開發查詢以進行分析和資料探索，並可讓您執行互動式查詢以進行開發，以及非互動式查詢來填入Experience Platform中的資料集。

如需有關查詢服務概念和功能的詳細資訊，請參閱查詢服務總覽。 若要進一步瞭解如何在Platform上瀏覽查詢服務使用者介面，請參閱查詢服務UI總覽。

快速入門 getting-started

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

存取查詢編輯器 accessing-query-editor

在Experience Platform UI中，選取左側導覽功能表中的​ 查詢 ​以開啟查詢服務工作區。 接下來，若要開始撰寫查詢，請選取畫面右上方的​ 建立查詢。 此連結可從查詢服務工作區中的任何頁面使用。

正在連線到查詢服務 connecting-to-query-service

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

如何從查詢編輯器執行查詢 run-a-query

從「查詢編輯器」執行的查詢會以互動方式執行，這表示如果您關閉瀏覽器或離開瀏覽器，則會取消查詢。 從查詢輸出產生資料集的查詢也是如此。

使用增強型查詢編輯器編寫查詢 query-authoring

使用查詢編輯器，您可以編寫、執行和儲存客戶體驗資料的查詢。 在查詢編輯器中執行或儲存的所有查詢，都可供貴組織中有權存取查詢服務的所有使用者使用。

設定 settings

查詢編輯器輸入欄位上方的設定圖示包括啟用/停用深色主題或停用/啟用自動完成的選項。

若要啟用深色或淺色主題，請選取設定圖示( )，接著出現的下拉式功能表中的選項。

自動完成 auto-complete

查詢編輯器會在您編寫查詢時，自動建議可能的SQL關鍵字以及表格或欄詳細資訊。 自動完成功能預設為啟用，並可隨時從查詢編輯器設定中停用或啟用。

自動完成組態設定是每個使用者設定的，並記得該使用者連續登入的時間。 停用此功能會停止處理數個中繼資料命令，並提供通常有利於作者編輯查詢之速度的建議。

執行多個循序查詢 execute-multiple-sequential-queries

使用增強型查詢編輯器來寫入多個查詢並按順序執行所有查詢。 依序執行多個查詢時，每個查詢都會產生記錄專案。 但是，只有第一個查詢的結果會顯示在查詢編輯器主控台中。 如果您需要疑難排解或確認已執行的查詢，請檢查查詢記錄。 如需詳細資訊，請參閱查詢記錄檔案。

執行選取的查詢 execute-selected-query

如果您已撰寫多個查詢，但只需要執行一個查詢，您可以反白標示所選的查詢並選取
執行選取的查詢圖示。 在編輯器中選取查詢語法之前，此圖示預設為停用。

取消查詢編輯器工作階段 cancel-query

取消長時間執行的查詢，以控制查詢執行並提高生產力。 此動作會在查詢執行期間清除查詢編輯器。 請注意，查詢會在背景中繼續執行。 如果是CTAS查詢，仍會產生輸出資料集。 若要取消編輯器中的執行並繼續構成SQL陳述式，請在執行查詢後選取​ 取消查詢。

確認對話方塊隨即顯示。 選取​ 確認 ​以取消查詢執行。

結果計數 result-count

「查詢編輯器」有最多50,000列的輸出。 您可以選擇在查詢編輯器主控台中一次顯示的列數。 若要變更主控台中顯示的列數，請選取​ 結果計數 ​下拉式清單，並從50、100、150、300和500選項中選取。

正在寫入查詢 writing-queries

查詢編輯器已組織為儘可能輕鬆撰寫查詢。 下面的熒幕擷圖顯示編輯器在UI中的顯示方式，SQL輸入欄位和​ Play ​會強調顯示。

為了將開發時間減至最少，建議您使用傳回列數的限制來開發查詢。 例如 SELECT fields FROM table WHERE conditions LIMIT number_of_rows。在您確認查詢產生預期的輸出後，請移除限制並以CREATE TABLE tablename AS SELECT執行查詢，以產生具有輸出的資料集。

在查詢編輯器中寫入工具 writing-tools

設定文字格式 format-text

格式文字功能可新增標準化的語法樣式，讓您的查詢更易讀取。 選取​ 格式化文字 ​以標準化查詢編輯器中的所有文字。

複製 SQL copy-sql

選取復製圖示，將SQL從查詢編輯器複製到剪貼簿。 此複製功能可用於查詢範本和查詢編輯器中新建立的查詢。

查詢詳細資料 query-details

若要在查詢編輯器中檢視查詢，請從範本索引標籤中選取任何已儲存的範本。 查詢詳細資訊面板提供管理所選查詢的更多資訊和工具。 此外，也會顯示有用的中繼資料，例如上次修改查詢的時間以及修改者（如適用）。

從詳細資訊面板，您可以直接從UI產生輸出資料集、刪除或命名顯示的查詢、檢視查詢執行排程，以及將查詢新增到排程。

若要產生輸出資料集，請選取​ 以CTAS ​執行。 輸入輸出資料集詳細資料 ​對話方塊就會顯示。 輸入名稱和說明，然後選取​ 以CTAS執行。 新資料集會顯示在​ 資料集 ​瀏覽標籤中。 請參閱檢視資料集檔案，深入瞭解貴組織的可用資料集。

在您執行​ 以CTAS ​身分執行動作後，會彈出一則確認訊息，通知您動作成功。 此快顯訊息包含一個連結，提供導覽至查詢記錄工作區的一個便利方式。 如需查詢記錄檔的詳細資訊，請參閱查詢記錄檔。

正在儲存查詢 saving-queries

「查詢編輯器」提供儲存功能，可讓您儲存查詢並稍後處理。 若要儲存查詢，請選取查詢編輯器右上角的​ 儲存。 必須使用​ 查詢詳細資料 ​面板提供查詢的名稱，才能儲存查詢。

當您在「查詢編輯器」中儲存查詢時，會彈出一則確認訊息，通知您操作成功。 此快顯訊息包含連結，提供導覽至查詢排程工作區的便利方式。 請參閱排程查詢檔案以瞭解如何以自訂步調執行查詢。

排定的查詢 scheduled-queries

已儲存為範本的查詢可以從「查詢編輯器」進行排程。 排程查詢可讓您以自訂步調自動執行查詢。 您可以根據頻率、日期和時間排程查詢，並視需要為您的結果選擇輸出資料集。 您也可以透過UI停用或刪除查詢排程。

排程是在查詢編輯器中設定。 使用查詢編輯器時，您只能將排程新增至已建立並儲存的查詢。 相同的限制不適用於查詢服務API。

請參閱查詢排程檔案，瞭解如何在UI🔗中建立查詢排程。 或者，若要瞭解如何使用API新增排程，請閱讀排程查詢端點指南。

任何排定的查詢都會新增到排定的查詢索引標籤的清單中。 您可以從該工作區透過UI監視所有已排程查詢工作的狀態。 在已排程的查詢索引標籤上，您可以找到有關查詢執行的重要資訊並訂閱警示。 可用的資訊包括狀態、排程詳細資料，以及執行失敗時的錯誤訊息/代碼。 如需詳細資訊，請參閱監視排程查詢檔案。

如何尋找先前的查詢 previous-queries

從「查詢編輯器」執行的所有查詢都會在「記錄」表格中擷取。 您可以使用​ Log ​標籤中的搜尋功能來尋找查詢執行。 已儲存的查詢列在​ 範本 ​索引標籤中。

如果已排程查詢，則已排程查詢索引標籤會透過UI改善這些查詢作業的可見度。 如需詳細資訊，請參閱查詢監視檔案。

使用查詢編輯器執行查詢 executing-queries

若要在查詢編輯器中執行查詢，您可以在編輯器中輸入SQL，或從​ Log ​或​ Templates ​索引標籤載入先前的查詢，然後選取​ 播放。 查詢執行的狀態會顯示在下面的​ 主控台 ​索引標籤中，而輸出資料會顯示在​ 結果 ​索引標籤中。

主控台 console

主控台提供查詢服務的狀態和操作資訊。 主控台會顯示查詢服務的連線狀態、正在執行的查詢作業，以及這些查詢所產生的任何錯誤訊息。

查詢結果 query-results

完成查詢後，結果會顯示在​ 主控台 ​標籤旁的​ 結果 ​標籤中。 此檢視顯示您查詢的表格輸出，根據您選擇的結果計數顯示50到500列結果。 此檢視可讓您驗證您的查詢是否產生預期的輸出。 若要使用您的查詢產生資料集，請移除傳回資料列的限制，然後使用CREATE TABLE tablename AS SELECT執行查詢，以使用輸出產生資料集。 請參閱產生資料集教學課程，瞭解如何從查詢編輯器中的查詢結果產生資料集的指示。

使用案例 use-cases

Query Service為跨產業和業務案例的各種使用案例提供解決方案。 這些實用的範例說明此服務在滿足各種需求時的彈性與影響。 若要瞭解Query Service如何為您的特定業務需求帶來價值，請探索使用案例檔案的完整集合。 瞭解如何使用查詢服務來提供見解和解決方案，以增強營運效率和業務成功。

使用查詢服務教學課程影片執行查詢 query-tutorial-video

以下影片說明如何在Adobe Experience Platform介面和PSQL使用者端中執行查詢。 此影片也會示範如何在XDM物件中使用個別屬性、Adobe定義的函式，以及如何使用CREATE TABLE AS SELECT (CTAS)查詢。

後續步驟

現在您已經知道查詢編輯器中有哪些功能可用，以及如何導覽應用程式，您可以開始直接在Platform中編寫您自己的查詢。 如需對Data Lake中的資料集執行SQL查詢的詳細資訊，請參閱執行查詢的指南。