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

> Движок баз данных S3 предоставляет доступ к объектам в Amazon S3 и совместимых объектных хранилищах в виде таблиц, доступных только для чтения.

# S3

Движок баз данных `S3` предоставляет объекты в Amazon S3 и S3-совместимых объектных хранилищах в виде таблиц, доступных только для чтения. Имя таблицы преобразуется в URL объекта с помощью табличной функции [`s3`](/ru/reference/functions/table-functions/s3).

## Создание базы данных

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

Движок также может принимать named collection. Поддерживаемые ключи конфигурации: `url`, `access_key_id`, `secret_access_key`, `no_sign_request` и `use_environment_credentials`.

## Usage

При использовании base URL имена таблиц задаются как пути к объектам относительно этого URL:

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

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

Если base URL не задан, в качестве имени таблицы используется полный URL объекта. Схема и формат выводятся так же, как и для табличной функции `s3`. База данных не хранит определения таблиц и не поддерживает DDL таблиц и запись.

## Управление доступом

URL-адреса S3 проверяются по фильтру удалённых хостов сервера. Для создания такой базы данных требуются привилегии источника `READ` и `WRITE` на `S3` независимо от [`table_engines_require_grant`](/ru/reference/settings/server-settings/settings/other#table_engines_require_grant), например:

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

Сведения о версиях и совместимости см. в разделе [привилегии `SOURCES`](/ru/reference/statements/grant#sources).

## Смотрите также

* [Табличная функция `s3`](/ru/reference/functions/table-functions/s3)
* [Использование S3 с ClickHouse](/ru/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse)
* [Движок базы данных Filesystem](/ru/reference/engines/database-engines/filesystem)
* [Движок базы данных HDFS](/ru/reference/engines/database-engines/hdfs)