# Трассировщик происхождения JSON-данных

Отслеживает пути JSON-полей, производные зависимости и историю преобразований

> Каноническая страница: https://elysiatools.com/ru/tools/json-data-lineage-tracer

- **Категория:** Data Processing

- **Ключевые слова:** json, lineage, etl, field mapping, dependency graph, data engineering

## Обзор

Подходит для ETL, API и анализа маппинга полей. Можно объединять исходный JSON с правилами производных полей.

## Входные данные

- **Исходный JSON** (textarea): { "order": { "id": "ORD-1001", "customer": { "firstName": "Ada", "lastName": "Lovelace" }, "totalCents": 2599 } }
- **JSON правил происхождения (необязательно)** (textarea): { "rules": \[ { "target": "$.order.totalUsd", "sources": \["$.order.totalCents"\], "transforms": \["divide_by_100", "round(2)"\] }, { "target": "$.order.customerLabel", "sources": \["$.order.customer.firstName", "$.order.customer.lastName"\], "transforms": \["concat(" ")"\] } \] }
- **Включать узлы объектов и массивов** (checkbox)
- **Максимум полей в выводе** (number)

## Когда использовать

- При проектировании и отладке ETL-процессов для понимания того, как формируются конечные данные из исходных источников.
- Для документирования маппинга полей между различными API, микросервисами или базами данных.
- При рефакторинге сложных JSON-структур, чтобы отследить зависимости и избежать поломки связанных систем.

## Как это работает

- Вставьте исходный JSON-код в основное поле ввода для анализа базовой структуры и извлечения путей.
- При необходимости добавьте JSON с правилами происхождения, указав целевые поля, их источники и примененные преобразования (например, математические операции или конкатенацию).
- Настройте параметры вывода: выберите, нужно ли включать узлы контейнеров (объекты и массивы), и задайте лимит количества полей.
- Получите структурированный JSON-ответ, содержащий сводную статистику и узлы графа зависимостей для всех базовых и производных полей.

## Сценарии использования

- Аудит данных: проверка того, из каких исходных полей формируются финансовые показатели или агрегированные метрики в итоговом отчете.
- Интеграция API: создание точной карты соответствия полей при переходе со старой версии API на новую.
- Разработка хранилищ данных: отслеживание трансформаций сырых данных (raw data) перед их загрузкой в витрины данных.

## Частые вопросы

### Что такое правила происхождения (lineage rules)?

Это JSON-конфигурация, описывающая, как новые (производные) поля создаются из исходных данных с помощью различных преобразований, например, объединения строк или вычислений.

### Зачем нужна опция включения узлов контейнеров?

Она позволяет отображать в графе зависимостей не только конечные значения (листья), но и родительские объекты или массивы, что полезно для понимания полной иерархии документа.

### Есть ли ограничение на размер обрабатываемого JSON?

Инструмент поддерживает вывод до 2000 полей. Вы можете настроить этот лимит с помощью параметра «Максимум полей в выводе», чтобы избежать перегрузки при работе с огромными файлами.

### Можно ли использовать инструмент без правил преобразования?

Да, если вы не укажете правила, инструмент просто извлечет все пути полей из исходного JSON и построит базовое дерево структуры.

### В каком формате предоставляется результат?

Результат возвращается в формате JSON, который содержит общую статистику (количество базовых и производных полей) и массив узлов графа зависимостей.

## Связанные инструменты

- [Восстановитель JSON](https://elysiatools.com/ru/tools/json-unflattener): Преобразует выровненные пары ключ-значение обратно во вложенные JSON-объекты с поддержкой различных форматов ключей
- [Переименователь Ключей JSON](https://elysiatools.com/ru/tools/json-key-renamer): Пакетно переименовывает ключи объектов JSON с поддержкой шаблонов, правил и преобразований. Идеально для форматирования ответов API.
- [Онлайн-утилита Lodash](https://elysiatools.com/ru/tools/lodash-online-utility): Безопасно запускает выбранные методы Lodash для JSON.
- [Удалитель BOM Символов](https://elysiatools.com/ru/tools/data-bom-remover): Удаление BOM (Byte Order Mark) символов из текстового и файлового содержимого. Идеально для очистки текстовых файлов с проблемами кодировки.
- [BSON Конвертер](https://elysiatools.com/ru/tools/bson-converter): Кодирует и декодирует данные в/из формата BSON (Binary JSON)
- [Валидатор JSON Schema](https://elysiatools.com/ru/tools/json-schema-validator): Проверка данных JSON по схеме JSON для проверки структуры и типов данных
- [Smile Конвертер](https://elysiatools.com/ru/tools/smile-converter): Кодирует и декодирует данные в/из формата Smile (binary JSON)
- [Text to Excel Converter](https://elysiatools.com/ru/tools/text-to-excel): Convert various text formats to Excel with customizable parsing and formatting options

## Примеры

- [JSON Примеры Terraform Plan](https://elysiatools.com/ru/samples/terraform-plan-json-samples): Файлы Terraform plan JSON для визуализации зависимостей и проверки изменений, похожие на terraform show -json
- [Примеры JSON](https://elysiatools.com/ru/samples/json): Примеры формата JSON (JavaScript Object Notation) от простых до сложных структур
- [Примеры JSON чата](https://elysiatools.com/ru/samples/chat-transcript-json): Примеры JSON для чат-транскриптов с несколькими ролями
- [Примеры JSON для Rich Text](https://elysiatools.com/ru/samples/rich-media-json): Примеры JSON для редакторов rich text (TipTap, Quill, Slate)

## Связанные материалы

- [Генераторы JSON-схем, mock-данных и API-fixture](https://elysiatools.com/ru/hubs/json-generate): Подборка инструментов для генерации JSON-схем, сборки mock-payload и подготовки API-fixture в одном хабе.
- [Инструменты для observability, анализа логов и отладки trace](https://elysiatools.com/ru/hubs/observability-debugging): Разбирайте логи, исследуйте trace, сравнивайте дрейф API payload и превращайте сырые данные наблюдаемости в таймлайны, диаграммы и структурированные доказательства для более быстрой отладки.
- [Инструменты JSON-обмена и перевода форматов](https://elysiatools.com/ru/hubs/json-convert): Сравните инструменты преобразования JSON для CSV, YAML, TOML, GraphQL, XML, Markdown, Excel, BSON, EDN и других структурированных форматов в одном хабе.
- [Инструменты для проверки, diff и преобразования JSON](https://elysiatools.com/ru/hubs/json-utility): Соберите в одном хабе инструменты для форматирования JSON, сравнения версий, проверки путей, валидации схем, объединения файлов и преобразования данных для API и data workflows.