建立命名空間 - Amazon Simple Storage Service

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

建立命名空間

資料表命名空間是您在 Amazon S3 資料表儲存貯體中將資料表分組的邏輯建構。每個資料表都屬於單一命名空間。在資料表儲存貯體中建立資料表之前，您必須建立命名空間來將資料表分組。您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API、 AWS SDKs 或整合式查詢引擎來建立命名空間。

命名空間名稱

下列命名規則適用於命名空間：

  • 名稱長度必須介於 1 到 255 個字元之間。

  • 名稱只能包含小寫字母、數字和底線 (_)。命名空間名稱的開頭或結尾不允許使用底線。

  • 名稱的開頭和結尾必須為字母或數字。

  • 名稱不得包含連字號 (-) 或句點 (.)。

  • 命名空間在資料表儲存貯體中必須是唯一的。

  • 命名空間名稱開頭不得為預留字首 aws。例如，您無法使用 aws_s3_metadata做為命名空間。 aws_s3_metadata 是中繼資料資料表的預留命名空間。如需詳細資訊，請參閱使用 S3 Metadata 加速資料探索。

如需有效命名空間名稱的詳細資訊，請參閱 資料表和命名空間的命名規則。

下列程序使用建立資料表搭配 Athena 工作流程，在 Amazon S3 主控台中建立命名空間。如果您不想也使用 Amazon Athena 在命名空間中建立資料表，您可以在建立命名空間後取消工作流程。

建立命名空間

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

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

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

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

  5. 在使用 Athena 建立資料表對話方塊中，選擇建立命名空間，然後選擇建立命名空間。

  6. 在命名空間名稱欄位中輸入名稱。命名空間名稱必須是 1 到 255 個字元，且在資料表儲存貯體中是唯一的。有效字元為 a–z、0–9 和底線 (_)。命名空間名稱的開頭或結尾不允許使用底線。

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

  8. 如果您也想要建立資料表，請選擇使用 Athena 建立資料表。如需使用 Athena 建立資料表的詳細資訊，請參閱 使用 S3 主控台和 Amazon Athena。如果您現在不想建立資料表，請選擇取消。

此範例說明如何使用 AWS CLI建立資料表命名空間。若要使用此範例，請以您自己的資訊取代 user input placeholders。

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

您可以在連線至 Amazon S3 資料表儲存貯體的 Apache Spark 工作階段中建立命名空間。

此範例說明如何在與 S3 Tables 整合的查詢引擎中使用 CREATE 陳述式建立資料表。若要使用此範例，請以您自己的資訊取代使用者輸入預留位置。

spark.sql("CREATE NAMESPACE IF NOT EXISTS s3tablesbucket.my_namespace")