CREATE DATABASE - Amazon Athena
摘要参数示例查看数据库属性
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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 提供的值建立元数据值。在 Amazon 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 创建的数据库的属性，您可以使用 Amazon 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"
                ]
            }
        ]
    }
}

有关 Amazon CLI 的更多信息，请参阅 Amazon Command Line Interface 用户指南。