> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Le moteur de base de données S3 expose les objets stockés dans Amazon S3 et dans les stockages d'objets compatibles sous forme de tables en lecture seule.

# S3

Le moteur de base de données `S3` expose les objects d'Amazon S3 et des object storage compatibles S3 sous forme de tables en lecture seule. Un nom de table est résolu en object URL via la fonction de table [`s3`](/fr/reference/functions/table-functions/s3).

## Création d'une base de données

```sql theme={null}
CREATE DATABASE s3_data
ENGINE = S3([url[, NOSIGN | access_key_id, secret_access_key]]);
```

L'engine peut également accepter une named collection. Les clés de configuration prises en charge sont `url`, `access_key_id`, `secret_access_key`, `no_sign_request` et `use_environment_credentials`.

## Usage

Avec une URL de base, les noms de tables correspondent à des chemins d'objets relatifs à cette URL :

```sql theme={null}
CREATE DATABASE s3_data
ENGINE = S3('https://bucket.s3.amazonaws.com/data/', 'NOSIGN');

SELECT * FROM s3_data.`events.parquet`;
```

Sans base URL, utilisez l'object URL complet comme nom de table. Le schema et le format sont inférés de la même manière que pour la fonction de table `s3`. La base de données ne contient aucune table definition et ne prend en charge ni le DDL de tables ni les writes.

## Contrôle d'accès

Les URL S3 sont vérifiées au regard du filtre d'hôtes distants du serveur. La création de cette base de données requiert les grants de source `READ` et `WRITE` sur `S3`, quelle que soit la valeur de [`table_engines_require_grant`](/fr/reference/settings/server-settings/settings/other#table_engines_require_grant), par exemple :

```sql theme={null}
GRANT READ, WRITE ON S3 TO user_name;
```

Consultez les [privilèges `SOURCES`](/fr/reference/statements/grant#sources) pour plus de détails sur la version et la compatibilité.

## Voir aussi

* [Fonction de table `s3`](/fr/reference/functions/table-functions/s3)
* [Utiliser S3 avec ClickHouse](/fr/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse)
* [Moteur de base de données Filesystem](/fr/reference/engines/database-engines/filesystem)
* [Moteur de base de données HDFS](/fr/reference/engines/database-engines/hdfs)