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

> Движок базы данных HDFS предоставляет доступ к файлам в HDFS как к таблицам только для чтения.

# HDFS

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

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

```sql theme={null}
CREATE DATABASE hdfs_data
ENGINE = HDFS([hdfs_host_and_root_path]);
```

`hdfs_host_and_root_path` необязательно задаёт базовый URL HDFS. Если он указан, имена таблиц интерпретируются как пути относительно этого URL. Если он не задан, имена таблиц должны представлять собой полные URL вида `hdfs://`.

## Использование

```sql theme={null}
CREATE DATABASE hdfs_data
ENGINE = HDFS('hdfs://namenode:9000/data');

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

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

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

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

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

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

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

* [Табличная функция `hdfs`](/ru/reference/functions/table-functions/hdfs)
* [Движок базы данных Filesystem](/ru/reference/engines/database-engines/filesystem)
* [Движок базы данных S3](/ru/reference/engines/database-engines/s3)