> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Guide étape par étape pour créer votre premier Amazon S3 ClickPipe.
# Créer votre premier Amazon S3 ClickPipe
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
Le S3 ClickPipe offre une solution entièrement gérée et résiliente pour ingérer des données depuis Amazon S3 et des services de stockage objet compatibles S3 dans ClickHouse Cloud. Il prend en charge l’ingestion **en une seule fois** et l’**ingestion continue**, avec une garantie exactly-once.
**1.** Dans ClickHouse Cloud, sélectionnez **Data sources** dans le menu principal, puis cliquez sur **Create ClickPipe**.
**2.** Cliquez sur la tuile **Amazon S3**. Vous pouvez également l’utiliser pour vous connecter à d’autres services compatibles S3 qui ne sont pas répertoriés dans la ClickPipes UI.
En raison des différences de format d’URL et d’implémentation des API selon les fournisseurs de services de stockage d’objets, tous les services compatibles S3 ne sont pas pris en charge nativement. Si vous rencontrez des problèmes avec un service qui n’est pas répertorié parmi les [sources de données prises en charge](/docs/fr/integrations/clickpipes/object-storage/amazon-s3/overview#supported-data-sources), veuillez [contacter notre équipe](https://clickhouse.com/company/contact?loc=clickpipes).
**1.** Pour configurer un nouveau ClickPipe, vous devez indiquer comment vous connecter à votre service de stockage d'objets et vous y authentifier.
* **Méthode d’authentification** : le S3 ClickPipe prend en charge les [identifiants IAM](/docs/fr/integrations/clickpipes/object-storage/amazon-s3/overview#iam-credentials) (`Credentials`) et l’[authentification basée sur les rôles IAM](/docs/fr/integrations/clickpipes/object-storage/amazon-s3/overview#iam-role) (`IAM role`). Consultez la [documentation de référence](/docs/fr/integrations/clickpipes/object-storage/amazon-s3/overview#access-control) pour obtenir des indications sur l’authentification et les permissions.
* **Chemin de fichier S3** : le S3 ClickPipe utilise une [URI de type virtual-hosted-style](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access).
```bash theme={null}
https://bucket-name.s3.region-code.amazonaws.com/key-name
```
Vous pouvez utiliser des caractères génériques POSIX pour faire correspondre plusieurs fichiers ou préfixes. Consultez la [documentation de référence](/docs/fr/integrations/clickpipes/object-storage/amazon-s3/overview#file-pattern-matching) pour obtenir des indications sur les motifs pris en charge.
**2.** Cliquez sur **Incoming data**. ClickPipes récupérera les métadonnées de votre bucket pour l'étape suivante.
L’interface utilisateur affichera une liste des fichiers du bucket spécifié.
Sélectionnez votre format de données (nous prenons actuellement en charge un sous-ensemble des formats ClickHouse) et indiquez si vous souhaitez activer l’ingestion continue.
Consultez la section « ingestion continue » de la page de vue d’ensemble pour plus de détails.
À l’étape suivante, vous pouvez choisir d’ingérer les données dans une nouvelle table ClickHouse ou de réutiliser une table existante.
Suivez les instructions à l’écran pour modifier le nom de votre table, le schéma et les paramètres.
Vous pouvez voir un aperçu en temps réel de vos modifications dans la table d’exemple en haut de la page.
Vous pouvez également personnaliser les paramètres avancés à l’aide des contrôles fournis.
Vous pouvez aussi choisir d’ingérer vos données dans une table ClickHouse existante.
Dans ce cas, l’interface utilisateur vous permettra de mapper les champs de la source aux champs ClickHouse de la table de destination sélectionnée.
Vous pouvez également mapper des [colonnes virtuelles](/docs/fr/reference/functions/table-functions/s3#virtual-columns), comme `_path` ou `_size`, à des champs.
Enfin, vous pouvez configurer les autorisations de l’utilisateur interne ClickPipes.
**Autorisations :** ClickPipes créera un utilisateur dédié pour écrire des données dans une table de destination. Vous pouvez sélectionner un rôle pour cet utilisateur interne à l’aide d’un rôle personnalisé ou de l’un des rôles prédéfinis :
* `Full access` : accorde un accès complet au cluster. Requis si vous utilisez une vue matérialisée ou un Dictionary avec la table de destination.
* `Only destination table` : accorde uniquement les autorisations `INSERT` sur la table de destination.
En cliquant sur « Complete Setup », le système enregistrera votre ClickPipe et vous pourrez le voir apparaître dans le tableau récapitulatif.
Le tableau récapitulatif fournit des contrôles pour afficher des données d’exemple provenant de la source ou de la table de destination dans ClickHouse.
Il propose également des contrôles pour supprimer le ClickPipe et afficher un récapitulatif de la tâche d’ingestion.
**Félicitations !** Vous avez configuré avec succès votre premier ClickPipe.
S’il s’agit d’un ClickPipe configuré pour l’ingestion continue, il s’exécutera en continu et ingérera les données en temps réel depuis votre source de données distante.
Sinon, il ingérera le lot puis s’arrêtera.
