Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Crée une base de données. Les éléments `DATABASE` et `SCHEMA` sont interchangeables. Ils ont la même signification.

**Note**  
En guise d'exemple en matière de création d'une base de données, de création d'une table et d'exécution d'une requête `SELECT` sur la table dans Athena, voir [Mise en route](getting-started.md).

## Résumé
<a name="synopsis"></a>

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

Pour connaître les restrictions sur les noms de bases de données dans Athena, consultez [Attribution de noms aux tables, aux bases de données et aux colonnes](tables-databases-columns-names.md).

## Parameters
<a name="parameters"></a>

**[IF NOT EXISTS]**  
Entraîne la suppression de l'erreur s'il existe déjà une base de données nommée `database_name`.

**[COMMENT database\$1comment]**  
Définit la valeur de métadonnées pour la propriété de métadonnées intégrée nommée `comment` et la valeur que vous fournissez pour `database_comment`. Dans AWS Glue, le `COMMENT` contenu est écrit dans le `Description` champ des propriétés de la base de données.

**[LOCATION S3\$1loc]**  
Spécifie que l'emplacement des fichiers de base de données et du metastore est exprimé sous la forme `S3_loc`. Il doit s'agir d'un emplacement Simple Storage Service (Amazon S3).

**[WITH DBPROPERTIES ('property\$1name' = 'property\$1value') [, ...] ]**  
Permet de spécifier des propriétés de métadonnées personnalisées pour la définition de base de données.

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

## Affichage des propriétés d'une base de données
<a name="create-database-viewing-properties"></a>

Pour afficher les propriétés d'une base de données que vous créez dans AWSData Catalog à l'aide de cette commande`CREATE DATABASE`, vous pouvez utiliser la AWS CLI commande [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), comme dans l'exemple suivant :

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

Le code JSON de sortie se présente comme suit :

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

Pour plus d'informations à ce sujet AWS CLI, consultez le [guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/).