创建一个数据库。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 用户指南。
