Propriétés du tSybaseIQBulkExec Standard - 7.1

Sybase

author
Talend Documentation Team
EnrichVersion
7.1
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
task
Création et développement > Systèmes tiers > Composants Database > Composants Sybase
Gouvernance de données > Systèmes tiers > Composants Database > Composants Sybase
Qualité et préparation de données > Systèmes tiers > Composants Database > Composants Sybase
EnrichPlatform
Studio Talend

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.

Remarque : Ce composant est une version spécifique d'un connecteur à une base de données dynamique. Les propriétés associées aux paramètres de la base de données dépendent du type de base de données sélectionné. Pour plus d'informations concernant les connecteurs aux bases de données, consultez Utiliser des composants de bases de données dynamiques.

Basic settings

Database

Sélectionnez un type de base de données dans la liste et cliquez sur Apply.

Property Type

Sélectionnez la manière de configurer les informations de connexion.

  • Built-In : les paramètres de connexion seront définis localement pour ce composant. Vous devez spécifier manuellement les valeurs pour toutes les propriétés de connexion.

  • Repository : les paramètres de connexion stockés centralement dans le Repository > Metadata seront réutilisés par ce composant. Vous devez cliquer sur le bouton [...] et, dans la boîte de dialogue Repository Content, sélectionnez les détails de connexion à réutiliser. Toutes les propriétés de connexion seront automatiquement renseigné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.

Lorsque vous réutilisez une connexion à Sybase 16 (SQL Anywhere) existante, créée par un composant tSybaseConnection et chargeant des données depuis un fichier situé côté client, vous devez sélectionner Sybase 16 (SQL Anywhere) dans la liste déroulante DB Version, pour afficher la case Is client file, puis la cocher.

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 :
  1. 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.

  2. 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é n'est pas disponible lorsque l'option Sybase IQ 15 est sélectionnée dans la liste déroulante DB Version.

DB Version

Sélectionnez dans la liste déroulante la version de la base de données Sybase à utiliser.

  • Pour Sybase IQ 12 et Sybase IQ 16, le fichier à charger en masse doit être situé sur la même machine que le serveur Sybase IQ.

  • Pour Sybase IQ 15, le fichier à charger en masse peut être situé côté client, 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).

  • Pour Sybase 16 (SQL Anywhere), le fichier à charger en masse peut être situé côté serveur ou client.

    Avant de charger des données dans Sybase 16 (SQL Anywhere), SQL Anywhere 17 doit être installé. Vous pouvez le télécharger ici. Une fois l'installation terminée, vous devez vérifier la variable système Path afin de vous assurer que le chemin d'installation de SQL Anywhere 17 a bien été ajouté. Redémarrez le Studio (voire l'ordinateur, dans certains cas) pour prendre en compte la nouvelle variable Path.

Host

Adresse IP ou le nom d'hôte de la base de données.

Cette propriété n'est pas disponible lorsque l'option Sybase IQ 15 est sélectionnée dans la liste déroulante DB Version.

Port

Numéro du port d'écoute de la base de données.

Cette propriété n'est pas disponible lorsque l'option Sybase IQ 15 est sélectionnée dans la liste déroulante DB Version.

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 est sélectionnée dans la liste déroulante DB Version.

Database

Nom de la base de données.

Sybase Schema

Schéma de la base de données.

Username et Password

Données d'authentification de l'utilisateur de la 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.

Action on table

Sur la table définie, vous pouvez effectuer l'une des opérations suivantes :

  • Default : n'effectuer aucune opération de table.

  • Drop and create table : la table est supprimée et de nouveau créée.

  • Create table : la table n'existe pas et est créée.

  • Create table if does not exist : la table est créée si elle n'existe pas.

  • Drop table if exists and create : la table est supprimée si elle existe déjà et de nouveau créée.

  • Clear table : le contenu de la table est supprimé.

  • Truncate table : le contenu de la table est supprimé. Vous ne pouvez pas annuler cette opération.

Local filename

Spécifiez le chemin du fichier à charger.

Is client file

Cochez cette case si vous souhaitez charger les données depuis le côté client.

Cette propriété est disponible uniquement lorsque l'option Sybase 16 (SQL Anywhere) est sélectionnée dans la liste déroulante DB Version.

Schema et Edit schema

Un schéma est une description de lignes. Il définit le nombre de champs (colonnes) à traiter et à passer au composant suivant. Lorsque vous créez un Job Spark, évitez le mot réservé line lors du nommage des champs.

  • Built-in : le schéma est créé et conservé localement pour ce composant seulement. scénario associé : consultez le Guide utilisateur du Studio Talend .

  • Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans divers projets et Jobs. Scénario associé : consultez le Guide utilisateur du Studio Talend .

Modifiez le schéma en cliquant sur Edit Schema. Notez que si vous effectuez des modifications, le schéma passe automatiquement en type built-in.

  • 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.

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.

Server

Saisissez le nom du serveur stockant les données à importer.

Cette propriété 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.

Cette propriété est disponible uniquement lorsque la case Use Insert-Location est cochée.

Schema

Saisissez le nom du schéma source.

Cette propriété est disponible uniquement lorsque la case Use Insert-Location est cochée.

Table

Saisissez le nom de la table source.

Cette propriété 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.

Cette propriété 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.

Cette propriété 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.

  • Column : nom de la colonne de la table Sybase. 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 de laquelle les données seront importées.

Cette propriété est disponible uniquement lorsque la case Use Insert-Location est cochée.

Advanced settings

Additional JDBC Parameters

Spécifiez des paramètres JDBC supplémentaires pour la connexion à la base de données en cours de création.

Lines terminated by

Saisissez le caractère, la chaîne ou l'expression régulière séparant les lignes.

Cette propriété est indisponible lorsque la case Use Insert-Location est cochée.

Fields terminated by

Saisissez le caractère, le chaîne ou l'expression régulière séparant les champs.

Avec des séparateurs de lignes/champs respectant la syntaxe Sybase, ce composant permet l'utilisation de caractères orientés Sybase, comme \x09.

Cette propriété est indisponible lorsque la case Use Insert-Location ou Use fixed length est cochée.

Use enclosed quotes

Cochez cette case pour utiliser des caractères pour entourer les données.

Cette propriété est indisponible lorsque la case Use Insert-Location ou Use fixed length est cochée.

Use fixed length

Cochez cette case pour déterminer une longueur fixe pour les lignes de données.

Cette propriété 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.

Cette propriété 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 propriété est indisponible lorsque la case Use Insert-Location ou Use fixed length est cochée.

On file error

Sélectionnez l'action que Sybase doit effectuer lorsqu'une erreur survient :

  • Rollback (default) : annuler la transaction en entier.

  • Finish : terminer les insertions déjà complètes et mettre fin à l'opération de chargement.

  • Continue : ignorer l'erreur et continuer l'opération de chargement.

Cette propriété est disponible uniquement lorsque l'option Sybase 16 (SQL Anywhere) est sélectionnée dans la liste déroulante DB Version.

Message log file

Chemin vers le fichier MESSAGE LOG sauvegardant les informations de log relatives aux violations des contraintes d'intégrité, aux types de violations, etc. Il doit être spécifié avec la propriété Row log file.

Cette propriété est disponible uniquement lorsque l'option Sybase 16 (SQL Anywhere) est sélectionnée dans la liste déroulante DB Version.

Row log file

Chemin vers le fichier ROW LOG sauvegardant les informations de log relatives aux données rejetées, aux horodatages de début et de complétion du chargement, etc. Il doit être spécifié avec la propriété Message log file.

Cette propriété est disponible uniquement lorsque l'option Sybase 16 (SQL Anywhere) est sélectionnée dans la liste déroulante DB Version.

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 (en anglais).

Cette propriété 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 propriété 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 propriété 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 propriété 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 propriété 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 propriété 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.

Cette propriété 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.

Cette propriété 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.

Cette propriété 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 : Sybase IQ 16 ne supporte pas ce paramètre.

Cette propriété 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 propriété 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.

Cette propriété est disponible uniquement lorsque la case Insert Select Load Option 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 propriété est disponible uniquement lorsque la case Insert Select Load Option est cochée.

Log In File

Cochez cette case si vous souhaitez enregistrer les informations relatives à la violation de contrainte dans des fichiers.

Cette propriété est disponible uniquement lorsque la case Insert Select Load Option est cochée.

Message Log

Spécifiez le chemin d'accès au fichier MESSAGE LOG.

Cette propriété 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.

Cette propriété 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.

Cette propriété 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 propriété est disponible uniquement lorsque la case Log In File est cochée.

tStatCatcher Statistics

Cochez cette case pour collecter les métadonnées de traitement du Job, aussi bien au niveau du Job qu'au niveau de chaque composant.

Utilisation

Paramètres dynamiques

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é indépendamment d'un Studio Talend.

La table Dynamic settings n'est disponible que si la case Use existing pipe 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 (Dynamic settings) et les variables de contexte, consultez le Guide utilisateur du Studio Talend.