CREATE DATABASE

Cria um novo banco de dados.

Para criar um banco de dados, é necessário ser um superusuário ou ter o privilégio CREATEDB. Para criar um banco de dados associado a uma integração ETL zero, é necessário ser um superusuário ou ter os privilégios CREATEDB e CREATEUSER.

Não é possível executar CREATE DATABASE em um bloco de transação (BEGIN ... END). Para obter mais informações sobre transações, consulte Isolamento serializável.

Sintaxe

CREATE DATABASE database_name 
[ { [ WITH ]
    [ OWNER [=] db_owner ]
    [ CONNECTION LIMIT { limit | UNLIMITED } ]
    [ COLLATE { CASE_SENSITIVE | CASE_INSENSITIVE } ]
    [ ISOLATION LEVEL { SERIALIZABLE | SNAPSHOT } ]
  }
  | { [ WITH PERMISSIONS ] FROM DATASHARE datashare_name ] OF [ ACCOUNT account_id ] NAMESPACE namespace_guid }
  | { FROM { { ARN '<arn>' } { WITH DATA CATALOG SCHEMA '<schema>' | WITH NO DATA CATALOG SCHEMA } }
             | { INTEGRATION '<integration_id>' [ DATABASE '<source_database>' ] [SET {REFRESH_INTERVAL <interval>} ] } }
  | { IAM_ROLE  {default | 'SESSION' | 'arn:aws:iam::<account-id>:role/<role-name>' } }
]

Parâmetros

Sintaxe para usar CREATE DATABASE com um datashare

A sintaxe a seguir descreve o comando CREATE DATABASE usado para criar bancos de dados a partir de uma unidade de compartilhamento de dados para compartilhar dados na mesma conta da AWS.

CREATE DATABASE database_name
[ [ WITH PERMISSIONS ] FROM DATASHARE datashare_name ] OF [ ACCOUNT account_id ] NAMESPACE namespace_guid

A sintaxe a seguir descreve o comando CREATE DATABASE usado para criar bancos de dados a partir de uma unidade de compartilhamento de dados para compartilhar dados entre contas da AWS.

CREATE DATABASE database_name
[ [ WITH PERMISSIONS ] FROM DATASHARE datashare_name ] OF ACCOUNT account_id NAMESPACE namespace_guid

Parâmetros para usar CREATE DATABASE com um datashare

Notas de uso de CREATE DATABASE para compartilhamento de dados

Como superusuário de banco de dados, ao usar CREATE DATABASE para criar bancos de dados a partir de unidades de compartilhamento de dados da conta da AWS, especifique a opção NAMESPACE. A opção ACCOUNT é opcional. Ao usar CREATE DATABASE para criar bancos de dados de unidades de compartilhamento de dados entre contas da AWS, especifique os parâmetros ACCOUNT e NAMESPACE do produtor.

Você pode criar apenas um banco de dados de consumidor para uma unidade de compartilhamento de dados em um cluster de consumidores. Não é possível criar vários bancos de dados de consumidores referentes à mesma unidade de compartilhamento de dados.

CREATE DATABASE por meio do AWS Glue Data Catalog

Para criar um banco de dados usando um ARN do banco de dados do AWS Glue, especifique o ARN no comando CREATE DATABASE.

CREATE DATABASE sampledb FROM ARN <glue-database-arn> WITH NO DATA CATALOG SCHEMA;

Opcionalmente, você também pode fornecer um valor no parâmetro IAM_ROLE. Para obter mais informações sobre o parâmetro e os valores aceitos, consulte Parâmetros.

Veja a seguir exemplos que demonstram como criar um banco de dados com base em um ARN usando um perfil do IAM.

CREATE DATABASE sampledb FROM ARN <glue-database-arn> WITH NO DATA CATALOG SCHEMA IAM_ROLE <iam-role-arn>

CREATE DATABASE sampledb FROM ARN <glue-database-arn> WITH NO DATA CATALOG SCHEMA IAM_ROLE default;

Também é possível criar um banco de dados usando um DATA CATALOG SCHEMA.

CREATE DATABASE sampledb FROM ARN <glue-database-arn> WITH DATA CATALOG SCHEMA <sample_schema> IAM_ROLE default;

Criar bancos de dados para receber resultados de integrações ETL zero

Para criar um banco de dados usando uma identidade de integração ETL zero, especifique integration_id no comando CREATE DATABASE.

CREATE DATABASE destination_db_name FROM INTEGRATION 'integration_id';

Por exemplo, primeiro, recupere os IDs de integração de SVV_INTEGRATION:

SELECT integration_id FROM SVV_INTEGRATION;

Depois, use um dos IDs de integração recuperados para criar o banco de dados que recebe integrações ETL zero.

CREATE DATABASE sampledb FROM INTEGRATION 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111';

Quando o banco de dados de origem de integrações ETL zero for necessário, especifique, por exemplo:

CREATE DATABASE sampledb FROM INTEGRATION 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' DATABASE 'sourcedb';

Você também pode definir um intervalo de atualização para o banco de dados. Por exemplo, para definir o intervalo de atualização como 7.200 segundos para dados de uma fonte de integração ETL zero:

CREATE DATABASE myacct_mysql FROM INTEGRATION 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' SET REFRESH_INTERVAL 7200;

Consulte a visualização de catálogo SVV_INTEGRATION para ter informações sobre uma integração ETL zero, como integration_id, target_database, source, refresh_interval, e muito mais.

SELECT * FROM svv_integration;

Limites de CREATE DATABASE

O Amazon Redshift aplica esses limites aos bancos de dados:

Agrupamento de banco de dados

O agrupamento é um conjunto de regras que define como o mecanismo de banco de dados compara e classifica os dados de tipo de caractere em SQL. O agrupamento sem distinção de maiúsculas de minúsculas é o agrupamento mais comumente usado. O Amazon Redshift usa agrupamento sem distinção de maiúsculas e minúsculas para facilitar a migração de outros sistemas de data warehouse. Com o suporte nativo de agrupamento sem distinção de maiúsculas e minúsculas, o Amazon Redshift continua a usar métodos importantes de ajuste ou otimização, como chaves de distribuição, chaves de classificação ou varredura restrita de intervalo.

A cláusula COLLATE especifica o agrupamento padrão para todas as colunas CHAR e VARCHAR no banco de dados. Se CASE_INSENSITIVE for especificado, todas as colunas CHAR ou VARCHAR usarão agrupamento sem distinção de maiúsculas e minúsculas. Para obter mais informações sobre agrupamento, consulte Sequências de colação.

Os dados inseridos ou ingeridos em colunas que não diferenciam maiúsculas e minúsculas manterão suas letras originais. Mas todas as operações de string baseadas em comparação, incluindo classificação e agrupamento, são insensíveis a maiúsculas e minúsculas. Operações de correspondência de padrões, como predicados LIKE, semelhantes a, e funções de expressão regular também são insensíveis a maiúsculas e minúsculas.

As seguintes operações SQL suportam semântica de agrupamento aplicável:

Para consultas externas, incluindo consultas federadas do Amazon Redshift Spectrum e do Aurora PostgreSQL, o agrupamento da coluna VARCHAR ou CHAR é o mesmo que o agrupamento em nível de banco de dados atual.

O seguinte exemplo consulta uma tabela do Amazon Redshift Spectrum:

SELECT ci_varchar FROM spectrum.test_collation
WHERE ci_varchar = 'AMAZON';

ci_varchar
----------
amazon
Amazon
AMAZON
AmaZon
(4 rows)

Para obter informações sobre como criar tabelas usando o agrupamento de banco de dados, consulte CRIAR TABELA.

Para obter mais informações sobre funções COLLATE, consulte Função COLLATE.

Limitações do agrupamento de banco de dados

Veja as seguintes limitações ao trabalhar com agrupamento de banco de dados no Amazon Redshift:

Para fazer essas consultas funcionarem, use a função COLLATE para converter o agrupamento de uma coluna para corresponder à outra. Para obter mais informações, consulte Função COLLATE.

Exemplos

Criação de um banco de dados

O exemplo a seguir criar um banco de dados denominado TICKIT e de propriedade do usuário DWUSER.

create database tickit
with owner dwuser;

Consulte a tabela de catálogo PG_DATABASE_INFO para exibir detalhes sobre bancos de dados.

select datname, datdba, datconnlimit
from pg_database_info
where datdba > 1;

 datname     | datdba | datconnlimit
-------------+--------+-------------
 admin       |    100 | UNLIMITED
 reports     |    100 | 100
 tickit      |    100 | 100         

O exemplo a seguir cria um banco de dados chamado sampledb com o nível de isolamento SNAPSHOT.

CREATE DATABASE sampledb ISOLATION LEVEL SNAPSHOT;

O exemplo a seguir cria o banco de dados sales_db a partir da unidade de compartilhamento de dados saleshare.

CREATE DATABASE sales_db FROM DATASHARE salesshare OF NAMESPACE '13b8833d-17c6-4f16-8fe4-1a018f5ed00d';

Exemplos de agrupamento de banco de dados

Criação de um banco de dados que não diferencia maiúsculas de minúsculas

O exemplo a seguir cria o banco de dados sampledb, a tabela T1 e insere dados na tabela T1.

create database sampledb collate case_insensitive;

Conecte-se ao novo banco de dados que você acabou de criar usando o cliente SQL. Ao usar o Editor de Consultas do Amazon Redshift v2, escolha o sampledb no Editor. Ao usar o RSQL, use um comando semelhante ao seguinte.

\connect sampledb;

CREATE TABLE T1 (
  col1 Varchar(20) distkey sortkey
);

INSERT INTO T1 VALUES ('bob'), ('john'), ('Mary'), ('JOHN'), ('Bob');

Em seguida, a consulta encontra resultados com John.

SELECT * FROM T1 WHERE col1 = 'John';

 col1
 ------
 john
 JOHN
(2 row)

Ordenar por distinção de maiúsculas de minúsculas

O exemplo a seguir mostra a ordenação sem distinção de maiúsculas e minúsculas com a tabela T1. A ordenação de Bianca e bianca ou Jorge e jorge não é determinística porque os nomes são iguais em colunas que não diferenciam maiúsculas de minúsculas.

SELECT * FROM T1 ORDER BY 1;

 col1
 ------
 bob
 Bob
 JOHN
 john
 Mary
(5 rows)

Da mesma forma, o exemplo a seguir mostra a ordem sem distinção entre maiúsculas e minúsculas com a cláusula GROUP BY. Bob e bob são iguais e pertencem ao mesmo grupo. Não é determinístico qual aparece no resultado.

SELECT col1, count(*) FROM T1 GROUP BY 1;

 col1 | count
 -----+------
 Mary |  1
 bob  |  2
 JOHN |  2
(3 rows)

Consultar com uma função da janela em colunas que não diferenciam maiúsculas e minúsculas

O exemplo a seguir consulta uma função da janela em uma coluna que não diferencia maiúsculas e minúsculas.

SELECT col1, rank() over (ORDER BY col1) FROM T1;

 col1 | rank
 -----+------
 bob  |   1
 Bob  |   1
 john |   3
 JOHN |   3
 Mary |   5
(5 rows)

Consultar com a palavra-chave DISTINCT

O exemplo a seguir cria a tabela T1 com a palavra-chave DISTINCT.

SELECT DISTINCT col1 FROM T1;

 col1
 ------
 bob
 Mary
 john
(3 rows)

Consultar com a cláusula UNION

O exemplo a seguir mostra os resultados da UNION das tabelas T1 e T2.

CREATE TABLE T2 AS SELECT * FROM T1;

SELECT col1 FROM T1 UNION SELECT col1 FROM T2;

 col1
 ------
 john
 bob
 Mary
(3 rows)