CREATE DATABASE - Amazon Athena
RésuméParamètresExemplesAffichage des propriétés d'une base de données

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

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

Pour les restrictions relatives aux noms de base de données dans Athena, voir. Nommez les bases de données, les tables et les colonnes

Paramètres

[SI NOTEXISTS]

Entraîne la suppression de l'erreur s'il existe déjà une base de données nommée database_name.

[COMMENTcommentaire_de base de données]

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.

[LOCATIONS3_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).

[WITHDBPROPERTIES('nom_propriété' = 'valeur_propriété') [,...]]

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://amzn-s3-demo-bucket/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 en AWSDataCatalog utilisantCREATE DATABASE, vous pouvez utiliser la AWS CLI commande aws glue get-database, comme dans l'exemple suivant :

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

En JSON sortie, le résultat est le suivant :

{
    "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.