# tS3Put Ce composant charge des données dans Amazon S3 depuis un fichier local ou depuis la mémoire cache, via le mode streaming. ## Propriétés du tS3Put Standard Ces propriétés sont utilisées pour configurer le tS3Put s'exécutant dans le framework de Jobs Standard. Le composant tS3Put Standard appartient à la famille Cloud. Le composant de ce framework est disponible dans tous les produits Talend. ## Basic settings | Propriétés | Description | | --- | --- | | Property type | Peut être Built-In ou Repository.

Built-In : aucune propriété n'est stockée de manière centrale.

Repository : Sélectionnez le fichier dans lequel sont stockées les propriétés du composant. | | 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. | | Credential provider | Spécifiez la manière d'obtenir les identifiants de sécurité AWS.



Cette option peut fonctionner comme paramètre dynamique et se voir attribuer une valeur à l'aide d'une variable de contexte.

Note InformationsRemarque : Les composants tRedshiftBulkExec, tRedshiftOutputBulk et tRedshiftOutputBulkExec supportent les connexions S3 qui sont établies avec la valeur de Credential Provider configurée à Static Credentials ou Inherit credentials from AWS role. | | 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.




Pour consulter un exemple relatif au rôle IAM et à ses types de politiques associés, accédez à [Create and Manage AWS IAM Roles](https://aws.amazon.com/blogs/security/now-create-and-manage-aws-iam-roles-more-easily-with-the-updated-iam-console/) depuis la documentation AWS (en anglais). | | Region | Spécifiez la région AWS en sélectionnant ou saisissant le nom d'une région entre guillemets doubles (*"us-east-1"* par exemple). Pour plus d'informations concernant les zones géographiques AWS, consultez [Régions et points de terminaison AWS](http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region). | | Client-side encryption | Cochez cette case et dans la liste déroulante Key type (Type de clé) affichée, sélectionnez l'une des trois options suivantes pour chiffrer les données côté client avant de les envoyer à Amazon S3. Pour plus d'informations, consultez [Protection des données via le chiffrement côté client](http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html).

| | Bucket | Spécifiez le nom du bucket, le dossier de plus haut niveau, sur le serveur S3.

Si vous utilisez Express One Zone (buckets de répertoires S3), vous devez spécifier le nom complet du bucket au format <bucketBaseName>--<availabilityZoneID>--x-s3, comme requis par AWS. Pour plus d'informations, consultez [Règles de dénomination des compartiments de répertoires](https://docs.aws.amazon.com/fr_fr/AmazonS3/latest/userguide/directory-bucket-naming-rules.html).

Note InformationsRemarque :

| | Key | Spécifiez le chemin d'accès au fichier qui contiendra les données chargées sur le serveur S3, à l'aide de barres obliques (/) pour séparer les dossiers dans le chemin.



Note InformationsAvertissement : Ce champ ne doit pas commencer par une barre oblique (/). | | File or stream | Saisissez le chemin d'accès au fichier local à charger ou au flux d'entrée duquel les données seront chargées.

Pour un exemple d'utilisation d'un flux (stream), consultez [Lire les données d'un fichier distant en mode stream](https://help.qlik.com/talend/fr-FR/components/8.0/delimited/tfileinputdelimited-tfilefetch-tsleep-tlogrow-reading-data-from-remote-file-in-streaming-mode-standard-component-this). | | Server-side encryption | Cochez cette case pour activer le chiffrement côté serveur avec des clés de chiffrement gérées par Amazon S3 (SSE-S3) et utiliser le standard de chiffrement avancé 256 bits (AES-256) pour chiffrer vos données.

Pour plus d'informations concernant le chiffrement côté serveur, consultez [Protection des données à l'aide d'un chiffrement côté serveur](https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html). | | Use KMS (Utiliser KMS) | Cochez cette case pour activer le chiffrement côté serveur avec les clés gérées par AWS KMS (SSE-KMS) au lieu des clés de chiffrement gérées par Amazon S3 (SSE-S3).

Cette propriété est disponible lorsque la case Server-side encryption est cochée. | | Server-side encryption ID | Spécifiez votre propre clé principale client (Customer Master Key, CMK) créée dans la console IAM à l'aide du service de gestion des clés AWS pour le chiffrement SSE-KMS. Si elle n'est pas spécifiée, la clé principale client par défaut, créée la première fois que vous ajoutez un objet chiffré SSE-KMS dans le bucket défini dans votre région, sera utilisée pour le chiffrement SSE-KMS.

Cette propriété est disponible lorsque la case est Use KMS cochée. | | Die on error | Cette case est décochée par défaut, ce qui vous permet de terminer le traitement avec les lignes sans erreur, et d'ignorer les lignes en erreur. | ## Advanced settings | Propriétés | Description | | --- | --- | | tStatCatcher Statistics | Cochez cette case afin de collecter les données de log au niveau du composant. | | Use a custom region endpoint (Utiliser un endpoint de région personnalisé) | Cochez cette case pour utiliser un endpoint personnalisé et, dans le champ qui s'affiche, spécifiez l'URL de l'endpoint personnalisé à utiliser.

Cette option peut fonctionner comme paramètre dynamique et se voir attribuer une valeur à l'aide d'une variable de contexte. | | 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 si la case Assume role est cochée. | | Specify 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.

Ce service vous permet d'effectuer une requête pour obtenir des identifiants temporaires, avec des droits limités, pour l'authentification utilisateur·trice à AWS. Vous devez fournit la clé d'accès et la clé secrète pour vous authentifier au compte AWS à utiliser.

Pour la liste des endpoints STS que vous pouvez utiliser, consultez [AWS Security Token Service](https://docs.aws.amazon.com/general/latest/gr/rande.html#sts_region). Pour plus d'informations concernant les identifiants STS temporaires, consultez [Temporary Security Credentials](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html). Ces deux articles proviennent de la documentation AWS.

Cette case est disponible uniquement si 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 limité d'avoir ce rôle.

Ce champ est disponible uniquement si 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 si 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 si la case Assume role est cochée. | | Tags (Mots-clés) | 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.](https://docs.aws.amazon.com/fr_fr/IAM/latest/UserGuide/id_session-tags.html#id_session-tags_role-chaining)

Ce champ est disponible uniquement si 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](https://docs.aws.amazon.com/fr_fr/IAM/latest/UserGuide/access_policies.html#policies_session).

Ce champ est disponible uniquement si la case 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](https://docs.aws.amazon.com/fr_fr/IAM/latest/UserGuide/access_policies.html#policies_session).

Ce champ est disponible uniquement lorsque la case Assume role est cochée. | | Config client | Cochez cette case et spécifiez les paramètres du client en cliquant sur le bouton [+] pour ajouter autant de lignes que nécessaire, chaque ligne pour un paramètre client. Configurez la valeur des champs suivants pour chaque paramètre :



Cette case est disponible uniquement lorsque la case Use an existing connection est cochée.

Pour plus d'informations, consultez [la documentation AWS](https://docs.aws.amazon.com/fr_fr/sdk-for-java/v1/developer-guide/section-client-configuration.html). | | Enable Accelerate Mode | Cochez cette case pour activer des transferts de fichiers rapides, simples et sécurisés, sur de longues distances entre votre client et un bucket S3. Pour que cela soit pris en compte, vous devez activer à l'avance ce mode d'accélération sur le bucket S3.

Cette option peut fonctionner comme paramètre dynamique et se voir attribuer une valeur à l'aide d'une variable de contexte. | | Multipart threshold (MB) | Spécifiez le seuil avant division en plusieurs parties (en Mo). Un fichier sera chargé en plusieurs parties si sa taille est supérieure au seuil multipart. Notez que ce paramètre n'a aucun impact en mode flux (streaming). | | Part size (Mb) | Spécifiez la taille de la partition en Mo lors du chargement d'un objet partitionné.

La taille de chaque partition doit être comprise entre 5 Mo et 5 Go. Une valeur inférieure à 5 charge l'objet avec une taille de partition de 5 Mo. Pour un objet dont la taille est inférieure à 5 Go, un chargement sans partition est possible en configurant cette option à une valeur suffisamment élevée.

Pour plus d'informations concernant le chargement partitionné de S3, consultez [Présentation du chargement partitionné](https://docs.aws.amazon.com/fr_fr/AmazonS3/latest/dev/mpuoverview.html). | | Canned access control | Sélectionnez une option dans la liste déroulante pour attribuer une autorisation prédéfinie pour la ressource courante. Consultez [Canned ACL](https://docs.aws.amazon.com/fr_fr/AmazonS3/latest/userguide/acl-overview.html) (en anglais) pour plus d'informations concernant ces autorisations prédéfinies. | | Enable object lock | Sélectionnez cette option pour activer la fonctionnalité de verrouillage des objets Amazon S3.

Avec cette option activée, vous devez sélectionner un mode de rétention (Governance ou Compliance) dans la liste déroulante Retention mode et configurer une période de rétention dans le champ Retention period.

Pour plus d'informations concernant la fonctionnalité de verrouillage d'objets Amazon S3, le mode et la période de rétention, consultez [Protecting data with Amazon S3 Object Lock](https://aws.amazon.com/blogs/storage/protecting-data-with-amazon-s3-object-lock/) (en anglais). | | Set object tags | Cochez cette case pour configurer les mots-clés des objets sous forme de paires clé-valeur. Ces mots-clés seront ajoutés aux objets S3 lors de leur chargement dans le bucket prédéfini. Pour plus d'informations, consultez [Catégorisation de votre stockage à l'aide de balises](https://docs.aws.amazon.com/fr_fr/AmazonS3/latest/userguide/object-tagging.html). | ## Variables globales | Variables | Description | | --- | --- | | 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 lorsque la case Die on error est cochée. | ## Utilisation | Conseils d'utilisation | Description | | --- | --- | | **Règle d'utilisation** | Ce composant peut être utilisé en standalone ou avec d'autres composants S3, par exemple le tS3Connection. | | 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.

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](https://help.qlik.com/talend/r/fr-FR/8.0/components/defining-context-groups/reading-data-from-databases-through-context-based-dynamic-connections) et [Lire des données à partir de différentes bases de données MySQL à l'aide de paramètres de connexion chargés dynamiquement](https://help.qlik.com/talend/r/fr-FR/8.0/components/context/reading-data-from-different-mysql-databases-using-dynamically-loaded-connection-parameters). Pour plus d'informations concernant les Paramètres dynamiques et les variables de contexte, consultez [Schéma dynamique](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/dynamic-schema) et [Créer un groupe de contextes et définir les variables de contexte](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/creating-context-group-and-define-context-variables-in-it). | **Concepts associés** * [Copier un objet S3 d'un bucket à un autre](https://help.qlik.com/talend/fr-FR/components/8.0/amazon-s3/ts3copy-ts3connection-tlogrow-copying-s3-object-from-one-bucket-to-another-standard-component-this) * [Échanger des fichiers avec Amazon S3](https://help.qlik.com/talend/fr-FR/components/8.0/amazon-s3/ts3put-ts3get-ts3connection-exchange-files-with-amazon-s3-standard-component-in-this)