本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Aurora 查詢編輯器
Aurora 查詢編輯器可讓您透過 AWS 管理主控台 在 Aurora 資料庫叢集上執行 SQL 陳述式。您可以執行 SQL 查詢、資料處理 (DML) 陳述式和資料定義 (DDL) 陳述式。使用主控台介面可讓您執行資料庫維護、產生報告，以及執行 SQL 實驗。您可以避免設定網路組態，從 EC2 執行個體或筆記型電腦等個別用戶端系統連線至資料庫叢集。
查詢編輯器需要有已啟用 RDS 資料 API (資料 API) 的 Aurora 資料庫叢集。如需支援資料 API 的資料庫叢集及其啟用方式的詳細資訊，請參閱 [使用 Amazon RDS 資料 API](data-api.md)。您可以執行的 SQL 受限於資料 API 限制。如需詳細資訊，請參閱[Amazon RDS 資料 API 的限制](data-api.limitations.md)。
## 查詢編輯器的可用性
查詢編輯器適用於使用支援資料 API 的 Aurora MySQL 和 Aurora PostgreSQL 引擎版本的 Aurora 資料庫叢集，以及可使用資料 API AWS 區域的 。如需詳細資訊，請參閱[RDS 資料 API 的支援區域和 Aurora 資料庫引擎](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md)。
## 授權存取查詢編輯器
使用者必須經過授權，才能在查詢編輯器中執行查詢。您可以將預先定義的 AWS Identity and Access Management(IAM) `AmazonRDSDataFullAccess`政策政策新增至該使用者，以授權使用者在查詢編輯器中執行查詢。
**注意**
當您建立 IAM 使用者時，請務必使用與您為資料庫使用者使用相同的使用者名稱與密碼，例如管理使用者名稱和密碼。如需詳細資訊，請參閱《*AWS Identity and Access Management 使用者指南*》中的[在您的 AWS 帳戶 中建立 IAM 使用者](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html)。
您也可以建立 IAM 政策來授予存取查詢編輯器。建立政策後，將它新增給每一位需要存取查詢編輯器的使用者。
下列政策提供使用者存取查詢編輯器所需的最低許可。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryEditor0",
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue",
"secretsmanager:PutResourcePolicy",
"secretsmanager:PutSecretValue",
"secretsmanager:DeleteSecret",
"secretsmanager:DescribeSecret",
"secretsmanager:TagResource"
],
"Resource": "arn:aws:secretsmanager:*:*:secret:rds-db-credentials/*"
},
{
"Sid": "QueryEditor1",
"Effect": "Allow",
"Action": [
"secretsmanager:GetRandomPassword",
"tag:GetResources",
"secretsmanager:CreateSecret",
"secretsmanager:ListSecrets",
"dbqms:CreateFavoriteQuery",
"dbqms:DescribeFavoriteQueries",
"dbqms:UpdateFavoriteQuery",
"dbqms:DeleteFavoriteQueries",
"dbqms:GetQueryString",
"dbqms:CreateQueryHistory",
"dbqms:UpdateQueryHistory",
"dbqms:DeleteQueryHistory",
"dbqms:DescribeQueryHistory",
"rds-data:BatchExecuteStatement",
"rds-data:BeginTransaction",
"rds-data:CommitTransaction",
"rds-data:ExecuteStatement",
"rds-data:RollbackTransaction"
],
"Resource": "*"
}
]
}
```
------
如需有關建立 IAM 政策的詳細資訊，請參閱 *AWS Identity and Access Management 使用者指南*中的[建立 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。
如需有關將 IAM 政策新增給使用者的資訊，請參閱 *AWS Identity and Access Management 使用者指南*中的[新增和移除 IAM 身分許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。
## 在查詢編輯器中執行查詢
您可以在查詢編輯器中對 Aurora 資料庫叢集執行 SQL 陳述式。您可以執行的 SQL 受限於資料 API 限制。如需詳細資訊，請參閱[Amazon RDS 資料 API 的限制](data-api.limitations.md)。
**在查詢編輯器中執行查詢**
1. 登入 AWS 管理主控台並開啟位於 https：//[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。
1. 在 的右上角AWS 管理主控台，選擇您在AWS 區域其中建立您要查詢之 Aurora 資料庫叢集的 。
1. 在導覽窗格中，選擇 **Databases** (資料庫)。
1. 選擇您想對其執行 SQL 查詢的 Aurora 資料庫叢集。
1. 對於 **Actions** (動作)，選擇 **Query** (查詢)。如果您之前沒有連接到資料庫，則會開啟 **Connect to database (連接至資料庫)** 頁面。
![\[查詢編輯器 Connect to database (連接至資料庫) 頁面\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/AuroraUserGuide/images/query-editor-connect.png)
1. 輸入下列資訊：
1. 對於**資料庫執行個體或叢集**，選擇您想用來執行 SQL 查詢的 Aurora 資料庫叢集。
1. 對於 **Database username (資料庫使用者名稱)**，選擇連線時要使用的資料庫使用者的使用者名稱，或選擇 **Add new database credentials (新增資料庫登入資料)**。如果您選擇 **Add new database credentials (新增資料庫登入資料)**，請在 **Enter database username (輸入資料庫使用者名稱)** 中輸入新資料庫登入資料的使用者名稱。
1. 對於 **Enter database password (輸入資料庫密碼)**，針對您已選擇的資料庫使用者輸入密碼。
1. 在最後的方塊中，輸入您要用於 Aurora 資料庫叢集的資料庫或結構描述的名稱。
1. 選擇 **Connect to database (連接至資料庫)**。
**注意**
如果連線成功，則連線和身分驗證資訊會存放在 AWS Secrets Manager 中。您不需要再次輸入連線資訊。
1. 在查詢編輯器中，輸入您要對資料庫執行的 SQL 查詢。
![\[在文字區域中具有 SQL 陳述式的查詢編輯器\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/AuroraUserGuide/images/query-editor.png)
每個 SQL 陳述式可以自動遞交，或者您可以在交易過程中使用指令碼執行 SQL 陳述式。若要控制此行為，選擇查詢視窗上方的齒輪圖示。
![\[查詢編輯器中的齒輪圖示\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/AuroraUserGuide/images/query-editor-gear.png)
**Query Editor Settings (查詢編輯器設定)** 視窗即會顯示。
![\[查詢編輯器設定\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/AuroraUserGuide/images/query-editor-settings.png)
如果您選擇 **Auto-commit (自動遞交)**，則每個 SQL 陳述式即會自動遞交。如果您選擇 **Transaction (交易)**，則可以在指令碼中執行一組陳述式。陳述式會在指令碼結尾自動遞交，除非在此之前明確遞交或復原。您也可以透過啟用 **Stop on error (錯誤時停止)**，選擇在錯誤發生時停止執行中的指令碼。
**注意**
在一組陳述式中，資料定義語言 (DDL) 陳述式可能會導致先前的資料處理語言 (DML) 陳述式進行遞交。您也可以使用指令碼，將 `COMMIT` 和 `ROLLBACK` 陳述式包含在一組陳述式中。
在 **Query Editor Settings (查詢編輯器設定)** 視窗中進行選擇後，請選擇 **Save (儲存)**。
1. 選擇 **Run (執行)** 或按下 Ctrl\$1Enter，然後查詢編輯器將顯示您查詢的結果。
執行查詢之後，透過選擇 **Save (儲存)**，將查詢儲存到 **Saved queries (儲存的查詢)**。
透過選擇 **Export to csv (匯出至 csv)**，以試算表格式匯出查詢結果。
您可以尋找、編輯或傳回先前的查詢。若要這麼做，請選擇 **Recent (最近的項目)** 標籤或 **Saved queries (儲存的查詢)** 標籤，選擇查詢文字，然後選擇 **Run (執行)**。
若要變更資料庫，請選擇 **Change database (變更資料庫)**。
# Database Query Metadata Service (DBQMS) API 參考
Database Query Metadata Service (`dbqms`) 是僅內部服務。它為多個 AWS 服務 (包括 Amazon RDS) 的 AWS 管理主控台 查詢編輯器提供最近和已儲存的查詢。
**Topics**
+ [CreateFavoriteQuery](#CreateFavoriteQuery)
+ [CreateQueryHistory](#CreateQueryHistory)
+ [CreateTab](#CreateTab)
+ [DeleteFavoriteQueries](#DeleteFavoriteQueries)
+ [DeleteQueryHistory](#DeleteQueryHistory)
+ [DeleteTab](#DeleteTab)
+ [DescribeFavoriteQueries](#DescribeFavoriteQueries)
+ [DescribeQueryHistory](#DescribeQueryHistory)
+ [DescribeTabs](#DescribeTabs)
+ [GetQueryString](#GetQueryString)
+ [UpdateFavoriteQuery](#UpdateFavoriteQuery)
+ [UpdateQueryHistory](#UpdateQueryHistory)
+ [UpdateTab](#UpdateTab)
## CreateFavoriteQuery
儲存新的最愛查詢。每位 使用者最多可建立 1000 個已儲存的查詢。此限制將來可能會有所變更。
## CreateQueryHistory
儲存新的查詢歷史記錄項目。
## CreateTab
儲存新的查詢索引標籤。每位 使用者最多可以建立 10 個查詢索引標籤。
## DeleteFavoriteQueries
刪除一個或多個已儲存的查詢。
## DeleteQueryHistory
刪除查詢歷史記錄項目。
## DeleteTab
刪除查詢索引標籤項目。
## DescribeFavoriteQueries
列出使用者在指定帳戶中建立的已儲存查詢。
## DescribeQueryHistory
列出查詢歷史記錄項目。
## DescribeTabs
列出使用者在指定帳號中建立的查詢索引標籤。
## GetQueryString
從查詢 ID 擷取完整的查詢文字。
## UpdateFavoriteQuery
更新查詢字串、描述、名稱或過期日。
## UpdateQueryHistory
更新查詢歷史記錄的狀態。
## UpdateTab
更新查詢索引標籤名稱和查詢字串。