查詢編輯器UI指南

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

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

快速入門 getting-started

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

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

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

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

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

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

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

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

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

資料庫選擇器 database-selector

從「查詢編輯器」右上角的下拉式選單中選取要查詢的資料庫。 選取的資料庫會顯示在下拉式清單中。

設定 settings

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

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

自動完成 auto-complete

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

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

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

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

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

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

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

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

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

結果計數 result-count

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

正在寫入查詢 writing-queries

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

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

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

使用查詢編輯器的撰寫工具來增強您的查詢撰寫程式。 功能包括格式化文字、複製SQL、管理查詢詳細資訊，以及儲存或排程您進行的工作的選項。

設定文字格式 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改善這些查詢作業的可見度。 如需詳細資訊，請參閱查詢監視檔案。

物件瀏覽器 object-browser

使用物件瀏覽器輕鬆搜尋和篩選資料集。 物件瀏覽器可縮短在有大量資料集的大型環境中搜尋表格和資料集所花費的時間。 透過簡化相關資料和中繼資料的存取，您可以將更多精力放在查詢撰寫上，而較少精力放在導覽上。

若要使用物件瀏覽器瀏覽您的資料庫，請在搜尋欄位中輸入表格名稱，或選取​ 表格 ​以展開可用資料集和表格的清單。 使用搜尋欄位時，會根據您的輸入動態篩選可用表格清單。

您選取的資料庫中包含的每個資料集都會列在查詢編輯器左側的導覽邊欄中。

物件瀏覽器中顯示的綱要是可觀察的綱要。 這表示您可以在變更立即可見時，使用它來即時監視變更和更新。 可觀察的結構描述有助於確保資料同步化，並有助於偵錯或分析工作。

目前限制 current-limitation

系統會循序處理查詢，這表示一次只能執行一個查詢。 查詢進行時，無法在左側導覽中存取其他表格。

存取表格中繼資料 table-metadata

除了快速搜尋外，您現在可以選取表格名稱旁的「i」圖示，輕鬆存取任何表格的中繼資料。 這可提供所選表格的詳細資訊，可幫助您在撰寫查詢時做出明智的決策。

探索子資料表

若要瀏覽子表格或連結表格，請選取清單中表格名稱旁的下拉箭頭。 這會展開表格以顯示任何相關聯的子表格，並提供資料結構的清楚檢視，並允許更複雜的查詢建構。 欄位名稱旁邊的圖示表示欄的資料型別，可幫助您在複雜查詢期間識別它。

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

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

主控台 console

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

查詢結果 query-results

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

下載查詢結果 download-query-results

執行成功的查詢後，請下載CSV、XLSX或JSON格式的結果，以用於離線分析、報表或試算表工作流程。 此功能透過啟用對離線分析、報告和Excel型程式的查詢結果的立即存取權，簡化了行銷和分析團隊的工作流程。

若要下載您的查詢結果，請選取[查詢編輯器] [結果] ​索引標籤右上角的​ [下載]。 然後從下拉式功能表中選擇​ CSV、XLSX ​或​ JSON。 檔案會自動下載到您的本機電腦。 選擇適合您使用案例的格式、CSV用於輕量型匯出、XLSX用於格式化試算表，或JSON用於結構化資料處理。

以全熒幕檢視結果 view-results

執行成功的查詢後，在​ 結果 ​索引標籤中選取​ 檢視結果 ​以開啟您結果的清單化全熒幕檢視。

使用全熒幕預覽可輕鬆掃描寬表格，並檢查列層級的詳細資料，而不需水準捲動。 全熒幕檢視會以可調整大小的網格顯示輸出，讓您更輕鬆地檢視大型資料集及跨欄掃描。

複製結果 copy-results

使用查詢編輯器中的增強型複製功能，將查詢結果復製為逗號分隔值(CSV)，並將其貼到試算表工具（如Excel）中，以立即驗證或報告。 此功能可改善可讀性、保留格式並簡化工作流程，而不需依賴協力廠商工具。

您可以從結果標籤或全熒幕結果預覽中複製查詢結果。 從​ 結果 ​索引標籤中，選取復製圖示( )以複製所有查詢結果到剪貼簿。 若要啟用復製圖示，請先選取一列。 您可以選取個別列，或使用頂端的核取方塊來一次選取所有列。

或者，選取​ 檢視結果 ​以開啟全熒幕預覽。 在此對話方塊中，選取個別列，或使用左上角的核取方塊來選取所有列，然後選取復製圖示（ )以複製選取的資料。

舊版結果表格（可用性限制） legacy-results-table

舊版查詢編輯器適用於依賴彈性手動資料工作流程（例如QA或試算表式稽核）的使用者。

它支援以瀏覽器為基礎的原生拖曳選取範圍，因此您可以使用標準的選取行為，反白及複製輸出的任何部分（包括個別儲存格或區塊）。 這與使用結構化列選取和專用複製動作的增強型表格形成對比。

複製的資料以定位點分隔，因此當您貼到Excel等工具時，欄會保持對齊和可讀取。 在標題列上拖曳選取時，也會包含欄標題。

範例 examples

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

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

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

後續步驟

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