Section d'interface de SQL

Manuel d'implémentation › Spécifications de la configuration d'adaptateur › Section d'interface de SQL

Section d'interface de SQL

Vous pouvez utiliser l'adaptateur SQL pour récupérer des données des bases de données en utilisant une instruction SQL.

L'interface de SQL définit la connexion à la base de données et les requêtes utilisées pour récupérer les données :

Structure XML :

	< DataSourceInterface >
		<ConnectionString ConnectionTimeout="60" QueryTimeout="30">
			<![CDATA[ Driver={Microsoft Access Driver (*.mDataBase)};DataBaseq=d:\Oblicore\database1.mdatabase; ]]>
			</ConnectionString>
		<QueryCollection>
		<Query QueryName="cases" InputFormat="cases" SleepTime="3600">
			<SelectStatement AutoCompleteQuery="yes">
			select dateclosed,callid,dateopened,companyname,priority,closedmn,responsemn
			from calls where dateclosed is not NULL
			</SelectStatement>
		<QueryKeyFields>
			<KeyField Name="dateclosed" Sort="asc"/>
			<KeyField Name="callid" Sort="desc"/>
			<SelectInitialValues>
				Select min(dateclosed) , 'min date' from calls
			</SelectInitialValues>
		</QueryKeyFields>
	</Query>
	<Query QueryName="contracts" InputFormat="contracts" SleepTime="3600">
	<ConnectionString>
		<Segment Type="text"
		Text=" Driver={Microsoft Excel Driver (*.xls)}; DriverId=790; DataBaseq="/>
		<Segment Type="File">
		<File Path="d:\Oblicore " NamePattern="Availabilty_*.XLS>
		</Segment>
		<Segment Type="text" Text=";"/>
	</ConnectionString>
<SelectStatement AutoCompleteQuery="yes">….</SelectStatement>
<QueryKeyFields>…..</QueryKeyFields>
</Query>
</QueryCollection>
</DataSourceInterface>

ConnectionString : chaîne de Connexion pour accéder à la base de données source.
Vous pouvez définir le ConnectionString dans l'élément DataSourceInterface et/ou dans les éléments Requête. La définition de ConnectionString dans l'élément de DataSourceInterface est la valeur par défaut et il est utilisé uniquement dans une requête sans une définition de ConnectionString.

Vous pouvez définir la chaîne de connexion dans une chaîne ou par segments. Lorsque l'élément ConnectionString ne contient pas d'éléments Segment, la chaîne de connexion est prise dans le texte de l'élément ConnectionString. Si elle contient au moins un élément de segment, la chaîne de connexion est concaténée à partir de cet élément.

Il existe deux types de segment. Le premier est le texte et contient le texte concaténé à la chaîne de connexion telle quelle. Le deuxième type est le fichier et contient un nom de fichier avec ou sans caractères génériques. Le segment de fichier ne peut s'afficher qu'une fois et contient d'autres attributs qui définissent quoi faire avec le fichier lu.
- ConnectionTimeout (facultatif) : nombre entier positif qui indique, en secondes, le temps à attendre avant que la connexion ne s'ouvre. La valeur 0 indique de patienter jusqu'à l'établissement de la connexion. La valeur par défaut est de 15 secondes.
Remarque : Certains fournisseurs ne prennent pas en charge cette fonctionnalité.
- QueryTimeout (facultatif) : nombre entier positif qui indique, en secondes, le temps d'attente avant l'exécution de la requête. La valeur 0 indique de patienter jusqu'à la fin de l'exécution de l'opération. La valeur par défaut est de 30 secondes.
Remarque : Certains fournisseurs ne prennent pas en charge cette fonctionnalité.
- Segment : spécifie les attributs du segment.
- Type (facultatif) (texte, fichier) : type de segment
- Text : texte du segment.
- File : spécifie les attributs du fichier
- Path : chemin d'accès menant vers l'emplacement des fichiers de données sources.
- NamePattern : spécifie le nom de fichier de source de données. Il peut contenir des caractères génériques.
- InitialFileName (facultatif) : indique à l'utilisateur à partir de quel fichier il doit commencer la recherche et le modèle à rechercher.
- UsePath (facultatif) [yes, no] : lorsque défini sur yes, le chemin d'accès au fichier est concaténé à la chaîne de connexion.
- UseFileName (facultatif) [yes/no] : lorsque défini sur yes, le nom de fichier est concaténé à la chaîne de connexion (nécessaire pour les fichiers Excel).
- UpdateSchemaFile (facultatif) [yes/no] : lorsque défini sur yes, l'adaptateur met à jour le fichier schema.ini avec le nom de fichier actuel.
Remarque : Utilisez cet attribut uniquement lorsque vous voulez que l'adaptateur change le fichier schema.ini (base de données pour des fichiers texte).
QueryCollection : collecte de requêtes (plusieurs requêtes peuvent être définies dans un adaptateur).
- PreliminaryCheck : (facultatif [yes/no]). L'adaptateur vérifie les requêtes lorsqu'il se connecte à la base de données. Si cet attribut est défini sur no, l'adaptateur contrôle les requêtes en les exécutant sans aucun changement, l'adaptateur s'exécute sur les enregistrements de retour plus tard et ne les lit pas à nouveau. S'il est défini sur yes, l'adaptateur remplace chaque chaîne where de l'énoncé select avec "where 1=2 and" et uniquement alors il exécute les requêtes. Utilisez cette option si vous voulez vérifier toutes les requêtes avant que l'adaptateur commence à s'exécuter sur les enregistrements et lorsque cet ajout réduit dramatiquement le temps de requête. Remarque : Certains fournisseurs n'optimisent pas le processus de requête et lorsque la requête est autorisée, l'exécution prend le même temps que celui nécessaire sans l'ajout.
- ExternalCommand (facultatif) : la commande externe qui est exécutée devant l'adaptateur commence un nouveau cycle de lecture.
- Command : nom du fichier de commandes qui doit être exécuté.
- SleepTime : nombre entier positif qui indique, en secondes, le temps à attendre avant d'exécuter la commande à nouveau.
Query : spécifie les attributs de la requête.
- QueryName : nom de la requête.
- IsActive (facultatif) [yes/no] : lorsque défini sur no, l'adaptateur ne lit pas les enregistrements de ce fichier.
- InputFormat : format de fichier associé à cette requête. L'adaptateur utilise InputFormat pour extraire les données de l'enregistrement source.
- SleepTime : durée en secondes au cours de laquelle l'adaptateur se met en veille en attendant l'arrivée de nouvelles données.
- Critical (facultatif) [yes/no] : Si défini sur yes, l'adaptateur s'arrête immédiatement lorsqu'il trouve une erreur dans la requête. Utilisez l'option non lorsqu'il s'agit d'une erreur connue qui est résolue sans changer le fichier de configuration.
- TransactionMode (facultatif) [implicit/explicit] : Si défini sur explicit, l'adaptateur initie une transaction de base de données avant la requête. Cette option résout plusieurs problèmes dans des requêtes immenses et compliquées.
- RollbackSegementName (facultatif) : définit quel segment d'annulation l'adaptateur utilise. Dans le cas contraire, la base de données choisit le segment d'annulation.
SelectStatement : contient l'instruction à exécuter sur la base de données source.
- AutoCompleteQuery (facultatif) [yes/no] : S'il est défini sur yes, l'adaptateur automatiquement concatène un énoncé where à la requête spécifiée comme suit :
- crée un énoncé where qui apportera des valeurs uniquement nouvelles d'après les champs clé.
- Tri des résultats en fonction des champs clé.
QueryKeyFields : définit les champs pour commencer la récupération suivante de données :
- KeyField :
- Name : nom du champ, provenant des champs de la requête.
- Sort (facultatif) [asc/desc] : Méthode de tri de données (croissante/décroissante).
- Function (facultatif) : Utilisez cet attribut si une fonction spéciale doit s'appliquer à ce champ afin de combiner la valeur de champ et la fonction (:fieldname). Par exemple, vous pouvez utiliser la fonction de date d'Oracle avec un nom de champ Ts-Function="to_date(':ts','jj/mm/aaa')"
- ValueLeftWrapper (facultatif) : Utilisez cet attribut pour concaténer des caractères avant la valeur du champ. La valeur par défaut des champs Chaîne et Date est "'" (apostrophe).
- ValueRightWrapper (facultatif) : Utilisez cet attribut pour concaténer des caractères après la valeur du champ. La valeur par défaut des champs Chaîne et Date est "'" (apostrophe).
- NameLeftWrapper (facultatif) : Utilisez cet attribut pour concaténer des caractères avant le nom du champ. La valeur par défaut est une chaîne vide.
- NameRightWrapper (facultatif) : Utilisez cet attribut pour concaténer des caractères après le nom du champ. La valeur par défaut est une chaîne vide.
- IsPrimaryKey (facultatif) [yes/no] : Lorsqu'elle est définie sur no, cette clé n'est pas utilisée par l'adaptateur dans l'énoncé "where" automatique de la requête.
- DefaultInitialValue (facultatif) : Si la requête SelectInitialValues ne renvoie pas d'enregistrements, l'adaptateur prend la valeur par défaut qui se trouve dans cet attribut. S'il existe plusieurs champs clé, tous les champs clé doivent avoir cet attribut.
- SelectInitialValues : énoncé "select" qui fournit les valeurs initiales au premier énoncé "where" (lorsque le fichier de contrôle est vide).
Remarque : L'ordre des valeurs doit être identique à celui des éléments de champ de ce QueryKeyFields et renvoyer un résultat pour chaque champ.