Propriétés du tDynamoDBInput Standard - 7.3

Amazon DynamoDB

author
Talend Documentation Team
EnrichVersion
Cloud
7.3
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Open Studio for Big Data
Talend Real-Time Big Data Platform
task
Création et développement > Systèmes tiers > Services Amazon (Intégration) > Composants Amazon DynamoDB
Gouvernance de données > Systèmes tiers > Services Amazon (Intégration) > Composants Amazon DynamoDB
Qualité et préparation de données > Systèmes tiers > Services Amazon (Intégration) > Composants Amazon DynamoDB
EnrichPlatform
Studio Talend

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.

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.

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

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.

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.

 

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.

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

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.

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

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 politiques de sessions, consultez la section correspondante dans Stratégies de session.

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 politiques de sessions, consultez la section correspondante dans Stratégies de session.

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

Global Variables

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

QUERY : requête traitée. 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 le Guide utilisateur 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.