Partager via


commande .create-merge table

Crée une table ou étend une table existante.

La commande doit s’exécuter dans le contexte d’une base de données spécifique.

Autorisations

Cette commande nécessite des autorisations d’utilisateur de base de données et des autorisations table Administration pour étendre les tables existantes.

Syntax

.create-mergetableTablename(Columnname:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

Découvrez les conventions de syntaxe.

Paramètres

Nom Type Obligatoire Description
tableName string ✔️ Nom de la table à créer ou à étendre.
columnName, columnType string ✔️ Nom d’une colonne existante ou nouvelle mappée au type de données dans cette colonne. La liste des mappages définit le schéma de colonne de sortie.
propertyName, propertyValue string Liste séparée par des virgules de paires de propriétés clé-valeur. Consultez propriétés prises en charge.

Propriétés prises en charge

Nom Type Description
docstring string Texte libre décrivant l’entité à ajouter. Cette chaîne est présentée dans différents paramètres d’expérience utilisateur en regard des noms d’entité.
folder string Nom du dossier à ajouter à la table.

Retours

Si la table n’existe pas, fonctionne exactement comme .create table une commande.

Si la table T existe et que vous envoyez une .create-merge table T (<columns specification>) commande, alors :

  • Toute colonne dans <la spécification> de colonnes qui n’existait pas auparavant dans T sera ajoutée à la fin du schéma de T.
  • Toute colonne de la spécification> T qui n’est pas dans <les colonnes ne sera pas supprimée de T.
  • Toute spécification> de colonne dans <les colonnes qui existe dans T, mais avec un type de données différent entraîne l’échec de la commande.