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

Crea una base de datos. El uso de `DATABASE` y `SCHEMA` es intercambiable. Significan lo mismo.

**nota**  
Para ver un ejemplo de cómo crear una base de datos, crear una tabla y ejecutar una consulta `SELECT` en una tabla en Athena, consulte [Introducción](getting-started.md).

## Sinopsis
<a name="synopsis"></a>

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

Para obtener las restricciones para los nombres de las bases de datos en Athena, consulte [Nombrar tablas, bases de datos y columnas](tables-databases-columns-names.md).

## Parámetros
<a name="parameters"></a>

**[IF NOT EXISTS]**  
Hace que se suprima el error si ya existe una base de datos denominada `database_name`.

**[COMMENT database\$1comment]**  
Establece el valor de metadato de la propiedad de metadatos integrada denominada `comment` y el valor que proporciona para `database_comment`. En AWS Glue, los contenidos `COMMENT` se escriben en el campo `Description` de las propiedades de la base de datos.

**[LOCATION S3\$1loc]**  
Especifica como `S3_loc` la ubicación donde existirán los archivos de la base de datos y el metaalmacén. La ubicación tiene que ser una ubicación de Amazon S3.

**[WITH DBPROPERTIES ('property\$1name' = 'property\$1value') [, ...] ]**  
Le permite especificar las propiedades de metadatos personalizados para la definición de la base de datos.

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

## Visualización de las propiedades de la base de datos
<a name="create-database-viewing-properties"></a>

Para ver las propiedades de la base de datos que se crea en AWSDataCatalog mediante `CREATE DATABASE`, puede utilizar el comando [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) de la AWS CLI, como en el siguiente ejemplo:

```
aws glue get-database --name <your-database-name>
```

En la salida JSON, el resultado tiene el siguiente aspecto:

```
{
    "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"
                ]
            }
        ]
    }
}
```

Para obtener más información acerca de la AWS CLI, consulte la [Guía del usuario de AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/).