community.general.from_csv фильтр – Преобразует входной CSV-текст в список словарей
Примечание
Этот плагин-фильтр входит в коллекцию community.general (версия 9.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install community.general.
Чтобы использовать её в плейбуке, укажите: community.general.from_csv.
Добавлен в community.general 2.3.0
Описание
- Преобразует входной CSV-текст в список словарей.
Входные данные
Это описание входных данных фильтра, значения перед | community.general.from_csv.
Параметр | Комментарии |
|---|---|
Входные данные строка / обязательный | Строка, содержащая CSV-документ. |
Параметры
Это описание параметров фильтра. Это значения key1=value1, key2=value2 и так далее в следующем примере: input | community.general.from_csv(key1=value1, key2=value2, ...)
Параметр | Комментарии |
|---|---|
разделитель строка | Строка длиной в один символ, используемая для разделения полей. Используя этот параметр, вы изменяете значение по умолчанию, используемое Значение по умолчанию зависит от используемого диалекта. |
диалект строка | Диалект CSV, используемый при разборе CSV-файла. Возможные значения включают По умолчанию: |
имена_полей список / элементы=строка | Список имён полей для каждого столбца. Это необходимо, если в CSV нет заголовка. |
пропускать_начальные_пробелы булево | Игнорировать ли пробелы сразу после разделителя. Используя этот параметр, вы изменяете значение по умолчанию, используемое Значение по умолчанию зависит от используемого диалекта. Варианты:
|
строгий булево | Вызывать ли исключение при некорректном CSV-входе. Используя этот параметр, вы изменяете значение по умолчанию, используемое Значение по умолчанию зависит от используемого диалекта. Варианты:
|
Примеры
- name: Parse a CSV file's contents
ansible.builtin.debug:
msg: >-
{{ csv_data | community.general.from_csv(dialect='unix') }}
vars:
csv_data: |
Column 1,Value
foo,23
bar,42
# Produces the following list of dictionaries:
# {
# "Column 1": "foo",
# "Value": "23",
# },
# {
# "Column 1": "bar",
# "Value": "42",
# }
Возвращаемое значение
Ключ | Описание |
|---|---|
Возвращаемое значение список / элементы=словарь | Список со словарем на каждую строку. Возвращено: успешно |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/from_csv_filter.html