Managing Spaces

Listing the Contents of a Space

gzr space ls [FILTER_SPEC] --host=looker.example.com will retrieve information about a space. The FILTER_SPEC can support multiple types of values.

When the FILTER_SPEC is not included, this command will display the contents of the current user's default home space. This is the user's default space.

When FILTER_SPEC is "~" the space listed will be the user's personal space.

When the FILTER_SPEC is "~123" or "~John Smith", the space listed will be the personal space of user 123 or the user(s) named "John Smith".

When the FILTER_SPEC is a title like "Daily Reports" the spaces will be searched for a space or spaces with that title, and those spaces will be listed.

When the FILTER_SPEC is a number like "100", the space with id 100 will be listed.

The special space id lookml is used to store LookML dashboards. gzr space ls lookml will list LookML dashboards.

Fetching Top Level or Root Spaces

The command gzr space top --host=looker.example.com displays the top level spaces for a server. This will normally be 'Shared' and 'Users' but in "closed systems" there may be others defined.

In version v0.2.36 the command has been enhanced to use support the --fields and --plain options. So in a bash shell the top level space ids can be retrieved and loaded into a bash array like this...

read -d '' -a top_spaces <<< $(gzr space top --host looker.example.com --fields id --plain)
for space_id in "${top_spaces[@]}"; do
  echo "Space ${space_id} is a top space"
done

Display the Space Hierarchy in a Tree

The command gzr space tree [FILTER_SPEC] --host=looker.example.com displays a space and all its subspaces, dashboards, and looks in a tree format. The FILTER_SPEC follows the same rules as for gzr space ls.