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

`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/)를 참조하세요.