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 中資料庫名稱的限制，請參閱命名資料庫、資料表和資料行。

參數

[如果 NOTEXISTS]

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

[COMMENT資料庫註解]

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

[LOCATION地方]

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

[WITHDBPROPERTIES('屬性名稱' = '屬性值') [,...]

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

範例

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');

檢視資料庫屬性

若要檢視您在使用中建立之資料庫的資料庫屬性CREATE DATABASE，您可以 AWSDataCatalog 使用 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 使用者指南》。