Propriétés du tRedshiftInput Standard - Cloud

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

Le composant tRedshiftInput Standard appartient aux familles Cloud et Bases de données.

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 dynamiques de bases de données, consultez Composants génériques de bases de données.

Basic settings

Base de données	Sélectionnez le type de base de données dans la liste et cliquez sur Apply (Appliquer).
Property type	Peut-être Built-In ou Repository. Built-In : propriétés utilisées ponctuellement. Repository : sélectionnez le référentiel dans lequel sont stockées les propriétés. Les champs suivants sont automatiquement renseignés à l'aide des données récupérées.
	Cliquez sur cette icône pour ouvrir l'assistant de connexion à la base de données et stocker les paramètres de connexion configurés dans la vue Basic settings du composant. Pour plus d'informations concernant la configuration et le stockage des paramètres de connexion à la base de données, consultez Centraliser des métadonnées de base de données.
Driver version	Sélectionnez la version du pilote Redshift à utiliser : Driver v1 ou Driver v2. Remarque : Cette option est disponible uniquement si vous avez installé la mise à jour mensuelle 8.0.1-R2022-04 du Studio Talend ou une plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.
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 : 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 parent au Job enfant, procédez comme suit. au niveau du Job parent, 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 enfant, 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 Partager une connexion à une base de données.
Host	Nom de l'hôte ou adresse IP du serveur de base de données.
Port	Numéro du port d'écoute du serveur de base de données.
Database	Saisissez le nom de la base de données.
Schema	Nom du schéma.
Username et Password	Données d'authentification de l'utilisateur ou de l'utilisatrice à 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.
Use String JDBC parameters	Configurez les propriétés JDBC dans une chaîne de caractères. Si vous sélectionnez cette option, saisissez votre chaîne de caractères de paramètre JDBC dans le champ Additional JDBC Parameters. Sinon, saisissez les propriétés JDBC et leur valeur dans la table Additional JDBC Parameters. Cette option n'est pas disponible si l'option Driver v1 est sélectionnée dans la liste déroulante Driver version. Remarque : Cette option est disponible uniquement si vous avez installé la mise à jour mensuelle 8.0.1-R2022-04 du Studio Talend ou une plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.
Additional JDBC Parameters	Définissez des propriétés JDBC supplémentaires pour la connexion que vous créez. Les propriétés sont séparées par une esperluette et chaque propriété est une paire clé-valeur. Par exemple, ssl=true & sslfactory=com.amazon.redshift.ssl.NonValidatingFactory, qui signifie que la connexion sera créée en utilisant le SSL. Cette table est disponible lorsque l'option Driver v2 est sélectionnée dans la liste déroulante Driver version et que l'option Use String JDBC parameters n'est pas sélectionnée.
Additional JDBC Parameters (table)	Spécifiez les propriétés JDBC dans les lignes de la table. Pour spécifier une propriété JDBC, ajoutez une ligne à la table en cliquant sur le bouton [+], sous la table, saisissez le nom de la propriété dans la colonne Key et saisissez la valeur de la propriété dans la colonne Value. Cette table est disponible lorsque l'option Driver v2 est sélectionnée dans la liste déroulante Driver version et que l'option Use String JDBC parameters n'est pas sélectionnée. Remarque : Cette option est disponible uniquement si vous avez installé la mise à jour mensuelle 8.0.1-R2022-04 du Studio Talend ou une plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.
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. Ce composant offre la fonction de schéma dynamique. Cela vous permet de récupérer des colonnes inconnues de fichiers sources ou de copier des lots de colonnes d'une source sans avoir à mapper chaque colonne individuellement. Pour plus d'informations concernant les schémas dynamiques, consultez Schéma dynamique. Cette fonctionnalité de schéma dynamique est conçue pour permettre de récupérer des colonnes inconnues d'une table. Il est recommandé de l'utiliser uniquement à cet effet et non pour créer des tables. 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. Créez le schéma en cliquant sur le bouton 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.
Table Name	Nom de la table de base de données.
Query Type et Query	Saisissez votre requête de base de données en faisant attention à ce que l'ordre des champs corresponde à celui défini dans le schéma. Si vous utilisez la fonctionnalité de schéma dynamique, la requête SELECT doit contenir le caractère * de remplacement, afin de récupérer toutes les colonnes de la table sélectionnée.
Guess Query	Cliquez sur le bouton Guess Query afin de générer la requête correspondant à votre schéma de table dans le champ Query.
Guess schema	Cliquez sur le bouton Guess schema pour récupérer le schéma de la table.

Advanced settings

Log file	Spécifiez le chemin du fichier de log à générer pendant le processus de récupération des données. Notez que si les informations de log doivent être sauvegardées et que si le composant réutilise la connexion créée par un composant tRedshiftConnection, vous devez spécifier la propriété loglevel=1/2/3 dans le champ Additional JDBC Parameters du composant tRedshiftConnection. Le fichier de log n'a aucune limite de taille. Si le fichier de log spécifié existe déjà, il sera écrasé.
Logging level	Dans la liste déroulante, sélectionnez un niveau de log pour définir le type d'événements à enregistrer dans le fichier de log.
Use cursor	Cochez cette case et définissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois.
Trim all the String/Char columns	Cochez cette case pour supprimer les espaces en début et en fin de champ dans toutes les colonnes contenant des chaînes de caractères.
Trim columns	Supprime les espaces blancs en début et fin de champ dans les colonnes sélectionnées.
JDBC URL	Sélectionnez un moyen d'accéder à une base de données Amazon Redshift dans la liste déroulante JDBC URL. Standard : utilisez le moyen standard pour accéder à la base de données Redshift. SSO : utilisez l'authentification unique (SSO) d'IAM pour accéder à la base de données Redshift. Avant de sélectionner cette option, assurez-vous que le rôle IAM ajouté à votre cluster Redshift possède les droits d'accès appropriés à ce cluster. Pour plus d'informations, contactez l'administrateur de vos services AWS. Cette option est disponible uniquement lorsque la case Use an existing connection n'est pas cochée dans la vue Basic settings.
tStatCatcher Statistics	Cochez cette case pour collecter les données de log au niveau des composants.

Variables globales

Variables globales	NB_LINE : nombre de lignes traitées. Cette variable est une variable After et retourne un entier. QUERY : requête en cours de traitement. Cette variable est une variable Flow et retourne une chaîne de caractères. ERROR_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case. Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant. Pour renseigner un champ ou une expression à l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accéder à la liste des variables. À partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser. Pour plus d'informations concernant les variables, consultez Utiliser les contextes et les variables.

NB_LINE : nombre de lignes traitées. Cette variable est une variable After et retourne un entier.

QUERY : requête en cours de traitement. Cette variable est une variable Flow et retourne une chaîne de caractères.

ERROR_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case.

Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant.

Pour renseigner un champ ou une expression à l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accéder à la liste des variables. À partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.

Pour plus d'informations concernant les variables, consultez Utiliser les contextes et les variables.

Utilisation

Règle d'utilisation	Ce composant couvre toutes les possibilités de requête SQL dans les bases de données Amazon Redshift.
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 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 d'utilisation de paramètres dynamiques, consultez Lire des données dans des bases de données MySQL à 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 Schéma dynamique et Créer un groupe de contextes et définir les variables de contexte.
Limitation	Du fait d'une incompatibilité de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans l'onglet Component. Vous pouvez également trouver les JAR manquants et les ajouter dans l'onglet Modules de la perspective Integration de votre Studio Talend. Pour plus d'informations, consultez la page Installation de modules externes.

Règle d'utilisation

Ce composant couvre toutes les possibilités de requête SQL dans les bases de données Amazon Redshift.

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 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 d'utilisation de paramètres dynamiques, consultez Lire des données dans des bases de données MySQL à 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 Schéma dynamique et Créer un groupe de contextes et définir les variables de contexte.

Limitation

Du fait d'une incompatibilité de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans l'onglet Component. Vous pouvez également trouver les JAR manquants et les ajouter dans l'onglet Modules de la perspective Integration de votre Studio Talend. Pour plus d'informations, consultez la page Installation de modules externes.