Cours ODBC Pro pour 4D
Cours ODBC Pro pour 4D en PDF
...
4D ODBC PRO est un ensemble de routines externes 4D permettant à une base de données 4D sous Macintosh ou Windows de communiquer avec une base de données ODBC. Avec 4D ODBC PRO, votre base de données 4D peut afficher, manipuler et modifier les données stockées dans une base de données ODBC.
À propos de ce manuel
Ce manuel explique comment implémenter, utiliser et modifier les sources de données accessibles par ODBC avec une base de données 4D.
Le manuel est destiné aux utilisateurs déjà familiarisés avec le langage 4D et le langage SQL d'ODBC. Nous recommandons aux nouveaux utilisateurs de se familiariser avec les deux produits avant de continuer avec le manuel.
Multiplateforme
Ce manuel explique l’utilisation de 4D ODBC PRO sur Macintosh et Windows. Bien que les concepts et les fonctionnalités des deux versions de 4D ODBC PRO soient presque identiques, le manuel traite les éventuelles différences. Ces différences incluent l'interface utilisateur graphique et les commandes au clavier.
4D, 4D Server et 4D ODBC PRO
4D ODBC PRO peut être utilisé avec 4D ou 4D Server. Utilisé avec 4D ODBC PRO, 4D vous permet de créer une base de données pouvant devenir un client de la source de données ODBC. Chaque utilisateur disposant d'une copie de la base de données peut se connecter à la base de données ODBC et l'utiliser simultanément.
4D Server vous permet de créer une application de base de données multi-développeurs. Utilisé avec 4D ODBC PRO, 4D Server permet à plusieurs développeurs de se connecter à une base de données ODBC.
Dans ce manuel, 4D Server et 4D Server sont désignés par 4D sauf lorsqu'il existe une différence de comportement entre les deux produits.
Conventions
Ce manuel utilise certaines conventions pour vous aider à comprendre le contenu.
Les notes explicatives suivantes sont utilisées:
Remarque: le texte mis en évidence de cette manière fournit des annotations et des raccourcis qui vous aideront à utiliser 4D de manière plus productive.
Avertissement: les avertissements comme celui-ci vous avertissent des situations dans lesquelles des données risquent d'être perdues.
Fonctions: Toutes les fonctions 4D ODBC PRO sont précédées de "ODBC_", par exemple: ODBC_SQLAllocConnect.
Noms de table: en outre, tous les noms de table sont indiqués entre parenthèses dans le texte afin de les distinguer des noms de champs, formulaires et autres éléments. Par exemple, la table Companies est écrite en tant que table [Companies].
introduction
Ce manuel sert de guide de référence aux concepteurs, administrateurs et utilisateurs de 4D ODBC PRO intégré. Ce manuel suppose que vous connaissez l'architecture globale et les fonctionnalités de votre source de données ODBC, ainsi que le langage procédural de 4D et les fonctions disponibles dans votre pilote ODBC.
4D est un puissant outil de gestion de données pour Macintosh et Windows. Les applications développées avec 4D ODBC PRO associent la facilité d'utilisation d'une interface graphique à la puissance d'une base de données relationnelle sur un micro-ordinateur.
4D ODBC PRO permet de développer des applications qui tirent parti des atouts de 4D et de la source de données ODBC.
Avec 4D ODBC PRO, les données stockées dans une base de données SQL sont accessibles depuis 4D.
Architecture ODBC
ODBC (Open Database Connectivity) définit une bibliothèque de fonctions permettant à une application, telle que 4D, d'accéder à un système de gestion de base de données (SGBD) à l'aide du langage SQL (Structured Query Language). L'interface ODBC offre un accès indépendant du vendeur à différents systèmes de gestion de base de données.
L'architecture ODBC comprend quatre composants:
- l'application
- un gestionnaire de pilote
- le conducteur
- la source de données
Les principales fonctionnalités fournies par n’importe quel pilote ODBC sont les suivantes:
Connexion et déconnexion d'un SGBD
Effectuer des requêtes et fournir des zones de stockage et des formats de données pour les résultats de la requête
Permettre le traitement des transactions en ligne
Fonctionnalités externes à l'interface ODBC (fonctionnalités spécifiques au SGBD)
Le gestionnaire de pilotes est une bibliothèque liée dynamiquement (DLL) qui charge les pilotes, fournissant un point d’entrée unique aux fonctions ODBC pour différents pilotes.
Remarque pour les utilisateurs Macintosh: La bibliothèque ODBC intégrée à Mac OS n'étant pas entièrement opérationnelle, il est nécessaire d'installer un framework ODBC tiers sur cette plate-forme. Un tel framework peut être acquis, par exemple, auprès de Openlink ().
Ce manuel décrit les aspects importants de l’accès à une source de données à l’aide des commandes de bas niveau et de contrôle de 4D ODBC PRO.
Celles-ci ressemblent beaucoup aux appels API Microsoft ODBC natifs en termes de nom, syntaxe et fonction. Vous trouverez plus d’informations sur l’API MS ODBC à l’adresse suivante:
…
Ce manuel ne vise pas à fournir une analyse détaillée des opérations et des fonctionnalités ODBC.
Choix de connexion
La première étape de la conception d’une application 4D ODBC PRO consiste à choisir la base de données avec laquelle se connecter. ODBC fournit de nombreuses fonctions qui indiquent quelles bases de données sont disponibles, décrivent leur type de base de données et établissent une connexion avec elles.
Une application peut être conçue avec une base de données cible spécifique à l’esprit. Par exemple, un service de comptabilité peut avoir des enregistrements stockés dans une base de données ORACLE. Lors de la conception d'un système de commande, ils savent que les pilotes ORACLE sont nécessaires. Ils savent également de quels types de base de données il s'agit et quels attributs sont nécessaires pour se connecter à cette base de données. Lorsqu'une application est conçue pour une source de données cible, il est possible de tirer parti des fonctionnalités spécifiques offertes par le SGBD et le pilote.
Alternativement, une application peut devoir être conçue pour fonctionner avec n'importe quelle base de données. Il ne saura pas à l'avance quel pilote sera utilisé ni à quelle base de données avec laquelle se connecter. Dans ce cas, les développeurs doivent faire preuve de prudence afin de n'utiliser que les fonctionnalités communes à toutes les sources de données ODBC.
4D ODBC PRO permet aux développeurs de développer des applications pour l’un ou l’autre de ces deux scénarios.
Commandes ODBC de haut niveau et de bas niveau
Les commandes ODBC de haut niveau intégrées au thème "Source de données externe" de 4D vous permettent de mettre en œuvre des solutions simples pour que vos applications 4D communiquent avec des sources de données ODBC. Pour plus d'informations sur la catégorie de commandes ODBC de haut niveau, reportez-vous au manuel Langage de 4D.
Si vos applications nécessitent des fonctionnalités ODBC plus avancées, vous devez utiliser les commandes de «bas niveau» et de contrôle situées dans le plug-in ODBC PRO 4D et décrites dans cette documentation.
Les différentes fonctions ODBC peuvent être réparties en onze groupes distincts. Les groupes de routines suivants vous permettent d’interagir avec une source de données à différentes étapes de la communication:
Connexion à une source de données
Obtention d'informations sur un pilote et une source de données
Définition et récupération des attributs du pilote
Préparer les requêtes SQL
Envoi de demandes
Récupération des résultats et informations sur les résultats
Fonctions du catalogue
Terminer une déclaration
Mettre fin à une connexion
Macro
La gestion des erreurs
Fonctions de catalogue, Introduction
Les commandes de catalogue vous permettent d’extraire des informations telles que la liste des tables stockées dans le catalogue d’une source de données, la liste des noms de colonnes des tables spécifiées et les index associés à une table.
En utilisant les commandes du catalogue, vous pouvez:
Obtenir une liste des colonnes et des privilèges associés pour la table spécifiée (ODBC_SQLColumnPrivileges)
Obtenir une liste de noms de colonnes dans les tables spécifiées (ODBC_SQLColumns)
Récupérer une liste de clés étrangères dans la table spécifiée ou une liste de clés étrangères dans d'autres tables faisant référence à la clé primaire de la table spécifiée (ODBC_SQLForeignKeys)
Recherchez des informations sur les types de données pris en charge par la source de données (ODBC_SQLGetTypeInfo).
Récupérer les noms de colonne qui constituent la clé primaire d'une table (ODBC_SQLPrimaryKeys)
Obtenir la liste des paramètres d'entrée et de sortie, ainsi que les colonnes constituant l'ensemble de résultats pour les procédures spécifiées
(ODBC_SQLProcedureColumns)
Obtenir la liste des noms de procédure stockés dans une source de données spécifique (ODBC_SQLProcedures)
Recherchez des informations sur les colonnes d'une table spécifiée. L'ensemble optimal de colonnes identifiant de manière unique une ligne de la table ou les colonnes qui sont automatiquement mises à jour lorsqu'une valeur de la ligne est mise à jour par une transaction.
(ODBC_SQLSpecialColumns)
Obtenir une liste de statistiques sur une seule table et les index associés à la table (ODBC_SQLStatistics)
Obtenir une liste des tables et les privilèges associés à chaque table (ODBC_SQLTablePrivileges)
Renvoie une liste de noms de table, de catalogue ou de schéma et de types de table, stockés dans une source de données spécifique (ODBC_SQLTables).
ODBC_SQLColumnPrivileges
ODBC_SQLColumnPrivileges (stmtID; Nom du catalogue; Nom du schéma; Nom de la table; Nom de la colonne) -> Résultat
Type de paramètre Description
stmtID ID de relevé long
catalogName Texte Nom du catalogue
schemaName Texte Nom du schéma
nomTable Texte Nom de la table
columnName Texte Nom de la colonne
Résultat de la fonction Entier long Renvoie le résultat de la fonction API MS ODBC SQLColumnPrivileges
La description
La commande ODBC_SQLColumnPrivileges renvoie une liste de colonnes et les privilèges associés pour la table spécifiée. Le pilote renvoie les informations sous la forme d'un jeu de résultats sur le stmtID spécifié.
stmtID est un ID d'instruction valide renvoyé parODBC_SQLAllocStmt.
catalogName est le nom du catalogue.
schemaName est le nom du schéma.
nomTable est le nom de la table.
columnName est le modèle de recherche de chaîne pour les noms de colonne.
Résultats de fonction
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR ou SQL_INVALID_HANDLE.
ODBC_SQLColumns
ODBC_SQLColumns (stmtID; CatalogName; SchemaName; Nom de la table; Nom de la colonne) -> Résultat
Type de paramètre Description
stmtID ID de relevé long
catalogName String Nom du catalogue
schemaName String Modèle de recherche de chaîne pour les noms de schéma
tableName String Modèle de recherche de chaîne pour les noms de table
columnName String Modèle de recherche de chaîne pour les noms de colonne
Résultat de la fonction Entier long Renvoie le résultat de la fonction SQLColumns de l'API MS ODBC.
La description
La commande ODBC_SQLColumns renvoie la liste des noms de colonnes dans les tables spécifiées. Le pilote renvoie ces informations en tant que résultat sur le stmtID spécifié.
stmtID est un ID d'instruction valide renvoyé parODBC_SQLAllocStmt.
catalogName est le nom du catalogue.
schemaName est le modèle de recherche de chaîne pour les noms de schéma.
nomTable est le modèle de recherche de chaîne pour les noms de table.
columnName est le modèle de recherche de chaîne pour les noms de colonne.
Résultats de fonction
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR ou SQL_INVALID_HANDLE.
ODBC_SQLForeignKeys
ODBC_SQLForeignKeys (stmtID; pkCatalogName; pkSchemaName; pkTableName; fkCatalogName; fkSchemaName;
fkTableName) -> Résultat
Type de paramètre Description
stmtID ID de relevé long
pkCatalogName String Nom du catalogue de la table de clé primaire
pkSchemaName String Nom du schéma de la table de clés primaires
pkTableName String Nom de la table de clé primaire
fkCatalogName String Nom du catalogue de la table de clé étrangère
fkSchemaName String Nom du schéma de la table de clés étrangères
fkTableName String Nom de la table de clé étrangère
Résultat de la fonction Entier long Renvoie le résultat de la fonction SQL ODIF API de MS ODBC.
La description
La commande ODBC_SQLForeignKeys renvoie une liste de clés étrangères dans la table spécifiée ou une liste de clés étrangères dans d'autres tables faisant référence à la clé primaire de la table spécifiée.
stmtID est un ID d'instruction valide renvoyé parODBC_SQLAllocStmt.
pkCatalogName est le nom de la table du catalogue de clés primaires.
pkSchemaName est le nom du schéma de clé primaire.
pkTableName est le nom de la table de clé primaire.
fkCatalogName est le nom du catalogue de la table de clés étrangères.
fkSchemaName est le nom du schéma de la table de clés étrangères.
fkTableName est le nom de la table de clé étrangère.
Résultats de fonction
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR ou SQL_INVALID_HANDLE.
ODBC_SQLGetTypeInfo
ODBC_SQLGetTypeInfo (stmtID; dataType) -> Résultat
Type de paramètre Description
stmtID ID de relevé long
dataType Type de données SQL long
Résultat de la fonction Entier long Renvoie le résultat de la fonction SQL ODT API SQLGetTypeInfo
La description
La commande ODBC_SQLGetTypeInfo renvoie des informations sur les types de données pris en charge par la source de données. Le pilote renvoie les informations sous la forme d'un jeu de résultats SQL. Les types de données sont destinés à être utilisés dans les instructions DDL (Data Definition Language).
stmtID est un ID d'instruction valide renvoyé parODBC_SQLAllocStmt.
dataType est le type de données SQL, tel que la constante SQL_ALL_TYPES, qui est égale à 0.
Résultats de fonction
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR ou SQL_INVALID_HANDLE