---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ytsaurus.tech/docs/en/yql/syntax/select/folder.md
  - https://ytsaurus.tech/docs/ru/yql/syntax/select/folder.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ytsaurus.tech/docs/ru/llms.txt


# Перечисление содержимого директории на кластере

Указывается как функция `FOLDER` в [FROM](https://ytsaurus.tech/docs/ru/yql/syntax/select/from.md).

Аргументы:

1. Путь к директории;
2. Опционально строка со списком интересующих мета атрибутов через точку с запятой.

В результате получается таблица с тремя фиксированными колонками:

1. **Path** (`String`) — полное имя таблицы;
2. **Type** (`String`) — тип узла (table, map_node, file, document и пр.);
3. **Attributes** (`Yson`) — Yson-словарь с заказанными во втором аргументе мета атрибутами.

Рекомендации по использованию:

* Чтобы получить только список таблиц, нужно не забывать добавлять `...WHERE Type == "table"`. Затем, опционально добавив ещё условий, с помощью агрегатной функции [AGGREGATE_LIST](https://ytsaurus.tech/docs/ru/yql/builtins/aggregation.md#aggregate-list) от колонки Path можно получить только список путей и передать их в [EACH](https://ytsaurus.tech/docs/ru/yql/syntax/select/concat.md).
* Так как колонка Path выдаётся в том же формате, что и результат функции [TablePath()](https://ytsaurus.tech/docs/ru/yql/builtins/basic.md#tablepath), то их можно использоваться для JOIN атрибутов таблицы к её строкам.
* C колонкой Attributes рекомендуется работать через [Yson UDF](https://ytsaurus.tech/docs/ru/yql/udf/list/yson.md).

{% note warning %}

Следует с осторожностью использовать FOLDER с атрибутами, содержащими большие значения (`schema` может быть одним из таких). Запрос с  FOLDER на папке с большим число таблиц и тяжелым атрибутом может создать большую нагрузку на мастер YT.

{% endnote %}

## Примеры

```yql
USE hahn;

$table_paths = (
    SELECT AGGREGATE_LIST(Path)
    FROM FOLDER("my_folder", "schema;row_count")
    WHERE
        Type = "table" AND
        Yson::GetLength(Attributes.schema) > 0 AND
        Yson::LookupInt64(Attributes, "row_count") > 0
);

SELECT COUNT(*) FROM EACH($table_paths);
```