Amazon Redshift non supporterà più la creazione di nuove UDF Python a partire dal 1º novembre 2025. Se desideri utilizzare le UDF Python, creale prima di tale data. Le UDF Python esistenti continueranno a funzionare normalmente. Per ulteriori informazioni, consulta il post del blog.

CREATE DATABASE

Crea un nuovo database.

Per creare un database, devi essere un utente con privilegi avanzati o disporre del privilegio CREATEDB. Per creare un database associato a un’integrazione Zero-ETL, devi essere un utente con privilegi avanzati o disporre di entrambi i privilegi CREATEDB e CREATEUSER.

Non è possibile eseguire CREATE DATABASE all'interno di un blocco di transazione (BEGIN ... END). Per ulteriori informazioni sulle transazioni, consultare Livelli di isolamento in Amazon Redshift.

Sintassi

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

Parametri

Sintassi per l'uso di CREATE DATABASE con una unità di condivisione dati

La sintassi seguente descrive il comando CREATE DATABASE utilizzato per creare database da una unità di condivisione dati per condividere dati all'interno del medesimo account AWS.

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

La sintassi seguente descrive il comando CREATE DATABASE utilizzato per creare database da una unità di condivisione dati per condividere dati tra account AWS.

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

Parametri per l'uso di CREATE DATABASE con una unità di condivisione dati

Note di utilizzo per CREATE DATABASE per la condivisione di dati

Come utente di database con privilegi avanzati, quando utilizzi CREATE DATABASE per creare database da unità di condivisione dati nell'account AWS, specifica l'opzione NAMESPACE. L'opzione ACCOUNT è facoltativa. Quando si utilizza CREATE DATABASE per creare database da unità di condivisione dati tra account AWS, è necessario specificare le opzioni ACCOUNT e NAMESPACE dal producer.

È possibile creare un solo database consumer per un'unità unità di condivisione dati in un cluster consumer. Non è possibile creare più database consumer che si riferiscono alla stessa unità di condivisione dati.

CREATE DATABASE da AWS Glue Data Catalog

Per creare un database utilizzando un database AWS Glue ARN, specifica l'ARN nel comando CREATE DATABASE.

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

Facoltativamente, puoi anche fornire un valore nel parametro IAM_ROLE. Per ulteriori informazioni sui parametri e sui valori accettati, consulta Parametri.

Di seguito sono riportati esempi che dimostrano come creare un database da un ARN utilizzando un ruolo 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;

È inoltre possibile creare un database utilizzando uno SCHEMA DEL CATALOGO DATI.

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

Crea database per ricevere i risultati delle integrazioni Zero-ETL

Per creare un database utilizzando un’identità di integrazione Zero-ETL, specifica il valore integration_id nel comando CREATE DATABASE.

CREATE DATABASE destination_db_name FROM INTEGRATION 'integration_id';

Ad esempio, recupera innanzitutto gli ID di integrazione da SVV_INTEGRATION.

SELECT integration_id FROM SVV_INTEGRATION;

Quindi utilizza uno degli ID di integrazione recuperati per creare il database che riceve le integrazioni Zero-ETL.

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

Quando è necessario il database di origine delle integrazioni Zero-ETL, ad esempio, specifica:

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

Puoi inoltre impostare un intervallo di aggiornamento per il database. Ad esempio, per impostare l’intervallo di aggiornamento su 7.200 secondi per i dati provenienti da una fonte di integrazione Zero-ETL:

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

Esegui la query sulla vista del catalogo SVV_INTEGRATION per informazioni su un’integrazione Zero-ETL, ad esempio integration_id, target_database, source, refresh_interval e altro.

SELECT * FROM svv_integration;

L’esempio seguente crea un database a partire da un’integrazione con la modalità cronologia attiva.

CREATE DATABASE sample_integration_db FROM INTEGRATION 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' SET HISTORY_MODE = true;

Limiti di CREATE DATABASE

Amazon Redshift applica i seguenti limiti per i database:

Confronto di database

Il confronto è un insieme di regole che definisce il modo in cui il motore di database confronta e ordina i dati di tipo carattere in SQL. Il confronto senza distinzione tra maiuscole e minuscole è il tipo di confronto più utilizzato. Amazon Redshift utilizza il confronto senza distinzione tra maiuscole e minuscole per facilitare la migrazione da altri sistemi di data warehouse. Con il supporto nativo del confronto senza distinzione tra maiuscole e minuscole, Amazon Redshift continua a utilizzare importanti metodi di regolazione o ottimizzazione, come le chiavi di distribuzione, le chiavi di ordinamento o la scansione con intervallo limitato.

La clausola COLLATE specifica il confronto di default per tutte le colonne CHAR e VARCHAR nel database. Se è specificato CASE_INSENSITIVE, tutte le colonne CHAR o VARCHAR utilizzano confronto senza distinzione tra maiuscole e minuscole Per informazioni sul confronto, consultare Sequenze di regole di confronto.

I dati inseriti o importati nelle colonne senza distinzione tra maiuscole e minuscole manterranno il loro formato maiuscole/minuscole originale. Ma tutte le operazioni di stringa basate su confronto, inclusi l'ordinamento e il raggruppamento, non fanno distinzione tra maiuscole e minuscole. Anche le operazioni di corrispondenza dei modelli come predicati LIKE, SIMILAR TO e funzioni di espressione regolare non fanno distinzione tra maiuscole e minuscole.

Le seguenti operazioni SQL supportano la semantica di confronto applicabile:

Per le query esterne, incluse le query federate di Amazon Redshift Spectrum e Aurora PostgreSQL, il confronto della colonna VARCHAR o CHAR è uguale al confronto corrente a livello di database.

Nell'esempio seguente viene eseguita una query su una tabella Amazon Redshift Spectrum:

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

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

Per informazioni su come creare le tabelle mediante il confronto di database, consultare CREATE TABLE.

Per ulteriori informazioni sulla funzione COLLATE, consultare Funzione COLLATE.

Limitazioni del confronto di database

Di seguito sono elencate le limitazioni nell'utilizzo del confronto di database in Amazon Redshift:

Per far funzionare queste query, utilizzare la funzione COLLATE per convertire il confronto di una colonna in modo che corrisponda all'altra. Per ulteriori informazioni, consulta Funzione COLLATE.

Esempi

Creazione di un database

Nell'esempio seguente viene creato un database denominato TICKIT e ne viene assegnata la proprietà all'utente DWUSER:

create database tickit
with owner dwuser;

Per visualizzare i dettagli sui database, eseguire una query sulla tabella di catalogo PG_DATABASE_INFO.

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

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

L'esempio seguente crea un database denominato sampledb con livello di isolamento SNAPSHOT.

CREATE DATABASE sampledb ISOLATION LEVEL SNAPSHOT;

Nell'esempio seguente viene creato il database sales_db dall'unità di condivisione dati salesshare.

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

Esempi di confronto di database

Creazione di un database senza distinzione tra maiuscole e minuscole

Nell'esempio seguente viene creato il database sampledb, la tabella T1 e sono inseriti i dati nella tabella T1.

create database sampledb collate case_insensitive;

Esegui la connessione al nuovo database che hai appena creato usando il client SQL. Se usi l'Editor di query Amazon Redshift v2, scegli sampledb in Editor. Se usi RSQL, esegui un comando come il seguente.

\connect sampledb;

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

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

Quindi la query trova i risultati con John.

SELECT * FROM T1 WHERE col1 = 'John';

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

Ordinamento senza distinzione tra maiuscole e minuscole

Nell'esempio seguente è mostrato l'ordinamento senza distinzione tra maiuscole e minuscole con la tabella T1. L’ordinamento di Bob e bob o John e john non è deterministico perché sono uguali nella colonna senza distinzione tra maiuscole e minuscole.

SELECT * FROM T1 ORDER BY 1;

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

Analogamente, nell'esempio seguente è mostrato l'ordinamento senza distinzione tra maiuscole e minuscole con la clausola GROUP BY. Bob e bob sono uguali e appartengono allo stesso gruppo. È non deterministico ciò che si presenta nel risultato.

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

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

Esecuzione di query con una funzione finestra su colonne senza distinzione tra maiuscole e minuscole

Nell'esempio seguente viene eseguita una query su una funzione finestra senza distinzione tra maiuscole e minuscole.

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

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

Esecuzione di query con la parola chiave DISTINCT

Nell'esempio seguente viene eseguita una query sulla tabella T1 con la parola chiave DISTINCT.

SELECT DISTINCT col1 FROM T1;

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

Esecuzione di query con la clausola UNION

Nell'esempio seguente sono mostrati i risultati dell'UNION delle tabelle 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)