教學課程：開始使用 S3 Tables

建立資料表命名空間和資料表

1. 登入 AWS Management Console ，並在 https：//Amazon S3 主控台開啟 https://console.aws.amazon.com/s3/ S3 主控台。

2. 在左側導覽窗格中，選擇資料表儲存貯體。

3. 在資料表儲存貯體頁面上，選擇要建立資料表的資料表儲存貯體。

4. 在資料表儲存貯體詳細資訊頁面上，選擇使用 Athena 建立資料表。

5. 在使用 Athena 建立資料表對話方塊中，選擇建立命名空間，然後在命名空間名稱欄位中輸入名稱。命名空間名稱必須是 1 到 255 個字元，且在資料表儲存貯體中是唯一的。有效字元為 a–z、0–9 和底線 (_)。命名空間名稱開頭不允許底線。

6. 選擇 Create namespace (建立命名空間)。

7. 選擇使用 Athena 建立資料表。

8. Amazon Athena 主控台隨即開啟，並顯示 Athena 查詢編輯器。查詢編輯器會填入可用來建立資料表的範例查詢。修改查詢以指定您希望資料表擁有的資料表名稱和資料欄。

9. 當您完成修改查詢時，請選擇執行以建立資料表。

1. 執行下列命令，在資料表儲存貯體中建立新的命名空間：

   aws s3tables create-namespace \
   --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \
   --namespace my_namespace         

   1. 執行下列命令，確認您的命名空間已成功建立：

      aws s3tables list-namespaces \
      --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket

2. 執行下列命令，以資料表結構描述建立新的資料表：

   aws s3tables create-table --cli-input-json file://mytabledefinition.json

   對於 mytabledefinition.json 檔案，請使用下列範例資料表定義：

   {
       "tableBucketARN": "arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket",
       "namespace": "my_namespace",
       "name": "my_table",
       "format": "ICEBERG",
       "metadata": {
           "iceberg": {
               "schema": {
                   "fields": [
                        {"name": "id", "type": "int","required": true},
                        {"name": "name", "type": "string"},
                        {"name": "value", "type": "int"}
                   ]
               }
           }
       }
   }

查詢資料表

1. 登入 AWS Management Console ，並在 https：//Amazon S3 主控台開啟 https://console.aws.amazon.com/s3/ S3 主控台。

2. 在左側導覽窗格中，選擇資料表儲存貯體。

3. 在資料表儲存貯體頁面上，選擇包含您要查詢之資料表的資料表儲存貯體。

4. 在資料表儲存貯體詳細資訊頁面上，選擇您要查詢之資料表名稱旁的選項按鈕。

5. 選擇 Athena 的查詢資料表。

6. Amazon Athena 主控台隨即開啟，Athena 查詢編輯器隨即出現，並為您載入範例SELECT查詢。根據您的使用案例需要修改此查詢。

7. 若要執行查詢，選擇 Run (執行)。

查詢資料表

1. 前往 https://console.aws.amazon.com/athena/ 開啟 Athena 主控台。

2. 查詢您的資料表。以下是您可以修改的範例查詢。請務必以您的資訊取代 user input placeholders。

   SELECT * FROM "s3tablescatalog/amzn-s3-demo-table-bucket"."my_namespace"."my_table" LIMIT 10

3. 若要執行查詢，選擇 Run (執行)。