Skip to main content
On this page

Kater CLI Explore and try ideas explore definition

kater explore definition

Reads and saves a shared model's Explore file: its questions, and the plans that answer them.

The file sits beside the model, in explore/<type>/<name>.explore.yaml. For ad_reporting, it is modeling/kater_objects/semantic_models/marts/explore/semantic/ad_reporting.explore.yaml.

Commands

CommandWhat it does
kater explore definition showShow a model’s Explore questions and saved plans.
kater explore definition generateSave a model’s Explore questions and plans.

Where the questions come from

Before the file is saved, a model’s questions are the ones its authors wrote. These are the model’s own business questions, and those of its fields. A question that two fields ask comes once. With --llm, an AI model plans questions and adds new ones.

Examples

Terminal window
# Show the Explore questions and plans of the ad_reporting model
kater explore definition show --model semantic.ad_reporting --scope connections/snowflake_prod_connection/modeling
# Save its Explore file again, and plan up to two questions with an AI model
kater explore definition generate --model semantic.ad_reporting \
--scope connections/snowflake_prod_connection/modeling \
--expected-revision 546c87e5d0d229965dc939b1d7b152aac6762c15e61884fd20b75ba2c7b1b37a --llm

See also