Fichier de personnalisation, section SQL

La section sql peut contenir une nouvelle chaîne SQL qui remplace la chaîne de commande cliente. S’il n’existe aucune chaîne SQL dans la section, la section est ignorée.

Important

À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir le Guide pratique sur la compatibilité de Windows Server 2012 et Windows 8 pour plus de détails). Les composants clients RDS seront supprimés dans une version ultérieure de Windows. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers WCF Data Service.

La nouvelle chaîne SQL peut être paramétrée. Autrement dit, les paramètres de la chaîne SQL de la section sql (désignés par le caractère « ? ») peuvent être remplacés par des arguments correspondants dans une chaîne de commande client (désignée par une liste délimitée par des virgules entre parenthèses). L’identificateur et la liste d’arguments se comportent comme un appel de fonction.

Par exemple, supposons que la chaîne de commande cliente est "CustomerByID(4)", que l’en-tête de section SQL est [SQL CustomerByID]et que la nouvelle chaîne de section SQL est "SELECT * FROM Customers WHERE CustomerID = ?". Le gestionnaire génère "SELECT * FROM Customers WHERE CustomerID = 4" et utilise cette chaîne pour interroger la source de données.

Si la nouvelle instruction SQL est la chaîne null («  »), la section est ignorée.

Si la nouvelle chaîne d’instruction SQL n’est pas valide, l’exécution de l’instruction échoue. Le paramètre client est effectivement ignoré. Pour ce faire, vous pouvez « désactiver » intentionnellement toutes les commandes SQL clientes en spécifiant :

[SQL default]   
SQL = " "  

Syntaxe

Une entrée de chaîne SQL de remplacement se présente sous la forme suivante :

SQL=
sqlString

Élément	Description
SQL	Chaîne littérale qui indique qu’il s’agit d’une entrée de section SQL.
sqlString	Chaîne SQL qui remplace la chaîne cliente.

Voir aussi

Fichier de personnalisation, section connect
Fichier de personnalisation, section Logs
Fichier de personnalisation, section UserList
Personnalisation de DataFactory
Paramètres client obligatoires
Présentation du fichier de personnalisation
Écriture d’un gestionnaire personnalisé