テーブル名前空間は、Amazon S3 テーブルバケット内でテーブルをグループ化するための論理的な構成概念です。各テーブルは 1 つの名前空間に属します。テーブルバケット内にテーブルを作成する前に、テーブルをグループ化するための名前空間を作成する必要があります。名前空間は、Amazon S3 コンソール、AWS Command Line Interface (AWS CLI)、Amazon S3 REST API、AWS SDK、または統合クエリエンジンを使用して作成できます。
名前空間名
名前空間には、次の命名規則が適用されます。
-
名前の長さは 1〜255 文字にする必要があります。
-
名前には小文字、数字、下線 (
_) のみを含めることができます。名前空間名の先頭にアンダースコアを使用することはできません。 -
名前の最初と最後は、文字または数字にしてください。
-
名前にハイフン (
-) またはピリオド (.) を含めることはできません。
有効な名前空間名の詳細については、「テーブルと名前空間の命名規則」を参照してください。
以下の手順では、「Athena でテーブルを作成する」ワークフローを使用して Amazon S3 コンソールで名前空間を作成します。Amazon Athena を使用して名前空間にテーブルを作成しない場合は、名前空間の作成後にワークフローをキャンセルできます。
名前空間を作成するには
AWS Management Console にサインインし、Amazon S3 コンソール (https://console.aws.amazon.com/s3/
) を開きます。 -
左側のナビゲーションペインで、[テーブルバケット] を選択します。
-
[テーブルバケット] ページで、名前空間を作成するバケットを選択します。
-
バケットの詳細ページで、[Athena でテーブルを作成] を選択します。
-
[Athena でテーブルを作成] ダイアログボックスで、[名前空間を作成] を選択した後、[名前空間を作成] を選択します。
-
[名前空間名] フィールドに名前を入力します。名前空間名は 1～255 文字で、テーブルバケット内で一意であることが必要です。有効な文字は a〜z、0〜9、アンダースコア (
_) です。名前空間名の先頭にアンダースコアを使用することはできません。 -
[名前空間の作成] を選択します。
-
テーブルも作成する場合は、[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\ --namespaceexample_namespace
Amazon S3 テーブルバケットに接続された Apache Spark セッションに名前空間を作成できます。
この例では、S3 Tables と統合されたクエリエンジンで CREATE ステートメントを使用してテーブルを作成する方法を示します。この例を使用するには、ユーザー入力プレースホルダーを独自の情報に置き換えます。
spark.sql("CREATE NAMESPACE IF NOT EXISTS s3tablesbucket.my_namespace")
