教學課程：開始使用 S3 Tables

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

1. 登入 AWS 管理主控台 ，並在 https://console.aws.amazon.com/s3/：// 開啟 Amazon 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 管理主控台 ，並在 https://console.aws.amazon.com/s3/：// 開啟 Amazon 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 (執行)。