Propriétés du tSybaseIQBulkExec Standard

Ces propriétés sont utilisées pour configurer le tSybaseIQBulkExec s'exécutant dans le framework de Jobs Standard.

Le composant tSybaseIQBulkExec Standard appartient à la famille Databases.

Le composant de ce framework est disponible dans tous les produits Talend.

Basic settings

Property Type	Peut être Built-In ou Repository. Built-In : propriétés utilisées ponctuellement. Repository : sélectionnez le fichier dans lequel sont stockées les propriétés du composant. Les champs suivants sont alors pré-remplis à l'aide des données collectées.
Use an existing connection	Cochez cette case et sélectionnez le composant de connexion adéquat dans la liste Component list pour réutiliser les paramètres d'une connexion que vous avez déjà définie. Remarque : Notez que lorsqu'un Job contient un Job parent et un Job enfant, si vous devez partager une connexion existante entre ces deux niveaux, par exemple pour partager la connexion créée par le Job père au Job fils, vous devez : au niveau du Job père, enregistrer la connexion à la base de données à partager dans la vue Basic settings du composant de connexion créant cette connexion à la base de données. au niveau du Job fils, utiliser un composant de connexion dédié afin de lire cette connexion enregistrée. Pour un exemple de partage d'une connexion à une base de données à travers différents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend . Cette propriété est disponible uniquement lorsque l'option `Sybase IQ 12/15 by JDBC` ou `Sybase IQ 16 by JDBC` est sélectionnée dans la liste déroulante DB Version and API type.
DB Version and API type	Sélectionnez la version de la base de données Sybase IQ à utiliser et l'API utilisée pour définir la connexion à la base de données. Les valeurs valides sont `Sybase IQ 12/15 by JDBC`, `Sybase IQ 15 by ODBC` et `Sybase IQ 16 by JDBC`. Notez que pour Sybase IQ 12 et Sybase IQ 16, le fichier à être chargé en masse doit être situé sur la même machine que le serveur Sybase IQ. Pour Sybase IQ 15, le fichier à être chargé en masse doit être situé sur une machine distante, toutefois, cela requiert une configuration spécifique du serveur Sybase IQ. Pour plus d'informations, consultez Sybase IQ client-side load support enhancements (en anglais).
Host	Saisissez l'adresse IP du serveur Sybase IQ. Cette propriété est disponible uniquement lorsque l'option `Sybase IQ 12/15 by JDBC` ou `Sybase IQ 16 by JDBC` est sélectionnée dans la liste déroulante DB Version and API type.
Port	Saisissez le numéro du port d'écoute du serveur Sybase IQ. Cette propriété est disponible uniquement lorsque l'option `Sybase IQ 12/15 by JDBC` ou `Sybase IQ 16 by JDBC` est sélectionnée dans la liste déroulante DB Version and API type.
Data Source	Sélectionnez le type de la source de données à utiliser et complétez les informations DNS correspondantes dans le champ affiché à côté. Les types disponibles sont `DSN` et `FILEDSN`. Lorsque l'option `FILEDSN` est sélectionnée, un bouton [...] est disponible à côté du champ Data Source pour permettre de parcourir le système jusqu'au fichier source de données souhaité. Cette propriété est disponible uniquement lorsque l'option `Sybase IQ 15 by ODBC` est sélectionnée dans la liste déroulante DB Version and API type.
Database	Saisissez le nom de la base de données.
Username et Password	Saisissez les informations d'authentification de l'utilisateur de base de données. Pour saisir le mot de passe, cliquez sur le bouton [...] à côté du champ Password, puis, dans la boîte de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles et cliquez sur OK afin de sauvegarder les paramètres.
Table	Saisissez le nom de la table à écrire. Notez qu'une seule table peut être écrite à la fois et la table doit déjà exister pour que l'opération d'Insert soit autorisée.
Action on table	Vous pouvez effectuer l'une des opérations suivantes sur les données de la table sélectionnée : Default : n'effectuer aucune opération sur la table. Drop and create table : supprimer la table puis en créer une nouvelle. Create table : créer une table qui n'existe pas encore. Create table if does not exist : créer la table si elle n'existe pas encore. Drop table if exists and create : supprimer la table si elle existe déjà, puis en créer une nouvelle. Clear table : supprimer le contenu de la table. Truncate table : supprimer le contenu de la table, mais sans possibilité de Rollback.
Local filename	Spécifiez le chemin du fichier à charger.
Schema et Edit schema	Un schéma est une description de lignes, il définit le nombre de champs qui sont traités et passés au composant suivant. Le schéma est soit Built-In soit distant dans le Repository. Modifiez le schéma en cliquant sur Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles : View schema : sélectionnez cette option afin de voir uniquement le schéma. Change to built-in property : sélectionnez cette option pour passer le schéma en mode Built-In et effectuer des modifications locales. Update repository connection : sélectionnez cette option afin de modifier le schéma stocké dans le référentiel et décider de propager ou non les modifications à tous les Jobs. Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur No et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre [Repository Content].
	Built-in : le schéma est créé et conservé localement pour ce composant seulement.
	Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Jobs et projets.
Use Insert-Location	Cochez cette case et spécifiez la table de la base de données source de laquelle importer les données dans la table Sybase IQ.
Server	Saisissez le nom du serveur stockant les données à importer. Ce champ est disponible uniquement lorsque la case Use Insert-Location est cochée.
Database	Saisissez le nom de la base de données stockant les données à importer. Ce champ est disponible uniquement lorsque la case Use Insert-Location est cochée.
Schema	Saisissez le nom du schéma source. Ce champ est disponible uniquement lorsque la case Use Insert-Location est cochée.
Table	Saisissez le nom de la table source. Ce champ est disponible uniquement lorsque la case Use Insert-Location est cochée.
Use Source Filter	Cochez cette case et spécifiez le filtre de lignes sur la table source. Ce champ est disponible uniquement lorsque la case Use Insert-Location est cochée.
Where Clause	Saisissez la clause WHERE pour filtrer les lignes à importer dans la table Sybase IQ. Ce champ est disponible uniquement lorsque la case Use Source Filter est cochée.
Columns Mapping	Renseignez cette table pour spécifier la relation de mapping entre les colonnes de la table source et les colonnes de la table Sybase IQ. Column : nom de la colonne de la table Sybase IQ. Par défaut, les champs de la colonne Column sont les mêmes que dans le schéma. Columns in Source Table : nom de la colonne correspondante dans la table duquel les données seront importées. Cette table est disponible lorsque la case Use Insert-Location est cochée.

Advanced settings

Lines terminated by	Saisissez le caractère, la chaîne ou l'expression régulière séparant les lignes. Ce champ est indisponible lorsque la case Use Insert-Location est cochée.
Field terminated by	Saisissez le caractère, le chaîne ou l'expression régulière séparant les champs. Remarque : Ce composant permet l'utilisation de séparateurs de champs/lignes orientés Sybase, comme \x09. Ce champ est indisponible lorsque la case Use Insert-Location est cochée.
Use enclosed quotes	Cochez cette case pour utiliser des caractères pour entourer les données. Ce champ est indisponible lorsque la case Use Insert-Location est cochée.
Use fixed length	Cochez cette case pour déterminer une longueur fixe pour les lignes de données. Ce champ est indisponible lorsque la case Use Insert-Location est cochée.
Include Header	Cochez cette case si le fichier à charger contient un en-tête. Ce champ est indisponible lorsque la case Use Insert-Location est cochée.
Blank as null	Cochez cette case pour stocker les Varchar d'entrée de longueur zéro comme NULL, au lieu de blancs dans la base de données durant l'opération de chargement. Cette case n'est pas disponible lorsque la case Use Insert-Location ou Use fixed length est cochée.
Location Options	Cochez cette case pour afficher les options relatives à l'emplacement. Pour plus d'informations concernant ces options, consultez http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc00801.1510/html/iqrefso/X315746.htm. Cette case est disponible uniquement lorsque la case Use Insert-Location est cochée.
Encrypted Password	Cochez cette case afin de spécifier l'utilisation du cryptage par défaut du mot de passe de la bibliothèque Open Client Library lors de la connexion au serveur source distant. Cette case est disponible uniquement lorsque la case Location Options est cochée.
Use TDS Packet Size	Cochez cette case et, dans le champ Packet Size qui s'affiche, spécifiez la taille des paquets TDS en octets. Cette case est disponible uniquement lorsque la case Location Options est cochée.
Quoted Identifier	Cochez cette case et, dans la liste déroulante Status affichée, spécifiez le paramètre de l'option QUOTED_IDENTIFIER sur le serveur distant. Cette case est disponible uniquement lorsque la case Location Options est cochée.
Set Isolation Level	Cochez cette case et, dans la liste Isolation Level qui s'affiche, sélectionnez le niveau d'isolation de la connexion au serveur distant. Cette case est disponible uniquement lorsque la case Location Options est cochée.
Insert Load Options	Cochez cette case pour afficher les options d'insertion et de chargement. Pour plus d'informations concernant les options de chargement et d'insertion, consultez http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc00801.1510/html/iqrefso/X315746.htm (en anglais). Cette case est disponible uniquement lorsque la case Use Insert-Location est cochée.
Limit Number	Spécifiez le nombre maximal de lignes à insérer dans la table Sybase IQ. Ce champ est disponible uniquement lorsque la case Insert Load Options est cochée.
Notify Number	Configurez les notifications pour être averti via un message à chaque fois que le nombre de lignes est inséré dans la table Sybase IQ. Ce champ est disponible uniquement lorsque la case Insert Load Options est cochée.
Skip Number	Spécifiez le nombre de lignes à ignorer au début de la table source. Ce champ est disponible uniquement lorsque la case Insert Load Options est cochée.
Start Row ID	Spécifiez l'ID de la ligne de la table Sybase IQ à laquelle commencer l'insertion. Remarque : Notez que Sybase IQ 16 ne supporte pas ce paramètre. Ce champ est disponible uniquement lorsque la case Insert Load Options est cochée.
Insert Select Load Options	Cochez cette case pour afficher les options d'insertion, sélection et chargement. Pour plus d'informations concernant ces options, consultez http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc00801.1510/html/iqrefso/X315750.htm (en anglais). Cette case est disponible uniquement lorsque la case Use Insert-Location est cochée.
Word Skip Number	Saisissez combien de fois l'erreur Words exceeding the maximum permitted word length not supported doit être ignorée lors du chargement des données dans la table Sybase IQ. Ce champ est disponible uniquement lorsque la case Insert Load Options est cochée.
Ignore Constraint	Cochez cette case et, dans la table qui s'affiche, spécifiez la violation de contrainte d'intégrité à ignorer lors du chargement des données dans la table Sybase IQ, en cliquant sur le bouton [+] pour ajouter autant de lignes que nécessaire, chaque ligne pour une violation de contrainte et configurez la valeur des colonnes suivantes pour chaque violation de contrainte : Constraint Type : cliquez dans la cellule et, dans la liste déroulante, sélectionnez le type de violation de contrainte à ignorer. Number : saisissez le nombre maximal de violations de contraintes à ignorer avant d'initialiser un Rollback durant un chargement. Cette case est disponible uniquement lorsque la case Insert Select Load Options est cochée.
Log In File	Cochez cette case si vous souhaitez enregistrer les informations relatives à la violation de contrainte dans des fichiers. Cette case est disponible uniquement lorsque la case Insert Select Load Options est cochée.
Message Log	Spécifiez le chemin d'accès au fichier MESSAGE LOG. Ce champ est disponible uniquement lorsque la case Log In File est cochée.
Row Log	Spécifiez le chemin d'accès au fichier ROW LOG. Ce champ est disponible uniquement lorsque la case Log In File est cochée.
Log Delimited By	Spécifiez le séparateur des valeurs de données dans le fichier ROW LOG. Ce champ est disponible uniquement lorsque la case Log In File est cochée.
Log Filter	Cochez cette case et, dans la liste Only Log qui s'affiche, sélectionnez le type d'informations relatif aux violations de contraintes à enregistrer. Cette case est disponible uniquement lorsque la case Log In File est cochée.
tStatCatcher Statistics	Cochez cette case pour collecter les données de log au niveau du composant.

Utilisation

Règle d'utilisation	Ce composant offre la flexibilité des requêtes sur les bases de données Sybase IQ.
Dynamic settings	Cliquez sur le bouton [+] pour ajouter une ligne à la table. Dans le champ Code, saisissez une variable de contexte afin de sélectionner dynamiquement votre connexion à la base de données parmi celles prévues dans votre Job. Cette fonctionnalité est utile si vous devez accéder à plusieurs tables de bases de données ayant la même structure mais se trouvant dans différentes bases de données, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramètres de votre Job, par exemple lorsque votre Job doit être déployé et exécuté dans un Studio Talend. La table Dynamic settings est disponible uniquement lorsque la case Use an existing connection est cochée dans la vue Basic settings. Lorsqu'un paramètre dynamique est configuré, la liste Component List de la vue Basic settings devient inutilisable. Pour des exemples relatifs à l'utilisation des paramètres dynamiques, consultez Lire des données dans des bases de données à l'aide de connexions dynamiques basées sur les variables de contexte et Lire des données à partir de différentes bases de données MySQL à l'aide de paramètres de connexion chargés dynamiquement. Pour plus d'informations concernant les paramètres dynamiques et les variables de contexte, consultez le Guide utilisateur du Studio Talend.

Règle d'utilisation

Ce composant offre la flexibilité des requêtes sur les bases de données Sybase IQ.

Dynamic settings

Cliquez sur le bouton [+] pour ajouter une ligne à la table. Dans le champ Code, saisissez une variable de contexte afin de sélectionner dynamiquement votre connexion à la base de données parmi celles prévues dans votre Job. Cette fonctionnalité est utile si vous devez accéder à plusieurs tables de bases de données ayant la même structure mais se trouvant dans différentes bases de données, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramètres de votre Job, par exemple lorsque votre Job doit être déployé et exécuté dans un Studio Talend.

La table Dynamic settings est disponible uniquement lorsque la case Use an existing connection est cochée dans la vue Basic settings. Lorsqu'un paramètre dynamique est configuré, la liste Component List de la vue Basic settings devient inutilisable.

Pour des exemples relatifs à l'utilisation des paramètres dynamiques, consultez Lire des données dans des bases de données à l'aide de connexions dynamiques basées sur les variables de contexte et Lire des données à partir de différentes bases de données MySQL à l'aide de paramètres de connexion chargés dynamiquement. Pour plus d'informations concernant les paramètres dynamiques et les variables de contexte, consultez le Guide utilisateur du Studio Talend.