Вышел YTsaurus 25.2.0

Депрекация узлов‑списков началась с версии 24.1 и теперь близится к завершению. В ближайшие месяцы мы планируем выпустить мажорную версию YTsaurus, в которой эти узлы будут полностью удалены из серверного кода. Мы хотим заранее сообщить об этом важном изменении и помочь вам перейти на альтернативные типы узлов.

Что такое и почему мы от них отказываемся?Что такое list_node и почему мы от них отказываемся?

list_node — это тип узлов Кипариса, схожий с map_node. Эти два типа — единственные, которые могут иметь другие Кипарисные узлы в качестве дочерних. Сейчас мы разрабатываем новые подходы к улучшению масштабируемости мастер‑сервера и в рамках этой задачи решили прекратить поддерживать узлы‑списки. Поддержка этого типа оказалась затруднительной при минимальном количестве преимуществ. Мы уже убрали все list_node с наших внутренних инсталляций, и большинству пользователей оказалось достаточно предложенных нами альтернатив.

Как мигрироватьКак мигрировать

Мы покажем, как проверить кластер на наличие list_node объектов, и выпустим скрипт для их замены на узлы типа document. И то и другое произойдёт в ближайшем мажорном релизе 25.2. Ниже мы рассмотрим наиболее частые случаи использования узлов‑списков, ведь все возможные сценарии предугадать трудно.

Что использовать вместо узлов‑списков?Что использовать вместо узлов‑списков?

Вот типичные сценарии использования list_node и наши рекомендации по замене:

1. В роли очередей:

   Во время нашей внутренней миграции мы обнаружили, что многие пользователи использовали узлы‑списки в качестве очередей. Это логично: узлы‑списки позволяют обращаться к дочерним элементам по индексу и добавлять элементы в конец, имитируя поведение очереди. К счастью, их легко заменить документ‑узлами в таких случаях использования. Тип document хранит произвольный YSON и поддерживает все типы YSON, включая списки. Таким образом, документы поддерживают те же операции со списками, что и узлы‑списки. Обратите внимание: документы не могут содержать директории, таблицы или другие типы узлов Кипариса. Если ваше приложение опирается на использование этих типов внутри списка, документы не подойдут. Подробнее см. в документации.

2. В качестве прочих YSON‑подобных структур:

   При запуске без указания типа некоторые команды создают узлы‑списки, и пользователи могут пользоваться этим непреднамеренно. Например, команда yt set //home/some_path '["something"; "something"]' создаст узел‑список. Если данные, хранящиеся в вашем узле‑списке, можно представить как YSON, рекомендуем хранить их в виде документ‑узла.

3. Когда дочерние элементы — это map‑узлы или таблицы, или когда на них используются блокировки:

   Такие случаи встречались редко, но бывали ситуации, когда у узлов‑списков в качестве дочерних были директории или таблицы, или когда пользователям требовалось блокировать элементы списка. Если вашей логике всё же нужно нужно блокировать элементы или хранить в узлах‑списках директории либо таблицы, то мы рекомендуем полностью перейти на директории. Обратите внимание: тип map_node не поддерживает вставку дочерних элементов по индексу. По нашему опыту, узлы‑списки не были широко востребованы в этих специфических случаях, и большинство приложений легко адаптируется.

Обеспечение плавного переходаОбеспечение плавного перехода

В версии 24.1 мы добавили опцию в динамическую конфигурацию мастер‑сервера forbid_list_node_creation, запрещающую создание новых узлов‑списков.

Начиная с версии 24.2 эта опция включена по умолчанию. Поэтому, если ваш кластер введён в эксплуатацию начиная с версии 24.2, вероятно, никаких действий не потребуется.

Чтобы проверить, создают ли ваши процессы узлы‑списки, включите опцию forbid_list_node_creation:

$ yt set //sys/@config/cypress_manager/forbid_list_node_creation %true

В предстоящем релизе 25.2 мастер‑сервер будет выдавать предупреждение при загрузке снапшота, в котором содержатся узлы‑списки.

В одном из последующих релизов поддержка узлов‑списков будет полностью прекращена: кластер не запустится, если в их снапшотах останутся объекты типа list_node.