CREATE DATABASE

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.

Sinopsis

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.

Parámetros

[IF NOT EXISTS]

Hace que se suprima el error si ya existe una base de datos denominada database_name.

[COMMENT database_comment]

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_loc]

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

Le permite especificar las propiedades de metadatos personalizados para la definición de la base de datos.

Ejemplos

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

Para ver las propiedades de la base de datos que se crea en AWSDataCatalog mediante CREATE DATABASE, puede utilizar el comando aws glue get-database 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.