Table de données
Lit, ajoute, modifie ou supprime des lignes d'une table de données de l'organisation, ou gère les tables elles-mêmes.
Fonctionnement
Les tables appartiennent à l'organisation : elles sont partagées par tous ses workflows et tous ses environnements, et se gèrent aussi depuis la page « Tables de données ». Chaque opération sur les lignes est faite pour chaque élément reçu, avec ses propres expressions. Les valeurs sont converties au type de la colonne ; une valeur non convertible arrête le bloc en citant l'élément et la colonne.
Paramètres
| Paramètre | Type | Détail |
|---|---|---|
| Ressource | choix | Valeurs : Lignes, Tables. |
| Opérationselon les autres paramètres | choix | Valeurs : Ajouter des lignes, Lire des lignes, Modifier des lignes, Modifier ou ajouter (upsert), Supprimer des lignes, Continuer si une ligne correspond, Continuer si aucune ligne ne correspond. |
| Opérationselon les autres paramètres | choix | Valeurs : Créer une table, Lister les tables, Renommer une table, Supprimer une table. |
| Tableselon les autres paramètres | choix | Valeurs : Choisie dans la liste, Par nom ou identifiant (expression possible). |
| Table de donnéesobligatoire · selon les autres paramètres | table de données | — |
| Nom ou identifiant de la tableobligatoire · selon les autres paramètres | texte | — |
| Lignes retenuesselon les autres paramètres | choix | Valeurs : Toutes les conditions sont remplies, Au moins une condition est remplie. |
| Conditionsselon les autres paramètres | conditions | Sans condition, « Lire » renvoie toute la table ; modifier ou supprimer exige au moins une condition. |
| Valeurs des colonnesselon les autres paramètres | choix | Valeurs : Automatique : champs de l'élément de même nom, Une valeur par colonne. |
| Valeursselon les autres paramètres | clé-valeur | Les valeurs sont converties au type de la colonne (nombre, booléen, date ISO). |
| Toutes les lignes correspondantesselon les autres paramètres | oui / non | 5 000 lignes au plus. |
| Lignes au plusselon les autres paramètres | nombre | — |
| Trierselon les autres paramètres | oui / non | — |
| Colonne de triselon les autres paramètres | texte | — |
| Sensselon les autres paramètres | choix | Valeurs : Croissant, Décroissant. |
| Simulation (aucune modification)selon les autres paramètres | oui / non | Renvoie les lignes concernées, avant et après, sans rien enregistrer. |
| Ne pas renvoyer les lignes ajoutéesselon les autres paramètres | oui / non | Pour les gros volumes : les éléments reçus sont transmis tels quels. |
| Nom de la tableobligatoire · selon les autres paramètres | texte | — |
| Colonnesselon les autres paramètres | colonnes | — |
| Réutiliser une table existante du même nomselon les autres paramètres | oui / non | Sinon, une table du même nom provoque une erreur. |
| Nouveau nomobligatoire · selon les autres paramètres | texte | — |
| Nom contenantselon les autres paramètres | texte | — |
| Trier parselon les autres paramètres | choix | Valeurs : Nom, Date de création, Dernière modification. |
| Sensselon les autres paramètres | choix | Valeurs : Croissant, Décroissant. |
Données reçues et renvoyées
- EntréeListe d'éléments.
- SortieLignes : { id, …colonnes, createdAt, updatedAt } (simulation : { before, after }). « Continuer si… » : l'élément reçu, inchangé, ou rien. Tables : { id, name, columns, rowCount, createdAt, updatedAt }.
Erreurs
Table introuvable, colonne inconnue, valeur non convertible, modification sans condition, stockage de l'organisation plein, trop de lignes concernées.
À savoir. Stockage : 50 Mo par organisation, toutes tables confondues ; 100 tables et 50 colonnes par table au plus.
À savoir. Les colonnes système id, createdAt et updatedAt sont utilisables dans les conditions et le tri.
Exemple
Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.
{
"resource": "row",
"operation": "upsert",
"tableBy": "name",
"tableName": "clients",
"match": "all",
"conditions": [
{
"id": "c1",
"column": "email",
"op": "eq",
"value": "{{ $json.email }}"
}
],
"mapping": "auto"
}