community.general.lmdb_kv – fetch data from LMDB

Note

This plugin is part of the community.general collection (version 2.0.1).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.lmdb_kv.

New in version 0.2.0: of community.general

Synopsis
Requirements
Parameters
Examples
Return Values

Synopsis

This lookup returns a list of results from an LMDB DB corresponding to a list of items given to it

Requirements

The below requirements are needed on the local controller node that executes this lookup.

lmdb (python library https://lmdb.readthedocs.io/en/release/)

Parameters

Parameter	Choices/Defaults	Configuration	Comments
_terms string			list of keys to query
db string	Default: "ansible.mdb"		path to LMDB database

Examples

- name: query LMDB for a list of country codes
  ansible.builtin.debug:
    msg: "{{ query('community.general.lmdb_kv', 'nl', 'be', 'lu', db='jp.mdb') }}"

- name: use list of values in a loop by key wildcard
  ansible.builtin.debug:
    msg: "Hello from {{ item.0 }} a.k.a. {{ item.1 }}"
  vars:
    - lmdb_kv_db: jp.mdb
  with_community.general.lmdb_kv:
     - "n*"

- name: get an item by key
  ansible.builtin.assert:
    that:
      - item == 'Belgium'
    vars:
      - lmdb_kv_db: jp.mdb
    with_community.general.lmdb_kv:
      - be

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Key	Returned	Description
_raw list / elements=any	success	value(s) stored in LMDB

Authors

Jan-Piet Mens (@jpmens)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/lmdb_kv_lookup.html