Gambas Documentation
Aperçu du Langage
À traduire
Code Snippets
Comment faire ...
Compilation et installation
Composants
Controls pictures
Derniers changements
Dépôt d'applications
Documentation de l'Environnement de développement
Documentation des développeurs
Documents
À propos de ma formule préférée
Captures d'écrans
Comportement interne de DrawingArea
Convention de Nommage des Variables
Conventions de nommage
Database Datatype Mapping
DBus et Gambas
Démarrer avec Gambas
Détails de l'architecture
Différences avec Visual Basic
Différences entre Shell et Exec
Distributions et systèmes d'exploitation
Drag & Drop
Gambas, c'est quoi ?
Introduction
Le modèle objet de Gambas
Le programme s'est arrêté de façon inattendue en levant le signal #11
Licence
LIENS RELATIFS à Gambas
Listes de diffusion et Forums
Livres
Localisation et Internationalisation
Network Programming
News
Notes de version
ODBC Component Documentation
Pages serveur Gambas
Passer Un Argument Par Référence
PCRE Pattern Syntax
Portage de Gambas 2 en Gambas 3
Questions fréquemment posées (FAQ)
Rich Text Syntax
Signaler un problème, un bogue ou un plantage
Tests de performance (benchmarks)
Window Activation & Deactivation
Indenter
Index de tous les Documents
Index du langage
Lexique
LISEZ-MOI
Manuel du wiki
Messages d'erreur
Tutoriels
Wiki License
La page anglaise est plus récente.

ODBC Component Documentation

Le composant Gambas ODBC utilise l’API fournie par le pilote manager unixODBC ; avoir unixODBC installé et opérationnel est un prérequis à l’utilisation des fonctions ODBC dans une application Gambas. Le composant ODBC Gambas s’appuie sur la configuration faite dans le unixODBC pilote manager, aussi, avant de se connecter a une base de données vous devez configurer le pilote de base de données et la source de donnée selon la base de données avec laquelle vous voulez vous connecter. La configuration est faite via la GUI du pilote manager unixODBC ou en éditant le fichier odbc.ini avec un éditeur de texte. Vous trouverez des exemples des deux méthodes de configuration plus avant dans ce document.

Habituellement les distributions Linux n’installent pas le paquetage unixODBC lors de la procédure standard d’installation, vous devez le chercher dans la liste d’applications puis l’installer manuellement. Par exemple dans la distribution OpenSuse le paquetage unixODBC est divisé en deux parties, le paquetage basique unixODBC qui fournit toutes les librairies et les fonctionnalités basiques (mais ca ne fournit pas la partie GUI), et le paquetage qui contient la partie GUI (il vous faut rechercher et installer la partie GUI comme un paquetage séparé). Si vous préférez compiler le paquetage unixODBC vous-même vous pouvez télécharger le code source depuis le site web unixODBC http://www.unixodbc.org et suivre les instructions de compilation et d’installation qui accompagnent le paquetage.

Pour activer le composant Gambas ODBC, vous devez compiler Gambas après l’installation du paquetage unixODBC. Si vous avez compilé Gambas avant l’installation du paquetage unixODBC, vous devrez le recompiler à nouveau. A la fin de la compilation vous verrez tous les modules qui sont configurés et activés dans l’environnement Gambas, si tout marche bien le composant ODBC doit être activé et installé.

Configuration unixODBC

Après l’installation d’unixODBC il vous faut ajouter, dans le gestionnaire de données, un pilote pour chaque base de données à laquelle vous voulez vous connecter. Certaines procédures d’installation de pilote ajoutent le pilote dans la configuration unixODBC automatiquement, d’autres non, vous devez les ajouter manuellement. Dans l’image suivante vous verrez le GUI ODBCConfig qui montre, dans l’onglet Pilotes, deux différents pilotes, l’un est employé pour se connecter avec le système i DB2 et l’autre pour se connecter a la base de données MySQL.

The unixODBC Configuration Gui

Vous pouvez utiliser le bouton Add pour ajouter un nouveau pilote pour une base de données spécifique. Dans le panneau de configuration vous devez spécifier le nom du pilote, la description et le chemin pour, à la fois, la librairie partagée du pilote et la librairie partagée de configuration DSN du pilote. La première librairie partagée est utilisée pour se connecter à la base de données, la deuxième est utilisée lors de la configuration de nom de la source de données (DSN = data source name). Dans l’image suivante vous pouvez voir le pilote ODBC pour la configuration Système i DB2.

Driver Properties

Une fois configuré le pilote que vous voulez utiliser, vous devez ajouter une Source de Données. Dans l’onglet " Data Source " vous devez spécifier tous les paramètres nécessaires pour se connecter à la base de données, tous les paramètres sont spécifiques à la base de données et beaucoup varient d’une base à l’autre. L’image suivante montre l’onglet DSN avec deux sources de données configurées.

Donnée Sources
Comme vous pouvez le voir dans les deux images qui suivent les configurations de deux DSN sont différentes car les paramètres nécessaires sont spécifiques à la base de données, le premier concerne une base de données MySQL (qui tourne en local), la deuxième concerne le Système i DB2 tournant sur un serveur distant.

DSN pour MySQL DSN pour System i DB2

Vous devez avoir un pilote de base de données configuré pour chaque type de base de données et une source de donnée pour chaque base de données que vous voulez utiliser. Par exemple, si vous avez deux MySQL DB tournant l’une sur un système distant A et l’autre sur le système distant B, vous n’aurez qu’un pilote de base de données configuré (MySQL driver) mais deux sources de données différentes : une source de données décrira la connexion (et tous les paramètres relatifs) au système A, et une source de données décrira la connexion (et tous les paramètres relatifs) au système B.

Exemples de Configuration unixODBC

Exemple de odbcinst.ini situé dans le répertoire /etc. Ce fichier contient tous les pilotes de configuration et les options configuration du Pilote Manager.

Exemples

odbcinst.ini


[iSeries Access ODBC Driver]
Description		= iSeries Access pour Linux ODBC Driver
Driver			= /opt/ibm/iSeriesAccess/lib/libcwbodbc.so
Setup			= /opt/ibm/iSeriesAccess/lib/libcwbodbcs.so
NOTE1			= If using unixODBC 2.2.11 or later and you want the 32 and 64-bit ODBC drivers to share DSN's,
NOTE2			= the following Driver64/Setup64 keywords will provide that support.
Driver64		= /opt/ibm/iSeriesAccess/lib64/libcwbodbc.so
Setup64		        = /opt/ibm/iSeriesAccess/lib64/libcwbodbcs.so
Threading		= 2
DontDLClose		= 1
UsageCount		= 1

[MySQL]
Description		=
Driver			= /usr/lib/odbc/libmyodbc.so
Driver64		= /usr/lib
Setup			= /usr/lib/odbc/libodbcdrvcfg1S.so
Setup64		        = /usr/lib
UsageCount		= 1
CPTimeout		=
CPReuse		        =

[ODBC]
Trace			= No
TraceFile		= /tmp/sql.log
ForceTrace		= No
Pooling			= No

[Firebird]
Description		=
Driver			= /usr/lib/firebird/libOdbcFb32.so
Driver64		= /usr/lib/firebird/libOdbcFb32.so
Setup			= /usr/lib/firebird/libOdbcFb32.so
Setup64		        = /usr/lib/firebird/libOdbcFb32.so
UsageCount		= 1
CPTimeout		=
CPReuse		        =

odbc.ini

Système wide odbc.ini situé dans le répertoire /etc

Exemples

odbc.ini

[MySQL_DB_test]
Description			= MySQL
Driver				= MySQL
Host				= localhost
Database			= TestDB
Port				=

[Numeric_DB]
Description			= Firebird
Driver				= firebird
Dbname			        = localhost:
Client				=
User				= User_ID
Password			= Password
Role				=
CharacterSet			= NONE
ReadOnly			= No
NoWait				= No
Dialect				= 3
QuotedIdentifier		= Yes
SensitiveIdentifier		= No
AutoQuotedIdentifier		= No
UseSchemaIdentifier		= 0 - Set null field SCHEMA
LockTimeoutWaitTransactions	= 0
SafeThread			= Yes

.odbc.ini

Configuration utilisateur ODBC situé dans le répertoire home de l’utilisateur .odbc.ini

Exemples

.odbc.ini

[System_i]
Description		= iSeries Access ODBC Driver
Driver			= iSeries Access ODBC Driver
System			= 9.71.196.44
UserID			=
Password		=
Naming			= 0
DefaultLibraries        = QGPL,qiws
Database		=
ConnectionType	        = 0
CommitMode		= 2
ExtendedDynamic   	= 1
DefaultPkgLibrary	= QGPL
DefaultPackage		= A/DEFAULT(IBM),2,0,1,0,512
AllowDataCompression	= 1
MaxFieldLength	        = 32
BlockFetch		= 1
BlockSizeKB		= 128
ExtendedColInfo	        = 0
LibraryView		= 0
AllowUnsupportedChar	= 0
ForceTranslation	= 0
Trace			= 0

[mySQL_test]
Description		= MySQL
Driver			= MySQL
Host			= localhost
Database		= BlobDB
Port			=

[NumericFB]
Description			= fbtest
Driver				= firebird
Dbname			        = localhost:/home/bortolan/fbtest/fbtest.fbd
Client				=
User				= bortolan
Password			= Password
Role				=
CharacterSet			= NONE
ReadOnly			= No
NoWait				= No
Dialect				= 3
QuotedIdentifier		= Yes
SensitiveIdentifier		= No
AutoQuotedIdentifier		= No
UseSchemaIdentifier		= 0 - Set null field SCHEMA
LockTimeoutWaitTransactions	= 0
SafeThread			= Yes

Exemple Gambas

Gambas contient quantité d’exemples d’applications, l’exemple base de données peut être utilisé pour se connecter à une base de données utilisant également un pilote ODBC. Il vous faut d’abord configurer un DSN dans le Pilote Manager. Choisissez l’exemple application de Base de données, lancez l’application et remplissez les champs requis pour vous connecter à la base de données.

Gambas

Sélectionnez le type de la base de données dans la liste, choisissez odbc, dans le nom d’hôte insérez le DSN configuré dans le pilote manager unixODBC. Le champ base de données n’est pas utilisé pour la connexion ODBC. Fournissez le nom de l’utilisateur et le mot de passe nécessaires à se connecter à la base de données. Vous êtes prêt à vous connecter !

Exemple d’application Base de données
Après la connexion vous pouvez lancer n’importes quelle commande SQL.

Exemple Blob

Dans ce qui suit, je vais commenter un exemple de programme que j’ai que j’ai utilisé pour insérer des fichiers image dans le champ Blob 

' Fichier classe \Gambas

PRIVATE $hConn AS Connection

PUBLIC SUB Form_Open()
 $hConn = NEW Connection
END

Le bouton Connect lance cette fonction: 
PUBLIC SUB btConnect_Click()

  WITH $hConn
    .Type = "odbc"			<<< Le type de base de données ODBC
    .Host = tbDatasource.Text		<<< Text Box avec les noms des  données source
    .Login = tbUser.Text		<<< Nom d’utilisateur employé pour la connexion
    .Password = tbPassword.Text	<<< Mot de passe utilisateur
    .Name = ""				<<< N’est pas utilisé dans la connexion ODBC
  END WITH

  $hConn.Open
  IF ($hConn.Opened = FALSE) THEN
	Message.Error("Erreur à l’ouverture de connexion")
	PRINT $hconn.Error
  ELSE

    ...

  ENDIF

END
Cette fonction est appelée par un bouton. Elle montre une boîte de dialog pour sélection de fichier puis insère dans le champ blob de la table le contenu du fichier 
PUBLIC SUB select_and_insert_into_blob_field_a_file()

  DIM hFile AS File
  DIM sLine AS String
  DIM outs AS blob
  DIM path AS String
  DIM hResult AS Result

  Dialog.Filter = ["*", "All Files"]
  Dialog.Title = "Choisissez le fichier à insérer dans le champ BLOB "

  IF Dialog.OpenFile() THEN RETURN
  path = Dialog.path
  sLine = File.Load(Dialog.Path)

  IF NOT $hConn.Opened THEN $hConn.Open

  hResult = DB.Create("table")	' nom de la table
  hResult!blob = sLine		' blob est le nom du champ BLOB dans la table
  hResult!filename = path       ' filename  est un champ string dans la table
  hResult.Update

  $hConn.Commit
  $hConn.Close
...

END