查詢編輯器UI指南

Last update: Tue May 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Queries

建立對象：

User
Developer

NOTE

舊版編輯器已於2024年5月24日淘汰。它無法再供使用。您現在可以使用增強型查詢編輯器撰寫、驗證及執行查詢

查詢編輯器是Adobe Experience Platform查詢服務所提供的互動式工具，可讓您針對 Experience Platform 使用者介面。查詢編輯器支援開發查詢以進行分析和資料探索，並可讓您執行互動式查詢以進行開發，以及非互動式查詢來填入以下位置的資料集： Experience Platform.

如需Query Service概念和功能的詳細資訊，請參閱查詢服務總覽. 若要進一步瞭解如何導覽查詢服務使用者介面，請前往 Platform，請參閱查詢服務UI總覽.

快速入門 getting-started

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

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

在 Experience Platform UI，選取查詢在左側導覽選單中開啟「查詢服務」工作區。接下來，若要開始寫入查詢，請選取 建立查詢 在熒幕的右上方。此連結可從查詢服務工作區中的任何頁面使用。

將建立查詢反白顯示的查詢工作區概觀索引標籤。

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

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

初次連線時查詢編輯器的主控台輸出。

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

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

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

NOTE

舊版編輯器已於2024年5月24日淘汰。它無法再供使用。您現在可以使用增強型查詢編輯器來撰寫、驗證和執行查詢。

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

設定 settings

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

TIP

您可以停用語法自動完成編寫查詢時不會失去進度。

若要啟用深色或淺色佈景主題，請選取設定圖示( )後按出現的下拉式選單中的選項。

查詢編輯器會醒目顯示設定圖示和啟用深色主題下拉式選單選項。

自動完成 auto-complete

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

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

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

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

NOTE

如果CTAS查詢是在查詢編輯器中的第一個查詢之後執行，則仍會建立表格，但查詢編輯器控制檯上沒有輸出。

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

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

查詢編輯器具有執行選取的查詢圖示醒目提示。

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

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

查詢編輯器取消查詢反白顯示。

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

取消查詢確認對話方塊中反白顯示「確認」。

結果計數 result-count

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

結果計數下拉式清單反白顯示的查詢編輯器。

正在寫入查詢 writing-queries

查詢編輯器已妥善整理，以便儘可能輕鬆編寫查詢。以下熒幕擷圖顯示編輯器在UI中的顯示方式，其中包含SQL輸入欄位和播放反白顯示。

SQL輸入欄位和「播放」反白顯示的查詢編輯器。

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

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

自動語法反白顯示： 讓閱讀及組織SQL更容易。

查詢編輯器中的SQL陳述式，示範語法色彩醒目提示。

SQL關鍵字自動完成： 開始輸入查詢，然後使用方向鍵導覽至所需辭彙，然後按下輸入.

SQL的幾個字元，帶有提供查詢編輯器選項的自動完成下拉式選單。

表格和欄位自動完成： 開始輸入您想要的表格名稱 SELECT 從，然後使用方向鍵導覽至您要尋找的表格，然後按下輸入. 選取表格後，自動完成會辨識該表格中的欄位。

顯示下拉式表格名稱建議的「查詢編輯器」輸入。

格式化文字 format-text

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

NOTE

此設定文字格式功能無法用於匿名區塊。若要瞭解如何循序鏈結一或多個SQL敘述句，請參閱匿名區塊檔案.

查詢編輯器設定文字格式和醒目提示的SQL敘述句。

複製 SQL copy-sql

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

「查詢」工作區有一個範例查詢範本，其復製圖示會反白顯示。

查詢詳細資料 query-details

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

NOTE

此檢視排程，新增排程和刪除查詢只有在查詢已儲存為範本後，才可使用選項。此新增排程選項會直接將您從查詢編輯器帶往排程產生器。此檢視排程選項會直接帶您前往該查詢的排程詳細目錄。請參閱查詢排程檔案，以瞭解如何在UI中建立查詢排程.

查詢編輯器會醒目提示查詢詳細資訊面板。

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

若要產生輸出資料集，請選取 以CTAS身分執行. 此 輸入輸出資料集詳細資料 對話方塊隨即顯示。輸入名稱和說明，然後選取 以CTAS身分執行. 新資料集會顯示在 資料集 瀏覽標籤。另請參閱檢視資料集檔案以進一步瞭解貴組織的可用資料集。

NOTE

此以CTAS身分執行選項僅在查詢具有非已排程。

此輸入輸出資料集詳細資料對話方塊。

在您執行 以CTAS身分執行 動作，系統會顯示一則確認訊息，通知您動作成功。此快顯訊息包含一個連結，提供導覽至查詢記錄工作區的一個便利方式。請參閱查詢記錄檔案以取得關於查詢記錄的詳細資訊。

正在儲存查詢 saving-queries

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

NOTE

使用查詢編輯器命名並儲存在中的查詢，可在查詢控制面板中作為範本使用範本標籤。請參閱範本檔案以取得詳細資訊。

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

排定的查詢 scheduled-queries

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

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

NOTE

連續十次執行失敗的已排程查詢會自動放入已隔離狀態。具有此狀態的查詢需要您的介入，才能進行任何進一步的執行。請參閱隔離的查詢檔案，以瞭解更多詳細資訊。

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

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

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

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

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

NOTE

記錄檔不會儲存未執行的查詢。查詢必須執行或儲存在「查詢編輯器」中，查詢才能在「查詢服務」中使用。

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

若要在「查詢編輯器」中執行查詢，您可以在編輯器中輸入SQL，或從記錄或範本標籤，然後選取播放. 查詢執行的狀態會顯示在 主控台 標籤，而輸出資料會顯示在結果標籤。

主控台 console

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

查詢編輯器主控台的主控台索引標籤。

NOTE

主控台只會顯示因執行查詢而產生的錯誤。它不會顯示查詢執行前發生的查詢驗證錯誤。

查詢結果 query-results

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

查詢編輯器控制檯的「結果」索引標籤會顯示查詢執行的結果。