CREATE DATABASE (liée à un catalogue)¶

Crée une nouvelle base de données liée à un catalogue pour les tables Apache Iceberg™ qui utilisent un catalogue REST Iceberg externe.

Syntaxe¶

CREATE DATABASE <name>
  LINKED_CATALOG = ( catalogParams ),
  [ EXTERNAL_VOLUME = '<external_vol>' ]
  [ COMMENT = '<string_literal>' ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]

Copy

Où :

catalogParams ::=
  CATALOG = '<catalog_int>',
  [ ALLOWED_NAMESPACES = ('<namespace1>', '<namespace2>', ... ) ]
  [ BLOCKED_NAMESPACES = ('<namespace1>', '<namespace2>', ... ) ]
  [ NAMESPACE_MODE = { IGNORE_NESTED_NAMESPACE | FLATTEN_NESTED_NAMESPACE } ]
  [ NAMESPACE_FLATTEN_DELIMITER = '<string_literal>' ]
  [ SYNC_INTERVAL_SECONDS = <value> ]

Copy

Paramètres requis¶

name

Spécifie l’identificateur pour la base de données liée à un catalogue ; doit être unique pour votre compte.

De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (par exemple, "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

Paramètres facultatifs¶

EXTERNAL_VOLUME = my_external_vol

Spécifie un volume externe qui donne accès aux données et aux métadonnées de vos tables Iceberg distantes.

Non requis si vous utilisez des identifiants distribués.

COMMENT = 'string_literal'

Spécifie un commentaire pour la base de données.

Par défaut : aucune valeur

TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus d’informations sur la spécification des balises dans une instruction, voir Quota de balise pour les objets.

Paramètres du catalogue (catalogParams)¶

CATALOG = catalog_int

Spécifie le nom de votre intégration de catalogue.

ALLOWED_NAMESPACES = ('namespace1', 'namespace2', ... )

Spécifie éventuellement un ou plusieurs espaces de noms dans votre catalogue distant pour limiter la portée de la découverte automatique des tables. Snowflake synchronise les espaces de noms spécifiés et tous les espaces de noms et tables qui en dépendent. Si un espace de noms imbriqué se trouve dans la liste ALLOWED_NAMESPACES mais que vous définissez le paramètre NAMESPACE_MODE sur IGNORE_NESTED_NAMESPACE, Snowflake ne synchronise pas l’espace de noms imbriqué ni les schémas et tables sous celui-ci.

BLOCKED_NAMESPACES = ('namespace1', 'namespace2', ... )

Spécifie éventuellement un ou plusieurs espaces de noms dans votre catalogue distant à bloquer pour la découverte automatique des tables.

Snowflake bloque les espaces de noms spécifiés et tous les espaces de noms et tables qui en dépendent.

Si vous spécifiez ALLOWED_NAMESPACES et BLOCKED_NAMESPACES, la liste BLOCKED_NAMESPACES est prioritaire. Par exemple, si ns1.ns2 est autorisé, mais que ns1 est bloqué, Snowflake ne synchronisera pas ns1.ns2.

NAMESPACE_MODE = { IGNORE_NESTED_NAMESPACE | FLATTEN_NESTED_NAMESPACE }

Spécifie comment Snowflake gère les espaces de noms pour les tables Iceberg dans la base de données liée à un catalogue.

IGNORE_NESTED_NAMESPACE : Snowflake lie uniquement les tables du premier niveau d’espace de noms de votre catalogue.
FLATTEN_NESTED_NAMESPACE : Snowflake lie les tables dans tous les niveaux d’espace de noms de votre catalogue. Pour une table dans un espace de noms imbriqué, Snowflake utilise le paramètre NAMESPACE_FLATTEN_DELIMITER pour créer un espace de noms plat. Avec cette option, vous devez définir le paramètre NAMESPACE_FLATTEN_DELIMITER.

Par exemple, considérons une table nommée iceberg_table_5 dans l’espace de noms namespace3aa :
```
my_catalog_linked_db
|-- namespace3
|   |-- namespace3a
|       |-- namespace3aa
|           |-- iceberg_table_5
```
Copy
Si vous définissez NAMESPACE_FLATTEN_DELIMITER = "/", vous pouvez spécifier "my_catalog_linked_db"."namespace3/namespace3a/namespace3aa"."iceberg_table_5" pour faire référence à la table.

Par défaut : IGNORE_NESTED_NAMESPACE

NAMESPACE_FLATTEN_DELIMITER = 'string_literal'

Requis si vous définissez NAMESPACE_MODE = FLATTEN_NESTED_NAMESPACE. Spécifie un délimiteur, que Snowflake utilise pour créer des espaces de noms plats pour les tables dans votre catalogue.

Important

Le caractère que vous choisissez pour un délimiteur ne peut pas apparaître dans vos espaces de noms distants. Pendant le processus de découverte automatique, Snowflake ignore tout espace de noms contenant le délimiteur et ne crée pas de schéma correspondant dans votre base de données liée à un catalogue.

Caractères valides : Tout caractère autorisé dans les identificateurs Snowflake.

SYNC_INTERVAL_SECONDS = 'value'

Spécifie l’intervalle de temps (en secondes) que Snowflake doit utiliser pour découvrir automatiquement les schémas et les tables dans votre catalogue distant.

Valeurs : 30 à 86 400 (1 jour), inclusif

Par défaut : 30 secondes

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège	Objet	Remarques
CREATE DATABASE	Compte	Obligatoire pour la création d’une nouvelle base de données. Only the SYSADMIN role, or a higher role, has this privilege by default. The privilege can be granted to additional roles as needed.
USAGE	Volume externe	Nécessaire pour référencer un volume externe existant.
USAGE	Intégration de catalogue	Nécessaire pour référencer une intégration de catalogue existante.

Privilège

Objet

Remarques

CREATE DATABASE

Compte

Obligatoire pour la création d’une nouvelle base de données.

Only the SYSADMIN role, or a higher role, has this privilege by default. The privilege can be granted to additional roles as needed.

USAGE

Volume externe

Nécessaire pour référencer un volume externe existant.

USAGE

Intégration de catalogue

Nécessaire pour référencer une intégration de catalogue existante.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Pour ALLOWED_NAMESPACES et BLOCKED_NAMESPACES, Snowflake ne stocke pas les espaces de noms imbriqués si l’ensemble contient déjà l’espace de noms parent. Par exemple, si vous créez une base de données et que vous spécifiez ALLOWED_NAMESPACES = ('ns1', 'ns1.ns2', 'ns1.ns3'), Snowflake ne stocke que ns1, car les deux autres sont automatiquement inclus. Si vous utilisez GET_DDL sur la base de données d’exemple, Snowflake renvoie ALLOWED_NAMESPACES = ('ns1'). La même chose s’applique pour BLOCKED_NAMESPACES.
Pour interroger les tables Iceberg dans une base de données liée à un catalogue :
- Snowflake convertit automatiquement les identificateurs sans guillemets (noms de tables et de colonnes) en majuscules. Si votre catalogue Iceberg externe utilise des identificateurs sensibles à la casse, vous devez mettre les noms de tables et de colonnes entre guillemets doubles.
  
  Pour plus d’informations sur les identificateurs d’objets, consultez Exigences relatives à l’identificateur.
Concernant les métadonnées :

Attention

Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples¶

Créez une base de données liée à un catalogue avec des espaces de noms imbriqués plats.

CREATE DATABASE my_linked_db
  LINKED_CATALOG = (
    CATALOG = 'my_catalog_int',
    NAMESPACE_MODE = FLATTEN_NESTED_NAMESPACE,
    NAMESPACE_FLATTEN_DELIMITER = '-'
  )
  EXTERNAL_VOLUME = 'my_external_vol';

Copy

Créez une base de données liée à un catalogue qui utilise des identifiants de connexion distribués et spécifie un espace de noms autorisé :

CREATE DATABASE my_linked_db
  LINKED_CATALOG = (
    CATALOG = 'my_catalog_int_vended_creds',
    ALLOWED_NAMESPACES = ('my_namespace')
  );

Copy