csvfile — чтение данных из файла TSV или CSV
Новое в версии 1.5.
Описание
- Поиск csvfile считывает содержимое файла в формате CSV (значения, разделенные запятыми). Поиск ищет строку, где первый столбец соответствует keyname, и возвращает значение во втором столбце, если не указан другой столбец.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| col | По умолчанию: 1 | столбец для возврата (индексация с 0). | |
| default | По умолчанию: | значение, которое возвращается, если значение не найдено в файле. | |
| delimiter | По умолчанию: TAB | разделитель полей в файле, для табуляции можно указать "TAB" или "t". | |
| encoding (добавлен в 2.1) | По умолчанию: utf-8 | Кодировка (кодовая страница) используемого файла CSV. | |
| file | По умолчанию: ansible.csv | имя файла CSV/TSV для открытия. |
Примечания
Примечание
- По умолчанию используется TSV-файл (разделенный табуляцией), а не CSV (разделенный запятыми) ... да, название вводящее в заблуждение.
Примеры
- name: Match 'Li' on the first column, return the second column (0 based index)
debug: msg="The atomic number of Lithium is {{ lookup('csvfile', 'Li file=elements.csv delimiter=,') }}"
- name: msg="Match 'Li' on the first column, but return the 3rd column (columns start counting after the match)"
debug: msg="The atomic mass of Lithium is {{ lookup('csvfile', 'Li file=elements.csv delimiter=, col=2') }}"
Возвращаемые значения
Общие значения, возвращаемые функциями, описаны здесь, следующие являются полями, уникальными для этого поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _raw | значение(я), хранящиеся в столбце файла |
Статус
Автор
- Ян-Пиет Менс (@jpmens) <jpmens(at)gmail.com>
Подсказка
Если вы заметили какие-либо проблемы в этом руководстве, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/plugins/lookup/csvfile.html
