SQL GET DATA SOURCE LIST
SQL GET DATA SOURCE LIST ( typeSource ; tabNomsSources ; tabPilotes )
| Paramètre | Type | Description | |
|---|---|---|---|
| typeSource | Integer | → | Type de source : utilisateur ou système |
| tabNomsSources | Text array | ← | Tableau des noms de sources de données |
| tabPilotes | Text array | ← | Tableau des pilotes des sources |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande SQL GET DATA SOURCE LIST retourne dans les tableaux tabNomsSources et tabPilotes les noms et les pilotes des sources de données de type typeSource définies dans le gestionnaire ODBC du système d’exploitation.
4D vous permet de vous connecter directement via le langage à une source de données ODBC externe et d’exécuter des requêtes SQL au sein d’une structure Begin SQL/End SQL. Le principe d’utilisation est le suivant : la commande SQL GET DATA SOURCE LIST permet d’obtenir la liste des sources de données présentes sur le poste. La commande SQL LOGIN permet alors de désigner la source à utiliser. Vous pouvez ensuite exécuter des requêtes SQL dans une structure Begin SQL/End SQL sur la source “courante”. Pour effectuer à nouveau des requêtes sur le moteur interne de 4D, il suffit de passer la commande SQL LOGOUT. Pour plus d’informations sur les commandes SQL dans l’éditeur de méthodes, reportez-vous au manuel Guide de référence 4D SQL.
Passez dans typeSource le type de source de données que vous souhaitez obtenir. Vous pouvez utiliser l’une des constantes suivantes, placées dans le thème “SQL” :
| Constante | Type | Valeur |
|---|---|---|
| System data source | Entier long | 2 |
| User data source | Entier long | 1 |
Note : Cette commande ne prend pas en compte les sources de données de type fichier.
La commande remplit et dimensionne les tableaux tabNomsSources et tabPilotes avec les valeurs correspondantes.
Note : Si vous souhaitez vous connecter à une source de données 4D externe via ODBC, vous devez au préalable installer le pilote 4D ODBC sur votre poste. Pour plus d'informations, reportez-vous au manuel d'installation de 4D ODBC Driver.
Exemple
Cet exemple utilise une source de données utilisateur :
ARRAY TEXT(tdsn;0)
ARRAY TEXT(tdsnPilotes;0)
GET DATA SOURCE LIST(User data source;tdsn;tdsnPilotes)
Variables et ensembles système
Si la commande est correctement exécutée, la variable système OK prend la valeur 1. Sinon, elle prend la valeur 0 et une erreur est générée.