Table de données

Catalogue des nœuds Actions

Sur cette page

Tables JSON persistées dans nodulz, propres à ce workflow (sans base externe)

Utilisation et spécificités

Ces tables persistent dans nodulz et appartiennent au workflow. Définissez les colonnes et leurs types avant insertion. Les modes de conflit et de correspondance règlent l’upsert et la mise à jour.

Type technique : workflow_table. Runtime : nodulz.

Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le guide des identifiants si une source distante ou une cible d’exécution nécessite un accès.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`tableScope`	`enum`	`"workspace"`	`workspace`, `legacy`
`tableId`	`string`	-	-
`operation`	`enum`	`"select"`	`list_tables`, `create_table`, `alter_table`, `drop_table`, `clear_table`, `select`, `insert`, `bulk_insert`, `update`, `delete`
`table`	`string`	`"items"`	-
`tableNameInputMode`	`enum`	`"select"`	`select`, `text`
`schemaColumns`	`string`	`"[]"`	-
`seedData`	`string`	`""`	-
`columns`	`string`	`"*"`	-
`data`	`string`	`""`	-
`match`	`string`	`""`	-
`orderBy`	`string`	`""`	-
`limit`	`string`	`""`	-
`insertFieldMode`	`enum`	`"schema_only"`	`schema_only`, `extend_schema`
`insertConflictMode`	`enum`	`"fail"`	`fail`, `skip`, `upsert`, `replace`
`ifNotExists`	`boolean`	`false`	-
`ifExists`	`boolean`	`false`	-

Aide de configuration

operation Opération: Créer ou interroger une table interne identifiée par son nom dans ce workflow.
insertFieldMode Champs insérés: Colonnes du schéma uniquement (ignore les champs en trop) ou extension du schéma à partir des clés présentes dans les données.
insertConflictMode En cas de conflit de contrainte: Si une ligne enfreint une clé primaire ou une colonne unique : faire échouer l’opération, ignorer la ligne, fusionner dans la ligne existante (upsert), ou supprimer la ligne existante puis insérer (remplacer). Sans clé primaire ni colonne unique, chaque ligne est insérée.
seedData Données initiales: Lignes insérées automatiquement à la création de la table. Les valeurs peuvent être des expressions de workflow.
columns Colonnes: Liste de colonnes séparées par des virgules, ou * pour toutes.
orderBy ORDER BY: Tri sur un champ de ligne, ex. score DESC ou created_at ASC.
limit LIMIT: Nombre maximal de lignes (entier positif).
ifNotExists IF NOT EXISTS: Ajoute IF NOT EXISTS à la commande DDL.
ifExists IF EXISTS: Ajoute IF EXISTS à la commande DDL.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "tableScope": "workspace",
  "operation": "select",
  "table": "items",
  "tableNameInputMode": "select",
  "schemaColumns": "[]",
  "seedData": "",
  "columns": "*",
  "data": "",
  "match": "",
  "orderBy": "",
  "limit": "",
  "insertFieldMode": "schema_only",
  "insertConflictMode": "fail",
  "ifNotExists": false,
  "ifExists": false
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.