Словарь

Словарь — это объект хранения данных, связанный с каждым запуском графа в OneBridge. Его цель — обеспечить простое и надежное хранение различных параметров, необходимых графу.

Словарь также может использоваться как способ обмена данными между различными компонентами одного графа.

Между двумя запусками любого графа словарь сбрасывается до настроек по умолчанию, так что все изменения удаляются. По этой причине словарь нельзя использовать для передачи значений между разными запусками одного и того же графа.

Создание словаря

Чтобы создать словарь, щелкните правой кнопкой мыши элемент «Словарь» на панели «Структура» и выберите «Редактировать» в контекстном меню. Откроется редактор словаря.

Нажмите кнопку «Плюс» слева, чтобы создать новую словарь. После этого укажите его Имя. Также необходимо указать другие свойства записи:

  1. Имя

Указывает имя словаря. Имена чувствительны к регистру и должны быть уникальными в пределах словаря.

Правила составления словарей в разработке

  1. В качестве входных данных
  2. В качестве выходных данных
  3. Тип
  4. Тип содержимого
  5. Начальное значение

Типы словарей

Раздел в разарботке

Свойства записи словаря

Каждая запись может иметь некоторые свойства (пары имя-значение). Чтобы добавить свойство, нажмите кнопку «Плюс» справа и введите имя и значение нового свойства.

Использование словарей в графах

Доступ к словарю может осуществляться разными способами с помощью различных компонентов графа. Доступ к нему можно получить из:

  • шагов для чтения и записи. Оба они поддерживают словари в качестве источника данных или цели данных через атрибут URL-адреса файла.

  • с помощью внутреннего языка описания преобразований из любом компоненте, определяющем преобразование (все соединители, Map, Normalizer и т. д.).

Доступ к словарю со стороны шагов для чтения и записи

Чтобы ссылаться на параметр словаря в атрибуте fileURL компонента графа, этот атрибут должен иметь следующую форму:

dict:<имя параметра>[:processingType]

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

Типы обработки следующие:

  1. Для чтения

    • Дискретный. Считывает данные из словаря. Это тип обработки по умолчанию. Его не обязательно указывать.
    • Источник. Считывает данные из словаря так же, как и дискретный тип обработки, но ожидает, что значения словаря являются URL-адресами входных файлов. Данные с этого входа передаются в шаг для чтения.

Информацию об URL-адресах в шагах для чтения смотрите в разделе Чтение из словаря.

  1. Для записи

    • Источник. Записывает данные в файл, URL-адрес которого указан в словаре. URL-адрес целевого файла извлекается из указанной записи словаря. Является типом обработки по умолчанию.
    • Поток. Записывает данные в словарь. Создает WritableByteChannel
    • Дискретный. список значений типа byte.

Информацию об URL-адресах в шагах для записи смотрите в разделе Запись в словарь.

Например, dict:mountains.csv можно использовать как входной или выходной поток для чтения или звписи соответственно (в данном случае тип свойства — writable.channel).