# PostgreSQL - Nœud de workflow | Docs - nodulz

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

Language: fr

Requêtes, sélections et gestion des schémas, tables et lignes PostgreSQL

## Utilisation et spécificités

Choisissez un identifiant ou un service PostgreSQL selon connectionSource. Les modes guidés gèrent schémas, tables et lignes ; le mode SQL exécute la requête fournie. DELETE, DROP et cascade peuvent supprimer des données.

Type technique : `postgres`. Runtime : `nodulz`.

## Identifiants et prérequis

- [Créer et configurer l’identifiant : postgres](/docs/credentials/postgres)

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le [guide des identifiants](/docs/credentials) pour les accès et la rotation.

## 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 |
| --- | --- | --- | --- |
| `credentialId` | `string` | - | - |
| `serviceInstanceId` | `string` | - | - |
| `connectionSource` | `enum` | `"credential"` | `credential`, `service` |
| `operation` | `enum` | `"query"` | `query`, `select`, `insert`, `update`, `delete`, `create_schema`, `drop_schema`, `create_table`, `drop_table`, `alter_table` |
| `query` | `string` | `"SELECT 1 AS ok"` | - |
| `rawExpressions` | `boolean` | `false` | - |
| `schema` | `string` | `""` | - |
| `table` | `string` | `""` | - |
| `columns` | `string` | `"*"` | - |
| `data` | `string` | `""` | - |
| `match` | `string` | `""` | - |
| `orderBy` | `string` | `""` | - |
| `limit` | `string` | `""` | - |
| `ddl` | `string` | `""` | - |
| `ifNotExists` | `boolean` | `false` | - |
| `ifExists` | `boolean` | `false` | - |
| `cascade` | `boolean` | `false` | - |
| `returning` | `string` | `""` | - |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `connectionSource`<br>Source de connexion | Identifiant manuel ou service déployé dans l'espace Services. |
| `serviceInstanceId`<br>Instance de service | Seuls les services Available compatibles avec le binding sont listés. |
| `credentialId`<br>Identifiant base de données | Les paramètres de connexion sont gérés sur la page Identifiants. |
| `operation`<br>Opération | Type d'opération SQL à exécuter sur PostgreSQL. |
| `query`<br>Requête SQL | Toute instruction SQL (SELECT, INSERT, DDL…). Les expressions sont envoyées comme paramètres : ne les entourez pas de guillemets. |
| `rawExpressions`<br>Insérer les expressions telles quelles (non sécurisé) | Uniquement pour des noms de table ou de colonne dynamiques, avec des valeurs de confiance. |
| `schema`<br>Schéma | Nom de schéma PostgreSQL (lettres, chiffres, underscore). |
| `table`<br>Table | Utilisez des doubles accolades pour les valeurs dynamiques, ex. {{ nodes.http1.body.id }} |
| `columns`<br>Colonnes | Liste de colonnes séparées par des virgules, ou * pour toutes. |
| `data`<br>Données (objet JSON) | Objet JSON : les clés sont les colonnes, les valeurs sont des chaînes (expressions de workflow autorisées). |
| `orderBy`<br>ORDER BY | Tri, ex. created_at DESC. Identifiants uniquement. |
| `limit`<br>LIMIT | Nombre maximal de lignes (entier positif). |
| `returning`<br>RETURNING (optionnel) | Colonnes renvoyées après insert/update, ex. * ou id, created_at. |
| `ddl`<br>Définition | Pour créer une table : définitions entre parenthèses. Pour ALTER : clause commençant par ADD, DROP, ALTER ou RENAME. |
| `ifNotExists`<br>IF NOT EXISTS | Ajoute IF NOT EXISTS à la commande DDL. |
| `ifExists`<br>IF EXISTS | Ajoute IF EXISTS à la commande DDL. |
| `cascade`<br>CASCADE | Propage la suppression aux objets dépendants (DROP CASCADE). |

## Configuration initiale

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

```json
{
  "operation": "query",
  "query": "SELECT 1 AS ok",
  "schema": "",
  "table": "",
  "columns": "*",
  "data": "",
  "match": "",
  "orderBy": "",
  "limit": "",
  "ddl": "",
  "ifNotExists": false,
  "ifExists": false,
  "cascade": false,
  "returning": ""
}
```

## 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)