DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Connecteurs Natifs/Accès Natifs / Connecteur Natif PostgreSQL
  • Présentation
  • Programmation
  • 1. Ouverture de la connexion
  • 2. Exécution de requêtes
  • 3. Récupération du résultat
  • 4. Fermeture de la connexion
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Il est possible d'utiliser les fonctions SQL pour manipuler la base de données PostgreSQL.
Différences par rapport à la programmation HFSQL : L'utilisation des fonctions SQL pour manipuler des données PostgreSQL n'implique pas une importation de la structure des fichiers dans l'analyse. Cependant, les données doivent être manipulées uniquement par requêtes. Il n'est pas possible de lire directement le contenu des fichiers PostgreSQL.
Programmation

1. Ouverture de la connexion

La fonction SQLConnecte permet d'ouvrir une connexion à une base de données PostgreSQL par le Connecteur Natif. Il est nécessaire de passer en paramètre à la fonction SQLConnecte le type de la base utilisée, ici PostgreSQL.
Remarque : le nom de la source de données PostgreSQL (ici "BasePostgreSQL") est le nom du poste où la base de données est disponible ou bien son adresse IP. Dans tous les cas, le nom de la "DataBase" doit être spécifié.
NumConnexion = SQLConnecte("BasePostgreSQL", "", "", "", "PostgreSQL")
// ou
// NumConnexion = SQLConnecte("BasePostgreSQL", "Utilisateur", "MotDePasse", "MaDataBase", ...
// "PostgreSQL")
 
// Connexion à une base de données PostgreSQL distante
NumConnexion = SQLConnecte("192.168.1.51", "Utilisateur", "MotDePasse", "test", "PostgreSQL")
Gestion des alphabets : Tous les échanges sont réalisés dans l'alphabet (charset) courant. Une erreur survient lors de la connexion si le serveur ne gère pas les conversions depuis ou vers l'alphabet courant. Dans ce cas, il faut utiliser la fonction ChangeAlphabet avant la fonction SQLConnecte pour sélectionner un alphabet compatible avec le serveur.

2. Exécution de requêtes

L'exécution de requêtes est réalisée grâce à la fonction SQLExec. La fonction SQLExec attend en paramètres le texte de la requête SQL et le nom qui sera donné à cette requête.
SQLExec("SELECT NOM, PRENOM, POSTE, PHOTO FROM CLIENT", "REQ1")

3. Récupération du résultat

Plusieurs modes de récupération du résultat sont disponibles :
  • SQLPremier : Permet de récupérer le résultat et initialise un parcours du résultat de type SQLPremier/SQLCol.
  • SQLTable : Permet de récupérer le résultat de la requête dans un champ Table par programmation de l'application WINDEV ou du site WEBDEV. Il est possible de récupérer le résultat de la requête par Fetch partiel.
  • SQLFetch (SQLAvance) : Permet de parcourir les différentes lignes résultat de la requête. Le parcours du résultat de la requête est du type SQLAvance/SQLLitCol.
La fonction SQLBloque permet de bloquer soit les enregistrements de la table, soit les enregistrements sélectionnés par la requête. Le timeout (attente maximale) pour bloquer ou modifier un enregistrement bloqué est par défaut infini sur une base PostgreSQL. Pour modifier le timeout, il est conseillé d'utiliser l'option "WD Command Timeout" dans les informations optionnelles de la fonction SQLConnecte. Dans ce cas, lorsque le timeout sera atteint, une erreur sera renvoyée par la base.

4. Fermeture de la connexion

La fonction SQLFerme permet de fermer la connexion à la base de données lorsque toutes les requêtes nécessaires ont été réalisées.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale