本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Aurora DSQL 查詢編輯器入門
<a name="getting-started-query-editor"></a>

使用 Aurora DSQL 查詢編輯器，您可以安全地連線至 Aurora DSQL 叢集，並直接從 AWS 管理主控台執行 SQL 查詢，而無需安裝或設定外部用戶端。它提供直覺式工作區，其中包含內建語法反白、自動完成和智慧型程式碼協助。您可以在單一界面中快速探索結構描述物件、開發和執行 SQL 查詢，以及檢視結果。

本主題會逐步引導您連線至叢集、執行查詢、檢視結果，以及探索執行計畫等進階功能。

**注意**  
查詢編輯器可在支援 Aurora DSQL 的所有區域中使用。如需區域可用性的詳細資訊，請參閱[AWS 區域服務](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)。

## 先決條件
<a name="query-editor-prerequisites"></a>

開始之前，請確定符合下列要求：
+ 您至少有一個可用的 Aurora DSQL 叢集。如需建立叢集的詳細資訊，請參閱 [步驟 1：建立 Aurora DSQL 單一區域叢集](getting-started.md#getting-started-create-cluster)。
+ 您的叢集端點可公開存取。查詢編輯器不支援由資源型政策封鎖公開存取的叢集，或透過 VPC 端點管理的叢集。如需存取限制的詳細資訊，請參閱 [使用 Aurora DSQL 中的資源型政策封鎖公開存取](rbp-block-public-access.md)和 [使用 管理和連線至 Amazon Aurora DSQL 叢集 AWS PrivateLink](privatelink-managing-clusters.md)。
+ 您的 IAM 使用者或角色具有存取和連線至叢集所需的許可。如需許可的詳細資訊，請參閱 [使用資料庫角色和 IAM 身分驗證](using-database-and-iam-roles.md)。

## 使用查詢編輯器
<a name="query-editor-working"></a>

### 開啟查詢編輯器
<a name="query-editor-open"></a>

**開啟查詢編輯器**

1. 開啟 [Aurora DSQL 主控台](https://console.aws.amazon.com/dsql)。

1. 在導覽窗格中，選擇 **Query Editor (查詢編輯器)**。

或者，從**叢集**頁面，選取要查詢的叢集，然後選擇**與查詢編輯器連線**以直接啟動編輯器。

**注意**  
工作和連線狀態不會儲存。如果您離開 Aurora DSQL 主控台、關閉瀏覽器索引標籤或登出，您的連線、查詢文字和結果都會遺失。

### 連接至叢集
<a name="query-editor-connect"></a>

**連線至叢集**

1. 如果沒有叢集連線，編輯器會顯示**未連線任何叢集**。在 **Cluster Explorer** 窗格中選擇**連線**或選取 **\$1** （新增） 以連線至現有的叢集。

1. （選用） 使用不同的角色連線到多個叢集或相同的叢集。

### 探索叢集物件
<a name="query-editor-explore"></a>

Cluster Explorer 會顯示所有可用的叢集連線，並可讓您瀏覽資料庫、結構描述、資料表和檢視等物件。它還提供常見的動作，例如**重新整理**、**建立資料表**和其他內容特定選項。

### 執行查詢
<a name="query-editor-run-queries"></a>

**若要執行查詢**

1. 在查詢編輯器索引標籤窗格中，輸入您的 SQL 陳述式。例如：

   ```
   SELECT * FROM public.orders LIMIT 10;
   ```

1. 驗證顯示在查詢索引標籤右上角的**作用中叢集內容**。這表示與目前查詢索引標籤相關聯的叢集連線。

1. （選用） 使用**連線**下拉式清單來檢閱所有可用的連線，或切換到不同的叢集。變更執行該標籤中查詢的連線更新。

1. 選擇**執行**以執行查詢。

**注意**  
每個查詢最多可傳回結果窗格中的 10，000 個資料列。對於較大的資料集，請使用篩選條件或限制來精簡查詢。

### 檢閱結果和執行計畫
<a name="query-editor-view-results"></a>

查詢執行後，請在編輯器底部的**結果面板**中檢閱輸出。根據預設，每個查詢執行會顯示**結果 （資料表）** 索引標籤，顯示表格式查詢輸出。

若要取得查詢執行計畫，請執行 `EXPLAIN ANALYZE`或 `EXPLAIN ANALYZE VERBOSE` 以取得查詢效能的其他洞見。如需執行計劃的詳細資訊，請參閱 [讀取 Aurora DSQL EXPLAIN 計劃](reading-dsql-explain-plans.md)。

**提示**  
`EXPLAIN ANALYZE VERBOSE` 命令顯示 DPU 用量預估，包括運算、讀取、寫入和總 DPU 值，可讓您立即查看個別 SQL 陳述式耗用的資源。