Source de fichier flexible

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

Le composant Flexible File Source permet à un package SSIS de lire des données à partir de divers services de stockage pris en charge. Les services de stockage actuellement pris en charge sont :

• Stockage Blob Azure
• Azure Data Lake Storage Gen2

Pour afficher l’éditeur Flexible File Source, faites glisser Flexible File Source sur le concepteur de flux de données et double-cliquez dessus pour ouvrir l’éditeur.

Flexible File Source est un composant du Feature Pack SQL Server Integration Services (SSIS) pour Azure.

Les propriétés suivantes sont disponibles sur l’éditeur Flexible File Source.

• File Connection Manager Type (Type du gestionnaire de connexions) : spécifie le type de gestionnaire de connexions source. Choisissez ensuite un gestionnaire existant du type spécifié ou créez-en un.
• Folder Path (Chemin du dossier) : spécifie le chemin du dossier source.
• Nom de fichier : spécifie le nom du fichier source.
• File Format (Format du fichier) : spécifie le format du fichier source. Les formats pris en charge sont Text, Avro, ORC et Parquet. Vous devez utiliser Java pour ORC/Parquet. Cliquez ici pour obtenir des détails.
• Column delimiter character (Caractère séparateur de colonnes) : spécifie le caractère utilisé comme séparateur de colonnes (les délimiteurs à plusieurs caractères ne sont pas pris en charge).
• First row as the column name (Première ligne comme nom de colonne) : spécifie s’il faut considérer la première ligne comme un nom de colonne.
• Decompress the file (Décompresser le fichier) : spécifie s’il faut décompresser le fichier source.
• Compression Type (Type de compression) : spécifie le format de compression du fichier source. Les formats pris en charge sont GZIP, DEFLATE et BZIP2.

Les propriétés suivantes sont disponibles sur l’éditeur avancé.

• rowDelimiter : caractère utilisé pour séparer les lignes dans un fichier. Un seul caractère est autorisé. La valeur par défaut est \r\n.
• escapeChar : caractère spécial utilisé pour échapper un délimiteur de colonne dans le contenu du fichier d’entrée. Vous ne pouvez pas spécifier à la fois escapeChar et quoteChar pour une table. Un seul caractère est autorisé. Pas de valeur par défaut.
• quoteChar : caractère utilisé pour mettre entre guillemets une valeur de chaîne. Les délimiteurs de colonnes et de lignes à l’intérieur des guillemets seraient considérés comme faisant partie de la valeur de chaîne. Cette propriété s’applique aux jeux de données d’entrée et de sortie. Vous ne pouvez pas spécifier à la fois escapeChar et quoteChar pour une table. Un seul caractère est autorisé. Pas de valeur par défaut.
• nullValue : un ou plusieurs caractères utilisés pour représenter une valeur Null. La valeur par défaut est \N.
• encodingName : spécifiez le nom du codage. Voir la propriété Encoding.EncodingName.
• skipLineCount : indique le nombre de lignes non vides à ignorer pendant la lecture des données des fichiers d’entrée. Si skipLineCount et firstRowAsHeader sont spécifiés, les lignes sont d’abord ignorées, puis les informations d’en-têtes sont lues à partir du fichier d’entrée.
• treatEmptyAsNull : spécifie s’il faut traiter une chaîne Null ou vide comme une valeur Null lors de la lecture des données à partir d’un fichier d’entrée. La valeur par défaut est True.

Après avoir spécifié les informations de connexion, basculez vers la page Colonnes pour mapper les colonnes sources sur les colonnes de destination du flux de données SSIS.

Remarques sur la configuration des autorisations du principal de service

Pour que la connexion de test fonctionne (soit le stockage d’objets blob, soit Data Lake Storage Gen2), le principal de service doit disposer au moins du rôle Lecteur des données Blob du stockage pour le compte de stockage. Cette opération s’effectue à l’aide de RBAC.

Pour le stockage d’objets blob, l’autorisation de lecture est accordée en affectant au moins le rôle Lecteur des données Blob du stockage.

Pour Data Lake Storage Gen2, l’autorisation est déterminée à la fois par RBAC et par des listes des contrôles d’accès (ACL). Faites attention à ce que les listes de contrôle d’accès soient configurées à l’aide de l’ID d’objet (OID) du principal de service pour l’inscription d’application, comme indiqué ici. Cet ID diffère de l’ID d’application (client) utilisé avec la configuration RBAC. Quand un principal de sécurité reçoit des autorisations sur les données RBAC par le biais d’un rôle intégré ou personnalisé, ces autorisations sont évaluées en premier lors de l’autorisation d’une demande. Si l’opération demandée est autorisée par les attributions RBAC du principal de sécurité, l’autorisation est immédiatement résolue et aucune vérification de liste de contrôle d’accès supplémentaire n’est effectuée. Sinon, si le principal de sécurité n’a pas d’attribution RBAC ou si l’opération de la demande ne correspond pas à l’autorisation affectée, les vérifications de liste de contrôle d’accès sont effectuées pour déterminer si le principal de sécurité est autorisé à effectuer l’opération demandée. Pour l’autorisation de lecture, accordez au moins l’autorisation d’Exécution à partir du système de fichiers source, ainsi que l’autorisation de Lecture pour les fichiers à lire. Vous pouvez également accorder au moins le rôle Lecteur des données Blob du stockage avec RBAC. Pour plus d’informations, consultez cet article.