- Tableau de correspondance entre les différents types de bases de données, leurs sources et leurs databases
- Échec ou succès de la connexion
- Connexion à une analyse HFSQL
- ODBC et OLE DBÂ : Imbrication de connexions
- Connexion à une base de données par ODBC
- Connecteur Natif MySQL, MariaDB et PostgreSQL
- Connecteur Natif MySQL, MariaDB et PHP
- Connexion à une base de données ISAM par l'intermédiaire d'ACCESS
- Utiliser une connexion avec authentification NT
- Connecteur Natif Oracle : gestion de l'authentification externe
- Requête SQL (fonction HExécuteRequêteSQL ou requêtes créées par l'éditeur de requêtes)
SQLConnecte (Fonction) En anglais : SQLConnect Connecte l'application en cours à une base de données à interroger par SQL. Syntaxe
<Résultat> = SQLConnecte(<Source> , <Utilisateur> , <Mot de passe> [, <Nom de la DataBase> [, <Type de la base de données> [, <Provider OLE DB> [, <Informations optionnelles>]]]])
<Résultat> : Entier - Identifiant de la connexion : cet identifiant est utilisé par la fonction SQLChangeConnexion.
- 0 en cas d'erreur. Pour plus d'informations sur l'erreur, utilisez la fonction SQLInfoGene.
<Source> : Chaîne de caractères Nom de la source de données (appelé aussi Data Source Name). Si la source de données contient plusieurs "DataBase", il est nécessaire d'indiquer le nom de la "DataBase" utilisée (paramètre <Nom de la DataBase>). Pour plus de détails, consultez les remarques. <Utilisateur> : Chaîne de caractères Nom de l'utilisateur. Ce nom est optionnel pour certaines sources de données : dans ce cas, utilisez une chaîne vide ("") pour ce paramètre.
<Mot de passe> : Chaîne de caractères ou Chaîne secrète Mot de passe correspondant à l'utilisateur spécifié. Ce mot de passe est optionnel pour certaines sources de données : dans ce cas, utilisez une chaîne vide ("") pour ce paramètre.
Nouveauté 2025Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode". Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes. <Nom de la DataBase> : Chaîne de caractères optionnelle Nom de la DataBase à manipuler. Pour plus de détails, consultez les Remarques.- Si ce paramètre est précisé, une boîte de dialogue propre au driver s'affiche lors de la connexion. Cette boîte peut ne pas s'afficher en fonction du driver utilisé.
- Si ce paramètre n'est pas précisé, aucune boîte de dialogue ne s'affiche.
<Type de la base de données> : Chaîne de caractères optionnelle Type de la base de données accédée. Les types de bases de données installées sur le poste en cours peuvent être connues grâce à la fonction SQLListeSource. Pour plus de détails, consultez les remarques. <Provider OLE DB> : Chaîne de caractères ou Constante optionnelle Nom du provider OLE DB utilisé. Voici les plus courants : | | "SQLOLEDB" | SQLServer | "MSDASQL" | ODBC | "Microsoft.Jet.OLEDB.3.51" | Access | "Microsoft.Jet.OLEDB.4.0" | Access | "MSDAORA" | Oracle (Microsoft) | "OraOLEDB.Oracle" | Oracle | ou une des constantes suivantes : | | hODBC | Provider OLE DB pour ODBC. Permet d'accéder à une source de données ODBC déclarée dans les sources de données ODBC de Windows. | hOledbAccess97 | Provider OLE DB pour Access 97. | hOledbAccess2000 | Provider OLE DB pour Access 2000. | hOledbAccess2007 | Provider OLE DB pour Access 2007. | hOledbAccess2010 | Provider OLE DB pour Access 2010. | hOledbDBase5 | Provider OLE DB pour DBase 5. | hOledbExcel97 | Provider OLE DB pour Excel 97. | hOledbExcel2000 | Provider OLE DB pour Excel 2000. | hOledbExcel2007 | Provider OLE DB pour Excel 2007. | hOledbLotus4 | Provider OLE DB pour Lotus 4. | hOledbOracle | Provider OLE DB pour Oracle. | hOledbSQLServer | Provider OLE DB pour SQL Server. |
Attention : Pour utiliser une connexion OLE DB il est nécessaire :
- d'installer le MDAC version 2.6 minimum (installation réalisée avec WINDEV ou WEBDEV lors de l'installation de l'application)
- d'installer le provider OLE DB correspondant à la base de données manipulée.
<Informations optionnelles> : Chaîne de caractères optionnelle (ne pas utiliser avec HFSQL ou ODBC direct) Permet de spécifier des informations optionnelles. Il est par exemple possible de préciser le paramètre "Trusted_Connection=YES" pour utiliser une connexion avec authentification par le login NT. Si plusieurs informations optionnelles doivent être spécifiées, il est nécessaire de les rassembler dans une seule chaîne de caractères et de les séparer par le caractère ";".
Remarques Tableau de correspondance entre les différents types de bases de données, leurs sources et leurs databases | | | Type de la base de données | Source | Nom de la DataBase |
---|
ACCESS | Nom du fichier Access | "" (chaîne vide) | AS400 | Connecteur Natif AS/400 (module optionnel) | | DB2 | Connecteur Natif DB2 (module optionnel) Source définie dans ODBC Administrateur. | "" (chaîne vide) ou DataBase | HYPER FILE HFSQL | Nom de la base de données | "" (chaîne vide) | HFSQLCS | Nom ou adresse du serveur | Nom de la base de données | INFORMIX | Connecteur Natif Informix (module optionnel) | | JDBC | URL de connexion à la base de données. Cette URL est spécifique à chaque driver. | La base de données doit être spécifiée dans l'URL de connexion. Cette URL est spécifique à chaque driver JDBC. | HIVE | URL de connexion au serveur Hive. | DataBase | MariaDB | Connecteur Natif MariaDB (module optionnel) Nom de la base de données | DataBase | MySQL | Connecteur Natif MySQL (module optionnel) Nom de la base de données | DataBase | POSTGRESQL | Connecteur Natif PostgreSQL (module optionnel) Nom de la base de données | DataBase | ODBC | Source définie dans ODBC Administrateur | "" (chaîne vide) ou DataBase | OLEDB | Nom de la source | "" (chaîne vide) | ORACLE | Connecteur Natif Oracle (module optionnel) Nom de l'alias défini dans SQL NET Easy configuration et dans WDORAINS. | "" (chaîne vide) | PROGRESS | Connecteur Natif Progress (module optionnel) Source définie dans ODBC Administrateur. | "" (chaîne vide) ou DataBase | SQL AZURE | Connecteur Natif SQL Azure (module optionnel livré avec le Connecteur Natif SQL Server) Nom du serveur. Si le nom du serveur est de type : NomServeur.database.windows.net, le login doit être de la forme : login@NomServeur. | DataBase | SQL SERVER | Connecteur Natif SQL SERVER (module optionnel) Nom du serveur. | "" (chaîne vide) | SYBASE | Connecteur Natif SYBASE (module optionnel) Nom du serveur ou son alias. | "" (chaîne vide) | xBase | Connecteur Natif xBase (livré en standard) | | | Base de données disponible via le navigateur (uniquement disponible sous Chrome et Safari) "" (chaîne vide) | "" (chaîne vide) |
Échec ou succès de la connexion Si la connexion est un succès, l'identifiant de la connexion pourra être utilisé pour changer la connexion (fonction SQLChangeConnexion). Si la connexion est un échec, les variables SQL.Erreur et SQL.MesErreur ne sont pas initialisées. Pour plus de détails sur les causes de l'échec de la connexion, utilisez la fonction SQLInfoGene. Dans tous les cas (échec ou succès), il est nécessaire de fermer la connexion (fonction SQLDéconnecte).
Documentation également disponible pour…
|
|
|