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

# 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)。

## Parameters
<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/)。