CREATE DATABASE

Cria um banco de dados. O uso de DATABASE e SCHEMA é intercambiável. Eles significam a mesma coisa.

nota

Para ver um exemplo de como criar um banco de dados, criar uma tabela e executar uma consulta SELECT na tabela do Athena, consulte Conceitos básicos.

Resumo

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

Para obter restrições sobre nomes de bancos de dados no Athena, consulte Nomear bancos de dados, tabelas e colunas.

Parâmetros

[IF NOT EXISTS]

Fará o erro ser suprimido se um banco de dados chamado database_name já existir.

[COMMENT database_comment]

Estabelece o valor de metadados para a propriedade de metadados interna chamada comment e o valor fornecido por você para database_comment. No AWS Glue, o conteúdo de COMMENT é gravado no campo Description das propriedades do banco de dados.

[LOCATION S3_loc]

Especifica o local onde arquivos de banco de dados e metastore existirão como S3_loc. O local deve ser um local do Amazon S3.

[WITH DBPROPERTIES ('property_name' = 'property_value') [, ...] ]

Permite especificar propriedades de metadados personalizados para a definição do banco de dados.

Exemplos

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');

Visualizar as propriedades do banco de dados

Para visualizar as propriedades de um banco de dados criado no AWSDataCatalog usando CREATE DATABASE, você pode usar o comando aws glue get-database da AWS CLI, como no seguinte exemplo:

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

Na saída do JSON, o resultado é semelhante ao seguinte:

{
    "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 obter mais informações sobre a AWS CLI, consulte o Manual do usuário da AWS Command Line Interface.