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

> El motor de base de datos S3 expone los objetos de Amazon S3 y de almacenamientos de objetos compatibles como tablas de solo lectura.

# S3

El motor de base de datos `S3` expone los objetos de Amazon S3 y del almacenamiento de objetos compatible con S3 como tablas de solo lectura. El nombre de una tabla se resuelve como una object URL mediante la función de tabla [`s3`](/es/reference/functions/table-functions/s3).

## Crear una database

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

El engine también puede recibir una named collection. Las claves de configuración admitidas son `url`, `access_key_id`, `secret_access_key`, `no_sign_request` y `use_environment_credentials`.

## Uso

Con una base URL, los nombres de tabla son paths de objects relativos a esa URL:

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

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

Sin una URL base, utilice la URL completa del objeto como nombre de la tabla. El esquema y el formato se infieren igual que en la función de tabla `s3`. La base de datos no contiene definiciones de tablas y no admite DDL de tablas ni escrituras.

## Control de acceso

Las URL de S3 se verifican con el filtro de hosts remotos del servidor. Para crear esta base de datos se requieren los grants de source `READ` y `WRITE` sobre `S3`, independientemente de [`table_engines_require_grant`](/es/reference/settings/server-settings/settings/other#table_engines_require_grant); por ejemplo:

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

Consulte los [privilegios `SOURCES`](/es/reference/statements/grant#sources) para obtener detalles sobre la versión y la compatibilidad.

## Véase también

* [Función de tabla `s3`](/es/reference/functions/table-functions/s3)
* [Uso de S3 con ClickHouse](/es/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse)
* [Motor de base de datos Filesystem](/es/reference/engines/database-engines/filesystem)
* [Motor de base de datos HDFS](/es/reference/engines/database-engines/hdfs)