# 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\$1comment]**  
`comment` という組み込みメタデータプロパティにメタデータ値を設定し、`database_comment` に値を指定します。AWS Glue では、`COMMENT` の内容がデータベースプロパティの `Description` フィールドに書き込まれます。

**[LOCATION S3\$1loc]**  
データベースファイルとメタストアがある場所を `S3_loc` として指定します。これは Amazon S3 の場所にする必要があります。

**[WITH DBPROPERTIES ('property\$1name' = 'property\$1value') [, ...]]**  
データベース定義のカスタムメタデータプロパティを指定します。

## 例
<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>

`CREATE DATABASE` を使用して AWSDataCatalog で作成するデータベースのデータベースプロパティを表示するには、以下の例にあるように、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/)を参照してください。