CREATE DATABASE

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.

Résumé

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

Paramètres

[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_comment]

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 contenu COMMENT est écrit dans le champ Description de la base de données.

[LOCATION S3_loc]

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_name' = 'property_value') [, ...] ]

Permet de spécifier des propriétés de métadonnées personnalisées pour la définition de base de données.

Exemples

CREATE DATABASE clickstreams;

CREATE DATABASE IF NOT EXISTS clickstreams
  COMMENT 'Site Foo clickstream data aggregates'
  LOCATION 's3://myS3location/clickstreams/'
  WITH DBPROPERTIES ('creator'='Jane D.', 'Dept.'='Marketing analytics');

Affichage des propriétés d'une base de données

Pour afficher les propriétés d'une base de données que vous créez dans AWSDataCatalog à l'aide de CREATE DATABASE, vous pouvez utiliser la commande AWS CLI aws glue get-database, 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://<your-database-location>",
        "Parameters": {
            "<your-database-property-name>": "<your-database-property-value>"
        },
        "CreateTime": 1603383451.0,
        "CreateTableDefaultPermissions": [
            {
                "Principal": {
                    "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS"
                },
                "Permissions": [
                    "ALL"
                ]
            }
        ]
    }
}

Pour plus d'informations sur l'interface de ligne de commande AWS CLI, consultez le Guide de l'utilisateur AWS Command Line Interface.