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

# Aurora DSQL 入門指南
<a name="getting-started"></a>

Amazon Aurora DSQL 是針對交易工作負載最佳化的無伺服器、全受管、分散式關聯式資料庫。在下列各節中，您將了解如何建立單一區域和多區域 Aurora DSQL 叢集、與其連線，以及建立和載入範例結構描述。您將使用 AWS 主控台存取叢集，並選擇性地使用其他 PostgreSQL 用戶端與資料庫互動。最後，您將擁有可運作的 Aurora DSQL 叢集設定，可用於測試或生產工作負載。

**Topics**
+ [先決條件](#getting-started-prereqs)
+ [步驟 1：建立 Aurora DSQL 單一區域叢集](#getting-started-create-cluster)
+ [步驟 2：連線至 Aurora DSQL 叢集](#connect-dsql-cluster)
+ [步驟 3：在 Aurora DSQL 中執行範例 SQL 指令](#getting-started-sql)
+ [步驟 4 （選用）：建立多區域叢集](#getting-started-multi-region)
+ [疑難排解](#getting-started-sql-troubleshooting)

## 先決條件
<a name="getting-started-prereqs"></a>

在開始使用 Aurora DSQL 前，請確認您已符合以下先決條件：
+ 您的 IAM 身分必須具有[登入 主控台的](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html)許可。
+ 您的 IAM 身分必須符合下列條件：
  + 存取 以對 中的任何資源執行任何動作 AWS 帳戶
  + `AmazonAuroraDSQLConsoleFullAccess` AWS 已[連接](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonAuroraDSQLConsoleFullAccess.html) 受管政策。

## 步驟 1：建立 Aurora DSQL 單一區域叢集
<a name="getting-started-create-cluster"></a>

Aurora DSQL 的基本單位為叢集，即資料儲存的位置。在此任務中，您將在單一 AWS 區域中建立叢集。

**在 Aurora DSQL 中建立單一區域叢集**

1. 登入 AWS 管理主控台 並開啟位於 的 Aurora DSQL 主控台[https://console.aws.amazon.com/dsql](https://console.aws.amazon.com/dsql)。

1. 選擇**建立叢集**，然後選擇**單一區域**。

1. （選用） 變更預設**名稱**標籤的值。

1. （選用） 為此叢集新增其他**標籤**。

1. (選用) 在**叢集設定**中，選取以下任一選項：
   + 選取**自訂加密設定 (進階)** 以選擇或建立 AWS KMS key。如果您使用客戶受管金鑰，請確定金鑰政策授予 Aurora DSQL 必要的許可。如需詳細資訊，請參閱[客戶自管金鑰的金鑰政策](data-encryption.md#key-policy-customer-managed-key)。
   + 選取**啟用刪除保護**，可防止刪除操作誤刪叢集。預設會啟用刪除保護。
   + 選取**資源型政策 （進階）**，指定此叢集的存取控制政策。

1. 選擇 **Create Cluster** (建立叢集)。

1. 主控台會讓您返回**叢集**頁面。隨即出現通知橫幅，指出正在建立叢集。選取**叢集 ID** 以開啟叢集詳細資訊檢視。

## 步驟 2：連線至 Aurora DSQL 叢集
<a name="connect-dsql-cluster"></a>

Aurora DSQL 支援多種連接到叢集的方式，包括 DSQL 查詢編輯器、 AWS CloudShell、本機 psql 用戶端和其他 PostgreSQL 相容工具。在此步驟中，您會使用 [Aurora DSQL 查詢編輯器](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/getting-started-query-editor.html)進行連線，這可讓您快速開始與新叢集互動。

**使用查詢編輯器連線**

1. 在 Aurora DSQL 主控台 ([https://console.aws.amazon.com/dsql](https://console.aws.amazon.com/dsql)) 中，**開啟叢集**頁面，確認您的叢集建立已完成，且其狀態為作用中。

1. 從清單中選擇叢集，或選擇**叢集 ID** 以開啟叢集詳細資訊頁面。

1. 選擇**使用查詢編輯器連線**。

1. 為剛建立的叢集選擇 Connect as **admin**。
   + 您可以選擇性地與自訂角色連線，請參閱 [使用資料庫角色和 IAM 身分驗證](using-database-and-iam-roles.md)。

## 步驟 3：在 Aurora DSQL 中執行範例 SQL 指令
<a name="getting-started-sql"></a>

執行 SQL 陳述式以測試 Aurora DSQL 叢集。在查詢編輯器中開啟叢集後，依序選取並執行每個範例查詢。

**在 Aurora DSQL 中執行範例 SQL 命令**

1. 建立名為 `test` 的結構描述。

   ```
   CREATE SCHEMA IF NOT EXISTS test;
   ```

1. 建立 hello\$1world 資料表，使用自動產生的 UUID 做為主索引鍵。

   ```
   CREATE TABLE IF NOT EXISTS test.hello_world (  
       id UUID PRIMARY KEY DEFAULT gen_random_uuid(),  
       message VARCHAR(255) NOT NULL,  
       created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP  
   );
   ```

1. 插入範例資料列。

   ```
   INSERT INTO test.hello_world (message)  
   VALUES ('Hello, World!!');
   ```

1. 讀取插入的值。

   ```
   SELECT * FROM test.hello_world;
   ```

1. 選擇性清除

   ```
   DROP TABLE test.hello_world;
   DROP SCHEMA test;
   ```

## 步驟 4 （選用）：建立多區域叢集
<a name="getting-started-multi-region"></a>

建立多區域叢集時，請指定下列區域：

**遠端區域**  
此區域為建立第二個叢集的位置。在此區域建立第二個叢集，並將其與初始叢集對等互連。Aurora DSQL 會將初始叢集的所有寫入動作複寫至遠端叢集。您可在任一叢集上進行讀寫操作。

**見證區域**  
此區域會接收寫入多區域叢集的所有資料。然而，見證區域不會託管用戶端端點，也不提供使用者資料存取功能。見證區域中會保留一段加密交易日誌。此日誌有助於資料復原，並在區域無法使用時支援交易仲裁機制。

使用下列程序建立初始叢集、在不同區域中建立第二個叢集，然後對等兩個叢集以建立多區域叢集。同時示範跨區域寫入複寫與兩個區域端點間的一致讀取。

**建立多區域叢集**

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

1. 在導覽窗格中，選擇**叢集**。

1. 選擇**建立叢集**，再選擇**多區域**。

1. （選用） 變更預設**名稱**標籤的值。

1. （選用） 為此叢集新增其他**標籤**。

1. 在**多區域設定**中，為初始叢集選擇以下設定項目：
   + 在**見證區域中**選擇區域。目前多區域叢集的見證區域僅支援美國地區。
   + (選用) 在**遠端區域叢集 ARN** 欄位中，輸入另一區域現有叢集的 ARN。若目前無可作為第二叢集的現有叢集，請於建立初始叢集後再完成設定。

1. (選用) 在**叢集設定**中，為初始叢集選擇以下任一選項：
   + 選取**自訂加密設定 (進階)** 以選擇或建立 AWS KMS key。如果您使用客戶受管金鑰，請確定金鑰政策授予 Aurora DSQL 必要的許可。如需詳細資訊，請參閱[客戶自管金鑰的金鑰政策](data-encryption.md#key-policy-customer-managed-key)。
   + 選取**啟用刪除保護**，可防止刪除操作誤刪叢集。預設會啟用刪除保護。
   + 選取**資源型政策 （進階）**，指定此叢集的存取控制政策。

1. 選擇**建立叢集**以建立初始叢集。如果您在前一個步驟中未輸入 ARN，主控台會顯示**叢集設定擱置中**通知。

1. 在**叢集設定擱置中**通知中，選擇**完成多區域叢集設定**。此操作會開始在另一個區域建立第二個叢集。

1. 針對第二個叢集，請選擇下列其中一個選項：
   + **新增遠端區域叢集 ARN** – 若已存在叢集，且您希望將其設為多區域叢集中的第二個叢集，請選擇此選項。
   + **在另一個區域建立叢集** – 選擇此選項以建立第二個叢集。在**遠端區域中**，選擇第二個叢集所屬的區域。

1. 選擇**在 *your-second-region* 建立叢集**，其中 *your-second-region* 為第二個叢集的位置。主控台會在您的第二個區域開啟。

1. (選用) 選擇第二個叢集的設定。例如，您可以選擇 AWS KMS key。如果您使用客戶受管金鑰，請確定金鑰政策授予 Aurora DSQL 必要的許可。如需詳細資訊，請參閱[客戶自管金鑰的金鑰政策](data-encryption.md#key-policy-customer-managed-key)。

1. 選擇**建立叢集**以建立第二個叢集。

1. 選擇**在 *initial-cluster-region* 建立對等連線**，其中 *initial-cluster-region* 為託管您第一個叢集的區域。

1. 出現提示時，請選擇**確認**。此步驟將完成多區域叢集的建立。

**連線至第二個叢集**

1. 開啟 Aurora DSQL 主控台，並選擇第二個叢集所在的區域。

1. 選擇 **Clusters (叢集)**。

1. 選取多區域叢集內第二個叢集的資料列。

1. 選擇**使用查詢編輯器連線**。

1. 選擇**以管理員身分連線**。

1. 建立範例結構描述和資料表，並依照中的步驟插入資料[步驟 3：在 Aurora DSQL 中執行範例 SQL 指令](#getting-started-sql)。

**從託管初始叢集的區域查詢第二個叢集的資料**

1. 在 Aurora DSQL 主控台中，選擇初始叢集所在的區域。

1. 選擇 **Clusters (叢集)**。

1. 選取多區域叢集內第二個叢集的資料列。

1. 選擇**使用查詢編輯器連線**。

1. 選擇**以管理員身分連線**。

1. 查詢您匯入至第二個叢集的資料。  
**Example**  

   ```
   SELECT * FROM test.hello_world;
   ```

## 疑難排解
<a name="getting-started-sql-troubleshooting"></a>

請參閱 Aurora DSQL 文件的[故障診斷](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/troubleshooting.html)一節。