Propriétés du tRedshiftOutputBulkExec Standard

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

Le composant tRedshiftOutputBulkExec 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 aux bases de données, consultez Composants de bases de données dynamiques.

Basic settings

Base de données	Sélectionnez un type de base de données dans la liste et cliquez sur Apply.
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 de connexion à la base de données suivants sont alors remplis automatiquement à 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.
Host	Saisissez l'adresse IP ou le nom de l'hôte du serveur de la base de données.
Port	Saisissez le numéro du port d'écoute du serveur de la base de données.
Database	Saisissez le nom de la base de données.
Schema	Saisissez le nom du schéma.
Username et Password	Saisissez les données d'authentification de l'utilisateur ou de l'utilisatrice 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.
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.
Table Name	Spécifiez le nom de la table à écrire. Notez que seule une table peut être écrite à la fois.
Action on table	Sur la table définie, vous pouvez effectuer l'une des opérations suivantes : None : aucune opération n'est effectuée. 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 not exists : 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é. Vous pouvez annuler cette opération.
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.
	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.
Data file path at local	Spécifiez le chemin d'accès local au fichier à générer. Notez que ce fichier est généré sur la machine où est installé le Studio ou sur laquelle le Job utilisant ce composant est déployé.
Append the local file	Cochez cette case pour écrire à la suite les données dans le fichier local spécifié s'il existe déjà, au lieu de l'écraser.
Create directory if not exists	Cochez cette case pour créer le répertoire spécifié dans le champ Data file path at local, s'il n'existe pas. Par défaut, cette case est cochée.
Use an existing S3 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.
Credential provider	Spécifiez la manière d'obtenir les identifiants de sécurité AWS : `Static Credentials` ou `Inherit credentials from AWS role`. `Static Credentials` : utilisez access key et secret key comme identifiants de sécurité AWS. `Inherit credentials from AWS role` : obtenez les identifiants de sécurité AWS pour vos métadonnées d'instance EMR. Pour utiliser cette option, le cluster Amazon EMR doit être démarré et votre Job doit s'exécuter sur ce cluster. Pour plus d'informations, consultez Utilisation d'un rôle IAM pour accorder des autorisations à des applications s'exécutant sur des instances Amazon EC2 (uniquement en anglais). Cette option vous permet de développer votre Job sans avoir à mettre de clé AWS dans le Job et ainsi satisfaire à la politique de sécurité de votre entreprise. Note InformationsRemarque : Cette liste déroulante est disponible uniquement si vous avez installé la mise à jour mensuelle R2021-07 du Studio ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.
Access Key	Spécifiez l'ID de la clé d'accès identifiant de manière unique un compte AWS. Pour savoir comment obtenir votre clé d'accès et votre clé secrète d'accès, consultez Getting Your AWS Access Keys (uniquement en anglais) (en anglais). Note InformationsRemarque : Cette option est disponible lorsque Use an existing S3 connection ou `Inherit credentials from AWS role` ne sont pas sélectionnés dans la liste déroulante Credentials provider.
Secret Key	Spécifiez la clé secrète d'accès, constituant les informations de sécurité, ainsi que la clé d'accès. Pour saisir la clé secrète, cliquez sur le bouton [...] à côté du champ Secret key, puis, dans la boîte de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles puis cliquez sur OK afin de sauvegarder les paramètres. Note InformationsRemarque : Cette option est disponible lorsque Use an existing S3 connection ou `Inherit credentials from AWS role` ne sont pas sélectionnés dans la liste déroulante Credentials provider.
S3 Assume Role	Si vous avez temporairement besoin d'autorisations d'accès relatives à un rôle AWS IAM qui n'est pas octroyé à votre compte d'utilisateur ou d'utilisatrice, cochez cette case afin d'assumer ce rôle. Puis, spécifiez les valeurs des paramètres suivants pour créer une session du rôle. Assurez-vous que l'accès à ce rôle a été octroyé à votre compte d'utilisateur ou d'utilisatrice par la politique de sécurité associée à ce rôle. En cas de doute, adressez-vous au propriétaire de ce rôle ou à votre administrateur AWS. Note InformationsRemarque : Cette option est disponible lorsque la case Use an existing S3 connection n'est pas cochée. Role ARN : nom Amazon Resource Name (ARN) du rôle. Vous pouvez trouver ce nom ARN sur la page Summary du rôle à utiliser sur votre portail AWS. Ce ARN de rôle pourrait être par exemple `am:aws:iam::[aws_account_number]:role/[role_name]`. Role session name : saisissez le nom que vous souhaitez utiliser pour identifier de façon unique votre session de rôle. Ce nom peut être composé de caractères alphanumériques en majuscules ou en minuscules, sans espaces. Vous pouvez également inclure des tirets bas ou les caractères suivants : =,.@-. Session duration (minutes) : durée (en minutes) pour laquelle vous souhaitez que la session du rôle soit active. Cette durée ne peut pas être supérieure à la durée maximale définie par votre administrateur AWS. La durée par défaut est de 3 600 secondes si vous ne configurez pas de valeur. Pour consulter un exemple relatif au rôle IAM et à ses types de politiques associés, accédez à Create and Manage AWS IAM Roles (uniquement en anglais) depuis la documentation AWS (en anglais).
Region	Spécifiez la zone géographique AWS en sélectionnant le nom d'une zone géographique dans la liste ou en saisissant le nom de la zone entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour plus d'informations concernant les zones géographiques AWS, consultez Régions et points de terminaison AWS (uniquement en anglais). Note InformationsRemarque : Ce champ est disponible lorsque l'option Use an existing S3 connection n'est pas sélectionnée.
Bucket	Saisissez le nom du bucket Amazon S3, le dossier de plus haut niveau, dans lequel charger le fichier. Le bucket et la base de données Redshift à utiliser doivent se situer dans la même région sur Amazon. Cela permet d'éviter les erreurs S3ServiceException d'Amazon. Pour plus d'informations concernant ces erreurs, consultez S3ServiceException Errors (uniquement en anglais) (en anglais).
Key	Saisissez la clé d'objet assignée au fichier chargé dans Amazon S3.
Redshift Assume Role	Cochez cette case et spécifiez les valeurs des paramètres utilisés pour créer une session du rôle. IAM Role ARNs chains : une série de rôles en chaîne, pouvant appartenir à d'autres comptes, que votre cluster peut utiliser pour accéder aux ressources. Vous pouvez mettre en chaîne un maximum de dix rôles. Role ARN : nom Amazon Resource Name (ARN) du rôle. Pour plus d'informations concernant les chaînes de rôles IAM ARN, consultez Authorizing Redshift service (uniquement en anglais) (en anglais).

Advanced settings

Fields terminated by	Saisissez le caractère utilisé pour séparer les champs.
Enclosed by	Sélectionnez le caractère avec lequel entourer les champs.
Compressed by	Cochez cette case et sélectionnez dans la liste un type de compression pour le fichier de données. Ce champ disparaît lorsque la case Append the local file est cochée.
Encrypt	Cochez cette case pour générer et charger le fichier de données dans Amazon S3 en utilisant le chiffrement côté client. Dans le champ Encryption Key qui s'affiche, spécifiez la clé de chiffrement utilisée pour chiffrer le fichier. Notez que seule une enveloppe de clé AES 128 bits ou AES 256 bits encodée en base64 est supportée. Pour plus d'informations, consultez Loading Encrypted Data Files from Amazon S3 (uniquement en anglais) (en anglais). Cette case est décochée par défaut et le fichier de données est chargé dans Amazon S3 en utilisant le chiffrement côté serveur. Pour plus d'informations concernant le chiffrement côté serveur et côté client, consultez Protection des données à l'aide d'un chiffrement (uniquement en anglais). Note InformationsRemarque : Ce champ est disponible lorsque l'option Use an existing S3 connection n'est pas sélectionnée.
Encoding	Sélectionnez un type d'encodage pour les données dans le fichier à générer.
Delete local file after putting it to S3	Cochez cette case pour supprimer le fichier local après son chargement dans Amazon S3. Par défaut, cette case est cochée.
Date format	Sélectionnez l'un des éléments suivants afin de spécifier le format de date dans les données source : NONE : aucun format de date n'est spécifié. PATTERN : sélectionnez cet élément et spécifiez le format de date dans le champ affiché. Le format de date par défaut est YYYY-MM-DD. AUTO : sélectionnez cet élément si vous souhaitez qu'Amazon Redshift reconnaisse et convertisse automatiquement le format de date.
Time format	Sélectionnez l'un des éléments suivants dans la liste, afin de spécifier le format d'heure dans les données source : NONE : aucun format d'heure n'est spécifié. PATTERN : sélectionnez cet élément et spécifiez le format d'heure dans le champ affiché. Le format de l'heure par défaut est YYYY-MM-DD HH:MI:SS. AUTO : sélectionnez cet élément si vous souhaitez qu'Amazon Redshift reconnaisse et convertisse automatiquement le format d'heure. EPOCHSECS : sélectionnez cet élément si les données source sont représentées en tant qu'époque, le nombre de secondes depuis Jan 1, 1970 00:00:00 UTC. EPOCHMILLISECS : sélectionnez cet élément si les données source sont représentées en tant qu'époque, le nombre de millisecondes depuis Jan 1, 1970 00:00:00 UTC.
Settings	Cliquez sur le bouton [+] en dessous de la table pour spécifier plus de paramètres pour le chargement des données. Parameter : cliquez dans la cellule et sélectionnez un paramètre dans la liste déroulante. Value : sélectionnez la valeur du paramètre correspondant. Notez que vous ne pouvez pas configurer la valeur d'un paramètre (tel qu'IGNOREBLANKLINES) qui ne nécessite pas de valeur. Pour plus d'informations sur les paramètres, consultez http://docs.aws.amazon.com/redshift/latest/dg/r_COPY.html (uniquement en anglais) (en anglais).
Config client	Cochez cette case afin de configurer les paramètres clients pour Amazon S3. Cliquez sur le bouton [+] sous la table pour ajouter autant de lignes que nécessaire, chaque ligne pour un paramètre de configuration client, et configurez la valeur des attributs suivants pour chaque paramètre : Client Parameter : cliquez dans la cellule et sélectionnez un paramètre dans la liste déroulante. Value : saisissez la valeur du paramètre client correspondant. Pour plus d'informations concernant les paramètres clients S3 , consultez Configuration du client (uniquement en anglais).
STS Endpoint	Cochez cette case afin de spécifier l'endpoint du service AWS Security Token Service duquel les informations d'authentification sont récupérées. Par exemple, saisissez `sts.amazonaws.com`. Cette case est disponible uniquement lorsque la case S3 Assume role est cochée.
Signing region	Sélectionnez la région AWS du service STS. Si la région n'est pas dans la liste, vous pouvez saisir son nom entre guillemets doubles. La valeur par défaut est us-east-1. Cette liste déroulante est disponible uniquement lorsque la case S3 Assume role est cochée.
Id externe	Si l'administrateur du compte auquel le rôle appartient vous a fourni un ID externe, saisissez sa valeur ici. L'ID externe (External Id) est un identifiant unique permettant à un nombre d'utilisateurs et d'utilisatrices connecté·e·s limité d'avoir ce rôle. Ce champ est disponible uniquement lorsque la case S3 Assume role est cochée.
Serial number	Lorsque vous avez un rôle attribué, la politique de confiance de ce rôle peut nécessiter une authentification multifacteur. Dans ce cas, vous devez indiquer le numéro d'identification du matériel ou de l'appareil d'authentification multifacteur virtuel associé à l'utilisateur ou l'utilisatrice ayant ce rôle. Ce champ est disponible uniquement lorsque la case S3 Assume role est cochée.
Token code	Lorsque vous avez un rôle attribué, la politique de confiance de ce rôle peut nécessiter une authentification multifacteur. Dans ce cas, vous devez indiquer un code de jeton. Ce code de jeton est un mot de passe à utilisation unique produit par l'appareil d'authentification multifacteur. Ce champ est disponible uniquement lorsque la case S3 Assume role est cochée.
Tags	Liste les balises de session sous forme de paires clé-valeur. Vous pouvez utiliser ces balises de session dans des politiques afin de permettre d'autoriser ou l'accès aux requêtes. Transitive : cochez cette case pour indiquer qu'une balise persiste vers le rôle suivant dans une chaîne de rôles. Pour plus d'informations concernant les balises, consultez Chaînage des rôles avec des balises de session. (uniquement en anglais) Ce champ est disponible uniquement lorsque la case S3 Assume role est cochée.
IAM Policy ARNs	Saisissez les noms ARN (Amazon Resource Names) des stratégies gérées par IAM que vous souhaitez utiliser comme stratégies de sessions gérées. Utiliser les stratégies de sessions gérées afin de limiter les autorisations de la session. Les politiques doivent exister dans le même compte que le rôle. Les autorisations de la session sont au croisement de la stratégie des rôles basée sur l'identité et des stratégies de sessions. Pour plus d'informations concernant les stratégies de sessions, consultez la documentation Stratégies de session (uniquement en anglais). Ce champ est disponible uniquement lorsque la case S3 Assume role est cochée.
Policy	Saisissez une politique IAM au format JSON, à utiliser comme politique de session. Utilisez les politiques de session afin de limiter les autorisations de la session. Les autorisations de la session sont au croisement de la stratégie des rôles basée sur l'identité et des stratégies de sessions. Pour plus d'informations concernant les stratégies de sessions, consultez la documentation Stratégies de session (uniquement en anglais). Ce champ est disponible uniquement lorsque la case S3 Assume Role est cochée.
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 métadonnées de traitement du Job au niveau du Job ainsi qu'au niveau de chaque composant.

Variables globales

Variables globales	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. 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 le Guide d'utilisation du Studio Talend.

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.

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 le Guide d'utilisation du Studio Talend.

Utilisation

Règle d'utilisation	Ce composant est généralement utilisé lorsqu'aucune transformation particulière n'est requise sur les données à charger dans Amazon Redshift.
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é 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 (Dynamic settings) et les variables de contexte, consultez le Guide d'utilisation du Studio Talend.

Règle d'utilisation

Ce composant est généralement utilisé lorsqu'aucune transformation particulière n'est requise sur les données à charger dans Amazon Redshift.

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é 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 (Dynamic settings) et les variables de contexte, consultez le Guide d'utilisation du Studio Talend.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici