# Table de données - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/workflow_table

Language: fr

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](/docs/credentials) 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

| Réglage | Rôle et conseils |
| --- | --- |
| `operation`<br>Opération | Créer ou interroger une table interne identifiée par son nom dans ce workflow. |
| `insertFieldMode`<br>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`<br>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`<br>Données initiales | Lignes insérées automatiquement à la création de la table. Les valeurs peuvent être des expressions de workflow. |
| `columns`<br>Colonnes | Liste de colonnes séparées par des virgules, ou * pour toutes. |
| `orderBy`<br>ORDER BY | Tri sur un champ de ligne, ex. score DESC ou created_at ASC. |
| `limit`<br>LIMIT | Nombre maximal de lignes (entier positif). |
| `ifNotExists`<br>IF NOT EXISTS | Ajoute IF NOT EXISTS à la commande DDL. |
| `ifExists`<br>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](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)