# CREATE DATABASE
<a name="create-database"></a>

创建一个数据库。`DATABASE` 和 `SCHEMA` 的使用是可互换的。它们具有相同的含义。

**注意**  
有关在 Athena 中创建数据库、创建表和在表上运行 `SELECT` 查询的示例，请参阅 [开始使用](getting-started.md)。

## 摘要
<a name="synopsis"></a>

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

有关 Athena 中的数据库名称的限制，请参阅[命名数据库、表和列](tables-databases-columns-names.md)。

## 参数
<a name="parameters"></a>

**[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') [, ...]]**  
允许您为数据库定义指定自定义元数据属性。

## 示例
<a name="examples"></a>

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

## 查看数据库属性
<a name="create-database-viewing-properties"></a>

要查看您在 AWSDataCatalog 中使用 `CREATE DATABASE` 创建的数据库的属性，您可以使用 AWS CLI 命令 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/get-database.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/get-database.html)，如以下示例所示：

```
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 用户指南](https://docs.aws.amazon.com/cli/latest/userguide/)。