Amazon Redshift ne prendra plus en charge la création de nouvelles fonctions Python définies par l’utilisateur à compter du 1er novembre 2025. Si vous souhaitez utiliser des fonctions Python définies par l’utilisateur, créez-les avant cette date. Les fonctions Python définies par l’utilisateur existantes continueront de fonctionner normalement. Pour plus d’informations, consultez le billet de blog .

CREATE DATABASE

Crée une nouvelle base de données.

Pour créer une base de données, vous devez être super-utilisateur ou disposer du privilège CREATEDB. Pour créer une base de données associée à une intégration zéro ETL, vous devez être super-utilisateur ou disposer des privilèges CREATEDB et CREATEUSER.

Vous ne pouvez pas exécuter CREATE DATABASE au sein d’un bloc de transaction (BEGIN ... END). Pour plus d’informations sur les transactions, consultez Niveaux d’isolement dans Amazon Redshift.

Syntaxe

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

Paramètres

Syntaxe pour l’utilisation de CREATE DATABASE avec une unité de partage des données

La syntaxe suivante décrit la commande CREATE DATABASE utilisée pour créer des bases de données à partir d’une unité de partage des données afin de partager des données avec le même compte AWS.

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

La syntaxe suivante décrit la commande CREATE DATABASE utilisée pour créer des bases de données à partir d’une unité de partage des données afin de partager des données entre les comptes AWS.

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

Paramètres pour l’utilisation de CREATE DATABASE avec une unité de partage des données

Notes d’utilisation de la commande CREATE DATABASE pour le partage de données

En tant que super-utilisateur de base de données, lorsque vous utilisez la commande CREATE DATABASE pour créer des bases de données à partir d’unités de partage des données au sein du compte AWS, spécifiez l’option NAMESPACE. L’option ACCOUNT est facultative. Lorsque vous utilisez CREATE DATABASE pour créer des bases de données provenant d’unités de partage des données sur des comptes AWS, spécifiez les options ACCOUNT et NAMESPACE du producteur.

Vous ne pouvez créer qu’une seule base de données grand public pour une unité de partage des données sur un cluster consommateur. Vous ne pouvez pas créer plusieurs bases de données grand public faisant référence à la même unité de partage des données.

CREATE DATABASE depuis AWS Glue Data Catalog

Pour créer une base de données en utilisant un ARN de base de données AWS Glue, spécifiez l’ARN dans votre commande CREATE DATABASE.

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

Vous pouvez aussi éventuellement fournir une valeur dans le paramètre IAM_ROLE. Pour en savoir plus sur le paramètre et les valeurs acceptées, consultez Paramètres.

Les exemples suivants montrent comment créer une base de données à partir d’un ARN en utilisant un rôle 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;

Vous pouvez également créer une base de données en utilisant un DATA CATALOG SCHEMA.

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

Crée des bases de données pour recevoir les résultats des intégrations zéro ETL

Pour créer une base de données utilisant une identité d’intégration zéro ETL, spécifiez l’integration_id dans votre commande CREATE DATABASE.

CREATE DATABASE destination_db_name FROM INTEGRATION 'integration_id';

Par exemple, récupérez d’abord les identifiants d’intégration dans SVV_INTEGRATION ;

SELECT integration_id FROM SVV_INTEGRATION;

Utilisez ensuite l’un des identifiants d’intégration récupérés pour créer la base de données qui reçoit les intégrations zéro ETL.

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

Lorsque la base de données source des intégrations zéro ETL est requise, spécifiez par exemple.

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

Vous pouvez également définir un intervalle d’actualisation pour la base de données. Par exemple, pour définir l’intervalle d’actualisation à 7 200 secondes pour les données provenant d’une source d’intégration zéro ETL :

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

Interrogez la vue du catalogue SVV_INTEGRATION pour obtenir des informations sur une intégration zéro ETL, telles que integration_id, target_database, source, refresh_interval, etc.

SELECT * FROM svv_integration;

L’exemple suivant crée une base de données à partir d’une intégration avec le mode historique activé.

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

Limites de CREATE DATABASE

Amazon Redshift applique ces limites pour les bases de données :

Classement de base de données

Le classement est un ensemble de règles qui définit la façon dont le moteur de base de données compare et trie les données de type caractère dans SQL. Le classement insensible à la casse est le classement le plus utilisé. Amazon Redshift utilise un classement insensible à la casse pour faciliter la migration à partir d’autres systèmes d’entrepôts des données. Grâce à la prise en charge native du classement insensible à la casse, Amazon Redshift continue d’utiliser des méthodes de réglage ou d’optimisation importantes, telles que les clés de distribution, les clés de tri ou l’analyse à plage restreinte.

La clause COLLATE spécifie le classement par défaut de toutes les colonnes CHAR et VARCHAR de la base de données. Si CASE_INSENSITIVE est spécifié, toutes les colonnes CHAR ou VARCHAR utilisent un classement insensible à la casse. Pour obtenir des informations sur le classement, consultez Séquences de classement.

Les données insérées ou intégrées dans des colonnes insensibles à la casse conserveront leur casse d’origine. Cependant, toutes les opérations de chaîne basées sur la comparaison, y compris le tri et le regroupement, sont insensibles à la casse. Les opérations de correspondance de modèles telles que les prédicats LIKE, similaire à et les fonctions d’expression régulière sont également insensibles à la casse.

Les opérations SQL suivantes prennent en charge la sémantique de classement applicable :

Pour les requêtes externes, y compris les requêtes fédérées Amazon Redshift Spectrum et Aurora PostgreSQL, le classement de la colonne VARCHAR ou CHAR est le même que le classement actuel au niveau de la base de données.

L’exemple suivant interroge une table Amazon Redshift Spectrum :

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

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

Pour obtenir des informations sur la création de tables à l'aide du classement de bases de données, consultez CREATE TABLE.

Pour obtenir des informations sur la fonction COLLATE, consultez Fonction COLLATE.

Limites de classement de bases de données

Les limitations suivantes concernent l’utilisation du classement de base de données dans Amazon Redshift :

Pour que ces requêtes fonctionnent, utilisez la fonction COLLATE afin de convertir le classement d’une colonne et la faire correspondre à l’autre. Pour plus d'informations, consultez Fonction COLLATE.

Exemples

Création d’une base de données

L’exemple suivant crée une base de données nommée TICKIT et attribue la propriété à l’utilisateur DWUSER.

create database tickit
with owner dwuser;

Interrogez la table de catalogue PG_DATABASE_INFO afin d’afficher les détails relatifs aux bases de données.

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

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

L’exemple suivant crée une base de données nommée sampledb avec niveau d’isolation SNAPSHOT.

CREATE DATABASE sampledb ISOLATION LEVEL SNAPSHOT;

L’exemple suivant crée la base de données sales_db à partir de l’unité de partage des données salesshare.

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

Exemple de classement de bases de données

Création d’une base de données sensible à la casse

L’exemple suivant crée la base de données sampledb, crée la table T1 et insère des données dans la table T1.

create database sampledb collate case_insensitive;

Connectez-vous à la nouvelle base de données que vous venez de créer à l’aide de votre client SQL. Lorsque vous utilisez l’éditeur de requêtes Amazon Redshift, choisissez sampledb dans Éditeur. Lorsque vous utilisez RSQL, utilisez une commande similaire à celle-ci.

\connect sampledb;

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

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

Ensuite, la requête trouve des résultats avec John.

SELECT * FROM T1 WHERE col1 = 'John';

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

Classement par sensibilité à la casse

L’exemple suivant montre le classement par sensibilité à la casse avec la table T1. Le classement de Bob et bob ou John et john est non déterministe, car ils sont égaux dans la colonne insensible à la casse.

SELECT * FROM T1 ORDER BY 1;

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

De même, l’exemple suivant montre un classement par sensibilité à la casse avec la clause GROUP BY. Bob et bob sont égaux et appartiennent au même groupe. Lequel des deux apparaît dans le résultat est non déterministe.

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

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

Interrogation avec une fonction de fenêtrage sur des colonnes insensibles à la casse

L’exemple suivant interroge une fonction de fenêtrage sur une colonne insensible à la casse.

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

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

Interrogation avec le mot-clé DISTINCT

L’exemple suivant interroge la table T1 avec le mot-clé DISTINCT.

SELECT DISTINCT col1 FROM T1;

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

Interrogation avec la clause UNION

L’exemple suivant illustre les résultats de la clause UNION des tables T1 et T2.

CREATE TABLE T2 AS SELECT * FROM T1;

SELECT col1 FROM T1 UNION SELECT col1 FROM T2;

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