Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 開啟查詢編輯器 v2
您可以透過 Amazon Redshift，於 Amazon Redshift 主控台中使用查詢編輯器 v2 對資料倉儲叢集執行 SQL 查詢。查詢編輯器 v2 是一種 Web 型工具，提供易用的介面來執行臨機查詢、探索資料，以及執行資料分析任務。下列各節將引導您完成在主控台中開啟查詢編輯器 v2 並有效利用其功能的程序。
**開啟查詢編輯器 v2**
1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)：// 開啟 Amazon Redshift 主控台。
1. 從導覽器選單中選擇**編輯器**，然後選擇**查詢編輯器 V2**。查詢編輯器 v2 便會在新的瀏覽器標籤中開啟。
查詢編輯器頁面會有一個導覽器選單可供您選擇檢視，如下所示：
**編輯器 **
您可以管理和查詢組織為資料表並包含在資料庫中的資料。資料庫可以包含儲存的資料，也可以包含儲存在其他地方 (例如 Amazon S3) 之資料的參考。您可以連線到包含在叢集或無伺服器工作群組內的資料庫。
在**編輯器**檢視中工作時，您可以使用下列控制項：
+ **叢集**或**工作群組**欄位會顯示您目前所連線項目的名稱。**資料庫**欄位會顯示叢集或工作群組內的資料庫。您在**資料庫**檢視中執行的動作預設會對您選取的資料庫採取行動。
+ 叢集或工作群組、資料庫和結構描述的樹狀檢視階層式檢視。在結構描述下，您可以處理您的資料表、檢視、函數和預存程序。樹狀檢視中的每個物件都支援可針對物件執行相關動作 (例如**重新整理**或**捨棄**) 的內容選單。
+  **建立**動作可建立資料庫、結構描述、資料表和函數。
+  **載入資料**動作可將資料從 Amazon S3 或從本機檔案載入到資料庫。
+  **儲存**圖示可儲存查詢。
+  **捷徑**圖示可顯示編輯器的鍵盤快速鍵。
+  **更多**圖示可在編輯器中顯示更多動作。例如：
+ **與我的團隊共用**可與團隊共用查詢或筆記本。如需詳細資訊，請參閱[以團隊的形式協作和共用](query-editor-v2-team.md)。
+ **捷徑**可顯示編輯器的鍵盤快速鍵。
+ **標籤歷史記錄**可在編輯器中顯示標籤的歷史記錄。
+ **重新整理自動完成**可在編寫 SQL 時重新整理所顯示的建議。
+  **編輯器**區域，可供您輸入和執行查詢。
執行查詢後會出現**結果**標籤，內有查詢結果。你可以在此開啟**圖表**以將結果視覺化。您也可以**匯出**結果。
+  **筆記本**區域，可供您新增區段以便輸入和執行 SQL 或新增 Markdown。
執行查詢後會出現**結果**標籤，內有查詢結果。您可以在此**匯出**結果。
**查詢 **
查詢包含用來管理和查詢資料庫中所含資料的 SQL 命令。當您使用查詢編輯器 v2 載入範例資料時，其也會為您建立並儲存範例查詢。
當您選擇已儲存的查詢時，您可以使用內容 (右鍵) 選單來將其開啟、重新命名和刪除。您可以選擇**查詢詳細資訊**來檢視已儲存查詢的屬性，例如**查詢 ARN**。您還可以檢視其版本歷史記錄、編輯連接至查詢的標籤，以及將其與您的團隊共用。
**筆記本 **
SQL 筆記本包含 SQL 和 Markdown 儲存格。使用筆記本可在單一文件中組織、註釋和共用多個 SQL 命令。
當您選擇已儲存的筆記本時，您可以使用內容 (右鍵) 選單來將其開啟、重新命名、複製和刪除。您可以選擇**筆記本詳細資訊**來檢視已儲存筆記本的屬性，例如**筆記本 ARN**。您還可以檢視其版本歷史記錄、編輯連接至筆記本的標籤、匯出筆記本，以及將其與您的團隊共用。如需詳細資訊，請參閱[Amazon Redshift 中的筆記本Notebooks](query-editor-v2-notebooks.md)。
**圖表 **
圖表會以視覺化方式呈現資料。查詢編輯器 v2 提供了工具供您建立多種類型的圖表並將其儲存起來。
當您選擇已儲存的圖表時，您可以使用內容 (右鍵) 選單來將其開啟、重新命名和刪除。您可以選擇**圖表詳細資訊**來檢視已儲存圖表的屬性，例如**圖表 ARN**。您也可以編輯連接至圖表的標籤，並將其匯出。如需詳細資訊，請參閱[將查詢結果視覺化](query-editor-v2-charts.md)。
**歷史記錄 **
查詢歷史記錄會列出您使用 Amazon Redshift 查詢編輯器 v2 執行的查詢。這些查詢會以個別查詢的形式執行，或是作為 SQL 筆記本的一部分來執行。如需詳細資訊，請參閱[檢視查詢和標籤歷史記錄](query-editor-v2-history.md)。
**已排程的查詢 **
已排程的查詢是設定為在特定時間啟動的查詢。
所有查詢編輯器 v2 檢視都有下列圖示：
+  **視覺化模式**圖示可在淺色模式和深色模式之間進行切換。
+  **設定**圖示可顯示不同設定畫面的選單。
+  **編輯器偏好設定**圖示可讓您在使用查詢編輯器 v2 時編輯您的偏好設定。您可以在此**編輯工作區設定**，以變更字型大小、標籤大小和其他顯示設定。您也可以開啟 (或關閉) **自動完成**，以在您輸入 SQL 時顯示建議。
+  **連線**圖示可檢視編輯器標籤所使用的連線。
連線可用來擷取資料庫中的資料。連線會針對特定資料庫來建立。使用隔離連線時，在某個編輯器標籤中會變更資料庫的 SQL 命令 (例如建立暫存資料表) 結果，並無法在另一個編輯器標籤中看到。當您在查詢編輯器 v2 中開啟編輯器標籤時，預設會使用隔離連線。當您建立共用連線時 (也就是如果您關閉**隔離工作階段**切換開關的話)，相同資料庫的共用連線彼此能看到其他共用連線的結果。但是，使用資料庫共用連線的編輯器標籤並不會平行執行。使用相同連線的查詢必須等到連線為可用狀態時才能執行。某個資料庫的連線不能與另一個資料庫共用，因此無法在不同的資料庫連線中看見 SQL 結果。
帳戶中的任何使用者可以擁有的作用中連線數目會由查詢編輯器 v2 管理員控制。
+  **帳戶設定**圖示可讓管理員變更帳戶中所有使用者的某些設定。如需詳細資訊，請參閱[帳戶設定](#query-editor-v2-settings)。
## 使用查詢編輯器 v2 時的考量
在使用查詢編輯器 v2 時，請考量下列事項：
+ 查詢的持續時間上限為 24 小時。
+ 查詢結果大小上限為 100 MB。如果呼叫傳回超過 100 MB 的回應資料，則會傳回前 100 MB 並顯示警告。
+ 您可以執行長度最多 300,000 個字元的查詢。
+ 您可以儲存長度最多 30,000 個字元的查詢。
+ 根據預設，查詢編輯器 v2 會自動遞交每個執行的個別 SQL 命令。在提供了 BEGIN 陳述式時，BEGIN-COMMIT 或 BEGIN-ROLLBACK 區塊內的陳述式會以單一交易的形式來執行。如需交易的相關資訊，請參閱《Amazon Redshift 資料庫開發人員指南》**中的 [BEGIN](https://docs.aws.amazon.com/redshift/latest/dg/r_BEGIN.html)。
+ 在執行 SQL 陳述式時，查詢編輯器 v2 可顯示的警告數量上限為 `10` 個。例如，在執行預存程序時，不會顯示超過 10 個 RAISE 陳述式。
+ 查詢編輯器 v2 不支援包含逗號 (,) 的 IAM `RoleSessionName`。您可能會看到類似以下的錯誤：Error Message : "'AROA123456789EXAMPLE:mytext,yourtext' is not a valid value for TagValue - it contains illegal characters"。當您定義包含逗號的 IAM `RoleSessionName`，然後使用查詢編輯器 v2 搭配該 IAM 角色時，就會發生此問題。
如需 IAM `RoleSessionName` 的詳細資訊，請參閱《IAM 使用者指南》**中的 [RoleSessionName SAML 屬性](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_saml_assertions.html#saml_role-session-attribute)。
## 帳戶設定
具有正確 IAM 許可的使用者可以檢視和變更相同 AWS 帳戶中其他使用者的**帳戶設定**。此管理員可以檢視或設定下列項目：
+ 帳戶中每一使用者的最大並行資料庫連線數。這包括**隔離工作階段**的連線。當您變更此值時，其可能需要 10 分鐘才會生效。
+ 允許帳戶中的使用者將 SQL 命令的整個結果集匯出至檔案。
+ 載入並顯示包含一些相關聯之已儲存查詢的範例資料庫。
+ 指定帳戶使用者用來從本機檔案載入資料的 Amazon S3 路徑。
+ 檢視用來加密查詢編輯器 v2 資源的 KMS 金鑰 ARN。