pyarrow.compute.map_lookup(container, /, query_key, occurrence, *, options=None, memory_pool=None)

Find the items corresponding to a given key in a Map.

For a given query key (passed via MapLookupOptions), extract either the FIRST, LAST or ALL items from a Map that have matching keys.

containerArray-like or scalar-like

Argument to compute function.


The key to search for.


The occurrence(s) to return from the Map Accepted values are “first”, “last”, or “all”.

optionspyarrow.compute.MapLookupOptions, optional

Alternative way of passing options.

memory_poolpyarrow.MemoryPool, optional

If not passed, will allocate memory from the default memory pool.