Propriétés personnalisées des destinations
Les objets de flux de données dans les modèles d'objet MicrosoftSQL ServerIntegration Services disposent de propriétés communes et de propriétés personnalisées au niveau du composant, des entrées et des sorties, ainsi que des colonnes d'entrée et de sortie. Les propriétés personnalisées sont uniquement disponibles au moment de l'exécution et ne sont pas documentées dans la documentation de référence de la programmation managée de Integration Services.
Cette rubrique répertorie et décrit les propriétés personnalisées des destinations du flux de données.
Destination ADO NET
Destination d'apprentissage du modèle d'exploration de données
Destination DataReader
Destination de traitement de dimension
Destination Excel
Destination de fichier plat
Destination OLE DB
Destination de traitement de partition
Destination de fichier brut
Destination du jeu d'enregistrements
Destination SQL Server Compact Edition
Destination SQL Server
Pour plus d'informations sur les propriétés communes à la plupart des objets de flux de données, consultez Propriétés communes.
Certaines propriétés des destinations peuvent être définies au moyen d'expressions de propriété, tel qu'indiqué dans cette rubrique. Pour plus d'informations, consultez Propriétés du flux de données pouvant être définies à l'aide d'expressions.
Destination ADO NET
La destination ADO.NET dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination ADO.NET. Toutes les propriétés sont en lecture/écriture. Ces propriétés ne sont pas disponibles dans l'Éditeur de destination ADO NET mais peuvent être définies à l'aide de l'éditeur avancé.
Propriété |
Type de données |
Description |
|---|---|---|
BatchSize |
Entier |
Nombre de lignes d'un lot envoyé au serveur. Une valeur égale à 0 indique que la taille du lot correspond à la taille du tampon interne. La valeur par défaut de cette propriété est 0. |
CommandTimeOut |
Integer |
Nombre maximal de secondes pendant lesquelles la commande SQL peut être exécutée avant d'arriver à expiration. Une valeur égale à 0 indique une durée illimitée. La valeur par défaut de cette propriété est 0. |
TableOrViewName |
String |
Nom de la table ou vue de destination. |
Pour plus d'informations, consultez Destination ADO NET.
Destination d'apprentissage du modèle d'exploration de données, propriétés personnalisées
La destination d'apprentissage du modèle d'exploration de données dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination d'apprentissage du modèle d'exploration de données. Toutes les propriétés sont en lecture/écriture.
Propriété |
Type de données |
Description |
|---|---|---|
ASConnectionId |
String |
Identificateur unique du gestionnaire de connexions. |
ASConnectionString |
String |
Chaîne de connexion d'une instance de Analysis Services ou d'un projet Analysis Services. |
ObjectRef |
String |
Balise XML qui identifie la structure d'exploration de données utilisée par la transformation. |
L'entrée et les colonnes d'entrée de la destination d'apprentissage du modèle d'exploration de données ne sont pas dotées de propriétés personnalisées.
Pour plus d'informations, consultez Destination d'apprentissage du modèle d'exploration de données.
Destination DataReader, propriétés personnalisées
La destination DataReader dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination DataReader. Toutes les propriétés à l'exception de DataReader sont en lecture/écriture.
Nom de la propriété |
Type de données |
Description |
|---|---|---|
DataReader |
String |
Nom de classe de la destination DataReader. |
FailOnTimeout |
Boolean |
Indique s'il faut faire échouer l'opération ou non lorsqu'un ReadTimeout se produit. La valeur par défaut de cette propriété est False. |
ReadTimeout |
Integer |
Nombre de millisecondes devant s'écouler avant l'expiration du délai d'attente. La valeur par défaut de cette propriété est 30000 (30 secondes). |
L'entrée et les colonnes d'entrée de la destination DataReader ne sont pas dotées de propriétés personnalisées.
Pour plus d'informations, consultez Destination DataReader.
Destination de traitement de dimension, propriétés personnalisées
La destination de traitement de dimension dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination de traitement de dimension. Toutes les propriétés sont en lecture/écriture.
Propriété |
Type de données |
Description |
|---|---|---|
ASConnectionString |
String |
Chaîne de connexion d'une instance de Analysis Services ou d'un projet Analysis Services. |
KeyDuplicate |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer des erreurs de clé dupliquée. Les valeurs possibles sont IgnoreError (0), ReportAndContinue (1) et ReportAndStop (2). La valeur par défaut de cette propriété est IgnoreError (0). |
KeyErrorAction |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer une erreur de clé. Les valeurs possibles sont ConvertToUnknown (0) et DiscardRecord (1). La valeur par défaut de cette propriété est ConvertToUnknown (0). |
KeyErrorLimit |
Integer |
Lorsque UseDefaultConfiguration a la valeur False, limite supérieure des erreurs de clé activées. |
KeyErrorLimitAction |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique l'action à entreprendre lorsque KeyErrorLimit est atteint. Les valeurs possibles sont StopLogging (1) et StopProcessing (0). La valeur par défaut de cette propriété est StopProcessing (0). |
KeyErrorLogFile |
String |
Lorsque UseDefaultConfiguration a la valeur False, chemin d'accès et nom du fichier journal des erreurs. |
KeyNotFound |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer des erreurs de clé manquante. Les valeurs possibles sont IgnoreError (0), ReportAndContinue (1) et ReportAndStop (2). La valeur par défaut de cette propriété est IgnoreError (0). |
NullKeyConvertedToUnknown |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer des clés NULL converties en valeur inconnue. Les valeurs possibles sont IgnoreError (0), ReportAndContinue (1) et ReportAndStop (2). La valeur par défaut de cette propriété est IgnoreError (0). |
NullKeyNotAllowed |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer des valeurs NULL non autorisées. Les valeurs possibles sont IgnoreError (0), ReportAndContinue (1) et ReportAndStop (2). La valeur par défaut de cette propriété est IgnoreError (0). |
ProcessType |
Integer (énumération) |
Type de traitement de dimension que la transformation utilise. Les valeurs possibles sont ProcessAdd (1) (incrémentiel), ProcessFull (0) et ProcessUpdate (2). |
UseDefaultConfiguration |
Boolean |
Valeur qui spécifie si la transformation utilise la configuration d'erreur par défaut. Si cette propriété a la valeur False, la transformation inclut des informations sur le traitement des erreurs. |
L'entrée et les colonnes d'entrée de la destination de traitement de dimension ne disposent pas de propriétés personnalisées.
Pour plus d'informations, consultez Destination de traitement de dimension.
Destination Excel, propriétés personnalisées
La destination Excel dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination Excel. Toutes les propriétés sont en lecture/écriture.
Nom de la propriété |
Type de données |
Description |
|---|---|---|
AccessMode |
Integer (énumération) |
Valeur qui spécifie la manière dont la destination accède à sa base de données de destination. Cette propriété peut prendre les valeurs suivantes :
|
CommandTimeout |
Integer |
Nombre maximal de secondes pendant lesquelles la commande SQL peut être exécutée avant d'arriver à expiration. Une valeur égale à 0 indique une durée illimitée. La valeur par défaut de cette propriété est 0. .gif "Remarque") Remarque
Cette propriété n'est pas disponible dans l'Éditeur de destination Excel mais peut être définie à l'aide de l'éditeur avancé.
|
FastLoadKeepIdentity |
Boolean |
Valeur spécifiant si les valeurs d'identité doivent être copiées lors du chargement des données. Cette propriété est disponible uniquement lorsque vous utilisez l'une des options de chargement rapide. La valeur par défaut de cette propriété est False. |
FastLoadKeepNulls |
Boolean |
Valeur spécifiant si les valeurs NULL doivent être copiées lors du chargement des données. Cette propriété est disponible uniquement avec l'une des options de chargement rapide. La valeur par défaut de cette propriété est False. |
FastLoadMaxInsertCommitSize |
Integer |
Valeur qui spécifie la taille du lot que la destination Excel tente de valider au cours des opérations de chargement rapide. La valeur par défaut (0) indique une opération de validation simple après le traitement de toutes les lignes. |
FastLoadOptions |
String |
Collection d'options de chargement rapide. Les options de chargement rapide incluent le verrouillage des tables et la vérification des contraintes. Vous pouvez spécifier une de ces options, les deux ou ni l'une ni l'autre. Remarque
Certaines options de cette propriété ne sont pas disponibles dans l'Éditeur de destination Excel mais peuvent être définies à l'aide de l'éditeur avancé.
|
OpenRowset |
String |
Lorsque AccessMode est défini sur OpenRowset, nom de la table ou de la vue à laquelle la destination Excel a accès. |
OpenRowsetVariable |
String |
Lorsque AccessMode est défini sur OpenRowset à partir de Variable, nom de la variable contenant le nom de la table ou de la vue à laquelle la destination Excel a accès. |
SqlCommand |
String |
Lorsque AccessMode est défini sur Commande SQL, instruction Transact-SQL que la destination Excel utilise pour spécifier les colonnes de destination pour les données. |
L'entrée et les colonnes d'entrée de la destination Excel ne sont pas dotées de propriétés personnalisées.
Pour plus d'informations, consultez Destination Excel.
Destination de fichier plat, propriétés personnalisées
La destination de fichier plat dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination de fichier plat. Toutes les propriétés sont en lecture/écriture.
Nom de la propriété |
Type de données |
Description |
|---|---|---|
Header |
String |
Bloc de texte inséré dans le fichier avant l'écriture des données. Il est possible de spécifier la valeur de cette propriété à l'aide d'une expression de propriété. |
Overwrite |
Boolean |
Valeur qui spécifie s'il faut remplacer un fichier de destination existant qui porte le même nom ou lui ajouter des données. La valeur par défaut de cette propriété est True. |
L'entrée et les colonnes d'entrée de la destination de fichier plat ne sont pas dotées de propriétés personnalisées.
Pour plus d'informations, consultez Destination de fichier plat.
Destination OLE DB, propriétés personnalisées
La destination OLE DB dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination OLE DB. Toutes les propriétés sont en lecture/écriture.
[!REMARQUE]
Les options FastLoad répertoriées ici (FastLoadKeepIdentity, FastLoadKeepNulls et FastLoadOptions) correspondent aux propriétés qui portent des noms similaires et sont présentées dans l'interface IRowsetFastLoad implémentée par le fournisseur Microsoft OLE DB pour SQL Server (SQLOLEDB). Pour plus d'informations, effectuez une recherche sur IRowsetFastLoad dans MSDN Library.
Nom de la propriété |
Type de données |
Description |
|---|---|---|
AccessMode |
Integer (énumération) |
Valeur qui spécifie la manière dont la destination accède à sa base de données de destination. Cette propriété peut prendre les valeurs suivantes :
|
AlwaysUseDefaultCodePage |
Boolean |
Valeur qui indique s'il faut utiliser la valeur de la propriété DefaultCodePage pour chaque colonne ou tenter de dériver la page de codes à partir des paramètres régionaux de chaque colonne. La valeur par défaut de cette propriété est False. |
CommandTimeout |
Integer |
Nombre maximal de secondes pendant lesquelles la commande SQL peut être exécutée avant d'arriver à expiration. Une valeur égale à 0 indique une durée illimitée. La valeur par défaut de cette propriété est 0. Remarque
Cette propriété n'est pas disponible dans l'Éditeur de destination OLE DB mais peut être définie à l'aide de l'éditeur avancé.
|
DefaultCodePage |
Integer |
Page de codes par défaut associée à la destination OLE DB. |
FastLoadKeepIdentity |
Boolean |
Valeur spécifiant si les valeurs d'identité doivent être copiées lors du chargement des données. Cette propriété est disponible uniquement avec l'une des options de chargement rapide. La valeur par défaut de cette propriété est False. Cette propriété correspond à la propriété OLE DB IRowsetFastLoad (OLE DB)SSPROP_FASTLOADKEEPIDENTITY. |
FastLoadKeepNulls |
Boolean |
Valeur spécifiant si les valeurs NULL doivent être copiées lors du chargement des données. Cette propriété est disponible uniquement avec l'une des options de chargement rapide. La valeur par défaut de cette propriété est False. Cette propriété correspond à la propriété OLE DB IRowsetFastLoad (OLE DB)SSPROP_FASTLOADKEEPNULLS. |
FastLoadMaxInsertCommitSize |
Integer |
Valeur qui spécifie la taille du lot que la destination OLE DB tente de valider au cours des opérations de chargement rapide. La valeur par défaut (0) indique une opération de validation simple après le traitement de toutes les lignes. |
FastLoadOptions |
String |
Collection d'options de chargement rapide. Les options de chargement rapide incluent le verrouillage des tables et la vérification des contraintes. Vous pouvez spécifier une de ces options, les deux ou ni l'une ni l'autre. Cette propriété correspond à la propriété OLE DB IRowsetFastLoadSSPROP_FASTLOADOPTIONS et accepte des options de chaîne, telles que CHECK_CONSTRAINTS et TABLOCK. Remarque
Certaines options de cette propriété ne sont pas disponibles dans l'Éditeur de destination Excel mais peuvent être définies à l'aide de l'éditeur avancé.
|
OpenRowset |
String |
Lorsque AccessMode est défini sur OpenRowset, nom de la table ou de la vue à laquelle la destination OLE DB a accès. |
OpenRowsetVariable |
String |
Lorsque AccessMode est défini sur OpenRowset à partir de Variable, nom de la variable contenant le nom de la table ou de la vue à laquelle la destination OLE DB a accès. |
SqlCommand |
String |
Lorsque AccessMode est défini sur Commande SQL, instruction Transact-SQL que la destination OLE DB utilise pour spécifier les colonnes de destination pour les données. |
L'entrée et les colonnes d'entrée de la destination OLE DB ne sont pas dotées de propriétés personnalisées.
Pour plus d'informations, consultez Destination OLE DB.
Destination de traitement de partition, propriétés personnalisées
La destination de traitement de partition dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination de traitement de partition. Toutes les propriétés sont en lecture/écriture.
Propriété |
Type de données |
Description |
|---|---|---|
ASConnectionString |
String |
Chaîne de connexion d'un projet Analysis Services ou d'une instance de Analysis Services. |
KeyDuplicate |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer des erreurs de clé dupliquée. Les valeurs possibles sont IgnoreError (0), ReportAndContinue (1) et ReportAndStop (2). La valeur par défaut de cette propriété est IgnoreError (0). |
KeyErrorAction |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer les erreurs de clé. Les valeurs possibles sont ConvertToUnknown (0) et DiscardRecord (1). La valeur par défaut de cette propriété est ConvertToUnknown (0). |
KeyErrorLimit |
Integer |
Lorsque UseDefaultConfiguration a la valeur False, limite supérieure des erreurs de clé autorisées. |
KeyErrorLimitAction |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique l'action à entreprendre lorsque KeyErrorLimit est atteint. Les valeurs possibles sont StopLogging (1) et StopProcessing (0). La valeur par défaut de cette propriété est StopProcessing (0). |
KeyErrorLogFile |
String |
Lorsque UseDefaultConfiguration a la valeur False, chemin d'accès et nom du fichier journal des erreurs. |
KeyNotFound |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer des erreurs de clé manquante. Les valeurs possibles sont IgnoreError (0), ReportAndContinue (1) et ReportAndStop (2). La valeur par défaut de cette propriété est ReportAndContinue (1). |
NullKeyConvertedToUnknown |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer des clés NULL converties en valeur inconnue. Les valeurs possibles sont IgnoreError (0), ReportAndContinue (1) et ReportAndStop (2). La valeur par défaut de cette propriété est IgnoreError (0). |
NullKeyNotAllowed |
Integer (énumération) |
Lorsque UseDefaultConfiguration a la valeur False, valeur qui indique comment gérer des valeurs NULL non autorisées. Les valeurs possibles sont IgnoreError (0), ReportAndContinue (1) et ReportAndStop (2). La valeur par défaut de cette propriété est ReportAndContinue (1). |
ProcessType |
Integer (énumération) |
Type de traitement de partition que la transformation utilise. Les valeurs possibles sont ProcessAdd (1) (incrémentiel), ProcessFull (0) et ProcessUpdate (2). |
UseDefaultConfiguration |
Boolean |
Valeur qui spécifie si la transformation utilise la configuration d'erreur par défaut. Si cette propriété a la valeur False, la transformation utilise les propriétés personnalisées de traitement des erreurs répertoriées dans ce tableau, y compris KeyDuplicate, KeyErrorAction, et ainsi de suite. |
L'entrée et les colonnes d'entrée de la destination de traitement de partition ne disposent pas de propriétés personnalisées.
Pour plus d'informations, consultez Destination de traitement de partition.
Destination de fichier brut, propriétés personnalisées
La destination de fichier brut dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination de fichier brut. Toutes les propriétés sont en lecture/écriture.
Nom de la propriété |
Type de données |
Description |
|---|---|---|
AccessMode |
Integer (énumération) |
Valeur qui spécifie si la propriété FileName contient un nom de fichier ou le nom d'une variable contenant un nom de fichier. Les options disponibles sont File name (0) et File name from variable (1). |
FileName |
String |
Nom du fichier dans lequel la destination de fichier brut écrit. |
WriteOption |
Integer (énumération) |
Valeur qui spécifie si la destination de fichier brut supprime un fichier existant qui porte le même nom. Les options disponibles sont Create Always (0), Create Once (1), Truncate and Append (3) et Append (2). La valeur par défaut de cette propriété est Create Always (0). |
[!REMARQUE]
Une opération d'ajout exige que les métadonnées des données ajoutées correspondent à celles des données déjà présentes dans le fichier.
L'entrée et les colonnes d'entrée de la destination de fichier brut ne sont pas dotées de propriétés personnalisées.
Pour plus d'informations, consultez Destination de fichier brut.
Destination du jeu d'enregistrements, propriétés personnalisées
La destination du jeu d'enregistrements dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination du jeu d'enregistrements. Toutes les propriétés sont en lecture/écriture.
Nom de la propriété |
Type de données |
Description |
|---|---|---|
VariableName |
String |
Nom de la variable qui contient le jeu d'enregistrements ADO. |
L'entrée et les colonnes d'entrée de la destination du jeu d'enregistrements ne sont pas dotées de propriétés personnalisées.
Pour plus d'informations, consultez Destination de l'ensemble d'enregistrements.
Destination SQL Server Compact Edition, propriétés personnalisées
La destination SQL Server Compact dispose à la fois de propriétés personnalisées et des propriétés communes à tous les composants de flux de données.
Le tableau ci-dessous décrit les propriétés personnalisées de la destination SQL Server Compact. Toutes les propriétés sont en lecture/écriture.
Nom de la propriété |
Type de données |
Description |
|---|---|---|
TableName |
String |
Nom de la table de destination dans une base de données SQL Server Compact. Il est possible de spécifier la valeur de cette propriété à l'aide d'une expression de propriété. |
L'entrée et les colonnes d'entrée de la destination SQL Server Compact n'ont pas de propriétés personnalisées.
Pour plus d'informations, consultez Destination SQL Server Compact Edition.
Destination SQL Server, propriétés personnalisées
La destination SQL Server dispose à la fois de propriétés personnalisées et de propriétés communes à tous les composants de flux de données.
Le tableau suivant décrit les propriétés personnalisées de la destination SQL Server. Toutes les propriétés sont en lecture/écriture.
Nom de la propriété |
Type de données |
Description |
|---|---|---|
AlwaysUseDefaultCodePage |
Boolean |
Impose l'utilisation de la propriété DefaultCodePage. La valeur par défaut de cette propriété est False. |
BulkInsertCheckConstraints |
Boolean |
Valeur qui spécifie si l'insertion en bloc vérifie les contraintes. La valeur par défaut de cette propriété est True. |
BulkInsertFireTriggers |
Boolean |
Valeur qui spécifie si l'insertion en bloc exécute des déclencheurs dans les tables. La valeur par défaut de cette propriété est False. |
BulkInsertFirstRow |
Integer |
Valeur qui spécifie la première ligne à insérer. La valeur par défaut de cette propriété est -1, ce qui signifie qu'aucune valeur n'a été attribuée. |
BulkInsertKeepIdentity |
Boolean |
Valeur qui spécifie si les valeurs peuvent être insérées dans des colonnes d'identité. La valeur par défaut de cette propriété est False. |
BulkInsertKeepNulls |
Boolean |
Valeur qui spécifie si l'insertion en bloc conserve les valeurs NULL. La valeur par défaut de cette propriété est False. |
BulkInsertLastRow |
Integer |
Valeur qui spécifie la dernière ligne à insérer. La valeur par défaut de cette propriété est -1, ce qui signifie qu'aucune valeur n'a été attribuée. |
BulkInsertMaxErrors |
Integer |
Valeur qui spécifie le nombre d'erreurs au-delà duquel l'insertion en bloc s'arrête. La valeur par défaut de cette propriété est -1, ce qui signifie qu'aucune valeur n'a été attribuée. |
BulkInsertOrder |
String |
Noms des colonnes de tri. Chaque colonne peut être triée par ordre croissant ou décroissant. En cas d'utilisation de plusieurs colonnes de tri, les noms des colonnes sont séparés par des virgules. |
BulkInsertTableName |
String |
Table ou vue SQL Server dans la base de données dans laquelle les données sont copiées. |
BulkInsertTablock |
Boolean |
Valeur qui spécifie si la table est verrouillée lors de l'insertion en bloc. La valeur par défaut de cette propriété est True. |
DefaultCodePage |
Integer |
Page de codes à utiliser lorsque les informations de page de codes ne sont pas disponibles à partir de la source de données. |
MaxInsertCommitSize |
Integer |
Valeur qui spécifie le nombre maximal de lignes à insérer dans un lot. Lorsque la valeur est nulle, toutes les lignes sont insérées dans un lot unique. |
Timeout |
Integer |
Valeur qui spécifie le nombre de secondes pendant lesquelles la destination SQL Server patiente avant de s'arrêter si aucune donnée disponible ne peut être insérée. Une valeur égale à 0 signifie que la destination SQL Server n'expirera pas. La valeur par défaut de cette propriété est 30. |
L'entrée et les colonnes d'entrée de la destination SQL Server ne disposent pas de propriétés personnalisées.
Pour plus d'informations, consultez Destination SQL Server.
Historique des modifications
Mise à jour du contenu |
|---|
|