Comprendre le fichier de personnalisation
Chaque en-tête de section du fichier de personnalisation se compose de crochets ([]) contenant un type et un paramètre. Les quatre types de section sont indiqués par les chaînes littérales connect, sql, userlistou logs. Le paramètre est la chaîne littérale, la valeur par défaut, un identificateur spécifié par l’utilisateur ou rien.
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 Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail 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.
Par conséquent, chaque section est marquée avec l’un des en-têtes de section suivants :
[ connect default ] [ connect
identifier
] [ sql default ] [ sql
identifier
] [ userlist
identifier
] [ logs ]
Les en-têtes de section ont les parties suivantes.
| Partie | Description |
|---|---|
| connecter | Chaîne littérale qui modifie une chaîne de connexion. |
| sql | Chaîne littérale qui modifie une chaîne de commande. |
| liste d’utilisateurs | Chaîne littérale qui modifie les droits d’accès d’un utilisateur spécifique. |
| journaux d’activité | Chaîne littérale qui spécifie un fichier journal enregistrant les erreurs opérationnelles. |
| par défaut | Chaîne littérale utilisée si aucun identificateur n’est spécifié ou trouvé. |
| identificateur | Chaîne qui correspond à une chaine dans la chaîne de commande connect ou . - Utilisez cette section si l’en-tête de section contient connecter et que la chaîne d’identificateur se trouve dans la chaîne de connexion. - Utilisez cette section si l’en-tête de section contient sql et que la chaîne d’identificateur se trouve dans la chaîne de commande. - Utilisez cette section si l’en-tête de section contient liste d’utilisateurs et que la chaîne d’identificateur correspond à un identificateur de section connexion. |
Le DataFactory appelle le gestionnaire, en passant des paramètres client. Le gestionnaire recherche des chaînes entières dans les paramètres client qui correspondent aux identificateurs dans les en-têtes de section appropriés. Si une correspondance est trouvée, le contenu de cette section est appliqué au paramètre client.
Une section particulière est utilisée dans les circonstances suivantes :
Une section connect est utilisée si la partie valeur du mot clé de chaîne de connexion du client «Data Source=valeur», correspond à un identificateur de section connect.
Une section sql est utilisée si la chaîne de commande cliente contient une chaîne qui correspond à un identificateur de section sql.
Un connexion ou section sql avec un paramètre par défaut est utilisée s'il n'y a pas d'identificateur correspondant.
Une section de liste d’utilisateurs est utilisée si l’identificateur de section de la liste d’utilisateurs correspond à un identificateur de section connecter. S’il existe une correspondance, le contenu de la section de la liste d’utilisateurs est appliqué à la connexion régie par la section connexion.
Si la chaîne de connexion ou de commande ne correspond pas à l'identifiant dans un en-tête de section connect ou sql et qu'il n'existe aucun en-tête de section connect ou sql avec un paramètre par défaut, alors la chaîne du client est utilisée telle quelle.
La section journaux d’activité est utilisée chaque fois que le DataFactory est en cours d’opération.
Voir aussi
La section de connexion des fichiers de personnalisation
Section Les journaux des fichiers de personnalisation
Fichier de Customisation section SQL
section UserList de fichier de personnalisation
Personnalisation de DataFactory
Paramètres client requis
Écrire votre propre gestionnaire personnalisé