CREATE DATABASE - Amazon Athena
概要參數範例檢視資料庫屬性

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

CREATE DATABASE

建立資料庫。DATABASE 和 SCHEMA 可互換使用。它們的意義相同。

注意

如需在 Athena 建立資料庫、建立資料表和執行資料表 SELECT 查詢的範例，請參閱 開始使用。

概要

CREATE {DATABASE|SCHEMA} [IF NOT EXISTS] database_name
  [COMMENT 'database_comment']
  [LOCATION 'S3_loc']
  [WITH DBPROPERTIES ('property_name' = 'property_value') [, ...]]

有關 Athena 中資料庫名稱的限制，請參閱 為資料庫、資料表和資料欄命名。

參數

[IF NOT EXISTS]

如果名為 database_name 的資料表已存在，會造成錯誤隱藏。

[COMMENT database_comment]

為名為 comment 的內建中繼資料屬性以及您為 database_comment 提供的值，建立中繼資料值。在 AWS Glue 中，COMMENT 的內容會寫入至資料庫屬性的 Description 欄位中。

[LOCATION S3_loc]

以 S3_loc 指定資料庫檔案和中繼存放區將存在的位置。此位置必須是 Amazon S3 位置。

[WITH DBPROPERTIES ('property_name' = 'property_value') [, ...] ]

可讓您指定資料庫定義的自訂中繼資料屬性。

範例

CREATE DATABASE clickstreams;
CREATE DATABASE IF NOT EXISTS clickstreams
  COMMENT 'Site Foo clickstream data aggregates'
  LOCATION 's3://amzn-s3-demo-bucket/clickstreams/'
  WITH DBPROPERTIES ('creator'='Jane D.', 'Dept.'='Marketing analytics');

檢視資料庫屬性

若要檢視您在 AWSDataCatalog 中使用 CREATE DATABASE 建立的資料庫的屬性，可以使用 AWS CLI 命令 aws glue get-database，如以下範例所示：

aws glue get-database --name <your-database-name>

在 JSON 輸出中，其結果看起來如下：

{
    "Database": {
        "Name": "<your-database-name>",
        "Description": "<your-database-comment>",
        "LocationUri": "s3://amzn-s3-demo-bucket",
        "Parameters": {
            "<your-database-property-name>": "<your-database-property-value>"
        },
        "CreateTime": 1603383451.0,
        "CreateTableDefaultPermissions": [
            {
                "Principal": {
                    "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS"
                },
                "Permissions": [
                    "ALL"
                ]
            }
        ]
    }
}

如需有關 AWS CLI 的詳細資訊，請參閱《AWS Command Line Interface 使用者指南》。