Gestionnaire de connexions de fichiers

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

Un gestionnaire de connexions de fichiers permet à un package de référencer un fichier ou dossier existant ou de créer un fichier ou dossier au moment de l'exécution. Par exemple, vous pouvez référencer un fichier Excel. Certains composants de Microsoft SQL Server Integration Services utilisent les informations figurant dans les fichiers pour réaliser leur travail. Par exemple, une tâche d'exécution SQL peut référencer un fichier contenant les instructions SQL exécutées par la tâche. D'autres composants exécutent des opérations sur les fichiers. Par exemple, la tâche de système de fichiers peut référencer un fichier pour le copier à un nouvel emplacement.

Types d'utilisations du gestionnaire de connexions de fichiers

La propriété FileUsageType du gestionnaire de connexions de fichiers spécifie la manière dont la connexion de fichiers est utilisée. Le gestionnaire de connexions de fichiers peut créer un fichier, créer un dossier, utiliser un fichier existant ou utiliser un dossier existant.

Le tableau suivant répertorie les valeurs de FileUsageType.

Valeur Description
0 Le gestionnaire de connexions de fichiers utilise un fichier existant.
1 Le gestionnaire de connexions de fichiers crée un fichier.
2 Le gestionnaire de connexions de fichiers utilise un dossier existant.
3 Le gestionnaire de connexions de fichiers crée un dossier.

Connexions de fichiers ou de dossiers multiples

Le gestionnaire de connexions de fichiers peut référencer un seul fichier ou dossier. Pour référencer plusieurs fichiers ou dossiers, utilisez un gestionnaire de connexions de fichiers multiples au lieu du gestionnaire de connexions de fichiers. Pour plus d’informations, consultez Gestionnaire de connexions de fichiers multiples.

Configuration du gestionnaire de connexions de fichiers

Lorsque vous ajoutez un gestionnaire de connexions de fichiers à un package, Integration Services crée un gestionnaire de connexions qui sera converti en connexion de fichiers au moment de l’exécution, définit les propriétés de la connexion de fichiers et ajoute la connexion de fichiers à la collection Connections du package.

La propriété ConnectionManagerType du gestionnaire de connexions a pour valeur FILE.

Vous pouvez configurer un gestionnaire de connexions de fichiers de plusieurs manières :

  • Spécifiez le type d'utilisation.

  • Spécifiez un fichier ou un dossier.

Vous pouvez définir la propriété ConnectionString du gestionnaire de connexions de fichiers en spécifiant une expression dans la fenêtre Propriétés de SQL Server Data Tools (SSDT). Toutefois, pour éviter une erreur de validation lorsque vous utilisez une expression pour spécifier le fichier ou dossier, dans l’Éditeur du gestionnaire de connexions de fichiers, pour Fichier/Dossier, ajoutez un chemin de fichier ou de dossier.

Vous pouvez définir les propriétés par le biais du concepteur SSIS ou par programmation.

Pour plus d’informations sur les propriétés définissables dans le concepteur SSIS , consultez Éditeur du gestionnaire de connexions de fichiers.

Pour plus d’informations sur la configuration d’un gestionnaire de connexions par programmation, consultez ConnectionManager et Ajout de connexions par programme.

Éditeur du gestionnaire de connexions de fichiers

Utilisez la boîte de dialogue Éditeur du gestionnaire de connexions de fichiers pour spécifier les propriétés à utiliser pour se connecter à un fichier ou à un dossier.

Notes

Vous pouvez définir la propriété ConnectionString du gestionnaire de connexions de fichiers en spécifiant une expression dans la fenêtre Propriétés de SQL Server Data Tools (SSDT). Toutefois, pour éviter une erreur de validation lorsque vous utilisez une expression pour spécifier le fichier ou dossier, dans l’Éditeur du gestionnaire de connexions de fichiers, pour Fichier/Dossier, ajoutez un chemin de fichier ou de dossier.

Pour en savoir plus sur le gestionnaire de connexions de fichiers, consultez File Connection Manager.

Options

Type d'utilisation
Indiquez si le Gestionnaire de connexions de fichiers se connecte à un fichier ou dossier existant ou s’il crée un nouveau fichier ou dossier.

Value Description
Créer un fichier Crée un nouveau fichier au moment de l'exécution.
Fichier existant Utilise un fichier existant.
Créer un dossier Crée un nouveau dossier au moment de l'exécution.
Dossier existant Utilise un dossier existant.

Fichier / Dossier
Si Fichier, spécifiez le fichier à utiliser.

Si Dossier, spécifiez le dossier à utiliser.

Parcourir
Sélectionnez le fichier ou le dossier à l’aide de la boîte de dialogue Sélectionner un fichier ou Rechercher un dossier .

Référence de l’interface utilisateur de la boîte de dialogue Ajouter un gestionnaire de connexions de fichiers

Utilisez la boîte de dialogue Ajouter un gestionnaire de connexions de fichiers pour définir une connexion à un groupe de fichiers ou dossiers.

Pour en savoir plus sur le gestionnaire de connexions pour plusieurs fichiers, consultez Multiple Files Connection Manager.

Notes

Les tâches et composants de flux de données de Integration Services n'utilisent pas le gestionnaire de connexions de fichiers multiples. Toutefois, vous pouvez utiliser ce gestionnaire de connexions dans la tâche de script ou le composant Script.

Options de zone de dialogue pour Ajouter un gestionnaire de connexions de fichiers

Type d’utilisation
Spécifiez le type de fichiers à utiliser avec le gestionnaire de connexions pour plusieurs fichiers.

Valeur Description
Créer des fichiers Le gestionnaire de connexions va créer les fichiers.
Fichiers existants Le gestionnaire de connexions va utiliser des fichiers existants.
Créer des dossiers Le gestionnaire de connexions va créer les dossiers.
Dossiers existants Le gestionnaire de connexions va utiliser des dossiers existants.

Fichiers / Dossiers
Affichez les fichiers ou dossiers que vous avez ajoutés à l'aide des boutons décrits ci-après.

Ajouter
Ajoutez un fichier à l’aide de la boîte de dialogue Sélectionner les fichiers ou ajoutez un dossier à l’aide de la boîte de dialogue Rechercher un dossier .

Modifier
Sélectionnez un fichier ou dossier, puis remplacez-le par un autre fichier ou dossier à l’aide de la boîte de dialogue Sélectionner les fichiers ou Rechercher un dossier .

Remove
Sélectionnez un fichier ou dossier, puis supprimez-le de la liste à l’aide du bouton Supprimer .

Boutons de direction
Sélectionnez un fichier ou dossier, puis utilisez les boutons de direction pour le déplacer vers le haut ou vers le bas afin de spécifier l'ordre d'accès.

Référence de l'interface utilisateur de la boîte de dialogue Suggérer les types de colonnes

Utilisez la boîte de dialogue Suggérer les types de colonnes pour identifier le type de données et la longueur des colonnes dans un gestionnaire de connexions de fichiers plats en se basant sur un échantillonnage du contenu du fichier.

Pour en savoir plus sur les types de données utilisés par Integration Services, consultez Types de données d’Integration Services.

Options de zone de dialogue pour Suggérer les types de colonnes

Nombre de lignes
Tapez ou sélectionnez le nombre de lignes de l'échantillon utilisées par l'algorithme.

Suggérer le plus petit type de données integer
Désactivez cette case à cocher pour ignorer l'évaluation. Si elle est activée, détermine le plus petit type de données integer possible pour les colonnes contenant des données numériques entières.

Suggérer le plus petit type de données real
Désactivez cette case à cocher pour ignorer l'évaluation. Si elle est activée, détermine si les colonnes contenant des données numériques réelles peuvent utiliser le plus petit type de données real, DT_R4.

Identifier les colonnes booléennes en utilisant les valeurs suivantes
Tapez les deux valeurs à utiliser en tant que valeurs booléennes True et False. Ces valeurs doivent être séparées par une virgule, la première correspondant à la valeur True.

Remplir les colonnes de la chaîne
Activez cette case à cocher pour autoriser le remplissage de la chaîne.

Pourcentage de remplissage
Tapez ou sélectionnez le pourcentage des longueurs de colonnes à ajouter à la longueur des colonnes pour les données de type character. Ce pourcentage doit être un nombre entier.

Guide de référence des erreurs et des messages propres à Integration Services