Propriétés du tDynamoDBInput Standard

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

Le composant tDynamoDBInput Standard appartient aux familles Big Data et Bases de données NoSQL.

Le composant de ce framework est disponible dans tous les produits Talend avec Big Data et dans Talend Data Fabric.

Basic settings

Access Key	Saisissez l'ID de la clé d'accès identifiant de manière unique un compte AWS. Pour plus d'informations concernant l'obtention de vos Access Key et Secret Key, consultez Obtention de vos clés d'accès AWS (uniquement en anglais).
Secret Key	La Secret Access Key, combinée à la clé d'accès, constitue votre accès sécurisé à Amazon S3. 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.
Inherit credentials from AWS role	Cochez cette case pour tirer parti des informations d'authentification du profil de l'instance. Ces informations peuvent être utilisées sur des instances Amazon EC2 et sont fournies via le service de métadonnées d'Amazon EC2. Pour utiliser cette option, votre Job doit s'exécuter dans Amazon EC2 ou d'autres services pouvant tirer parti des rôles IAM pour accéder aux ressources. 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).
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.
Use End Point	Cochez cette case et dans le champ Server Url affiché, spécifiez l'URL du service Web du service de base de données DynamoDB.
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).
Action	Sélectionnez l'opération à effectuer dans la liste déroulante, soit Query soit Scan. Pour plus d'informations, consultez Utilisation des requêtes dans DynamoDB (uniquement en anglais).
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. Si une colonne stocke des documents JSON, sélectionnez JSON dans la liste déroulante DB Type.
Table Name	Spécifiez le nom des tables à interroger ou à scanner.
Use secondary index	Cochez cette case et, dans le champ Index qui s'affiche, spécifiez l'index secondaire global (Global Secondary Index, GSI) à utiliser pour récupérer les données. Utiliser un index secondaire global améliore les performances des requêtes et scans. Pour plus d'informations, consultez Interrogation des index secondaires globaux dans DynamoDB (uniquement en anglais) dans la documentation AWS.
Use advanced key condition expression	Cochez cette case et dans le champ Advanced key condition expression affiché, spécifiez les expressions de condition clés utilisées pour déterminer les éléments à lire depuis la table ou l'index.
Key condition expression	Spécifiez les expressions de condition clés utilisées pour déterminer les éléments à lire. Cliquez sur le bouton [+] pour ajouter autant de lignes que nécessaire, chaque ligne correspondant à une expression de condition clé, puis configurez les attributs suivants pour chaque expression : Key Column : saisissez le nom de la colonne clé. Function : sélectionnez la fonction de l'expression de condition clé. Value1 : spécifiez la valeur utilisée dans l'expression de condition clé. Value2 : spécifiez la seconde valeur utilisée dans l'expression de condition clé si nécessaire, selon la fonction que vous avez sélectionnée. Notez que seuls les éléments qui remplissent toutes les conditions clés définies dans la table peuvent être retournés. Cette table n'est pas disponible lorsque la case Use advanced key condition expression est cochée.
Use filter expression	Cochez cette case pour utiliser l'expression de filtre pour l'opération de requête ou de scan.
Use advanced filter expression	Cochez cette case et dans le champ Advanced filter expression affiché, spécifiez les expressions de filtre utilisées pour affiner les données après qu'elles soient interrogées ou scannées et avant qu'elles vous soient retournées. Cette case est disponible lorsque la case Use filter expression est cochée.
Filter expression	Spécifiez les expressions de filtre utilisées pour affiner les résultats qui vous sont retournés. Cliquez sur le bouton [+] pour ajouter autant de lignes que nécessaire, chaque ligne correspondant à une expression de filtre, puis configurez les attributs suivants pour chaque expression : Column : saisissez le nom de la colonne utilisée pour affiner les résultats. Function : sélectionnez la fonction de l'expression de filtre. Value1 : spécifiez la valeur utilisée dans l'expression de filtre. Value2 : spécifiez la seconde valeur utilisée dans l'expression de filtre si nécessaire, selon la fonction que vous avez sélectionnée. Notez que seuls les éléments qui remplissent toutes les conditions de filtre définies dans la table peuvent être retournés. Cette table est disponible lorsque la case Use filter expression est cochée et que la case Use advanced filter expression est décochée.
Value mapping	Spécifiez les valeurs factices pour les valeurs des attributs des expressions. value : saisissez la valeur de l'attribut de l'expression. placeholder : spécifiez la valeur factice du nom d'attribut correspondant. Pour plus d'informations, consultez Expression de noms d'attributs (uniquement en anglais).
Name mapping	Spécifiez les paramètres substituables des noms d'attribut qui entrent en conflit avec les mots réservés DynamoDB. name : saisissez le nom de l'attribut qui entre en conflit avec un mot réservé DynamoDB. placeholder : spécifiez le paramètre substituable du nom d'attribut correspondant. Pour plus d'informations, consultez Expression de noms d'attributs (uniquement en anglais).

Advanced settings

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 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 case est disponible uniquement lorsque la case Assume Role est cochée.
External Id	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 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 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 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 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 Assume Role est cochée.
Policy (Politique d'application)	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 Assume Role 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.

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

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.

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é comme composant de début dans un Job ou un sous-Job et nécessite un lien de sortie.

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