Skip to main content
On this page

Kater CLI Explore and try ideas explore card

kater explore card

Makes, changes, runs and saves Explore cards.

A card is a chart and the query that answers its question, over one shared model. A card is not saved until kater explore card add puts it in a workspace. Each command takes its request as JSON in --request-file, as Cards describes.

Commands

CommandWhat it does
kater explore card createMake a card from fields you pick on a shared model.
kater explore card showShow a card’s query, chart and next questions.
kater explore card previewRun one card on the warehouse and wait for its chart.
kater explore card preview-allRun up to 40 cards at once and wait for every chart.
kater explore card addSave cards to a workspace as queries and charts.
kater explore card editChange a card’s fields, chart or inputs.
kater explore card openOpen a card’s query in the Sandbox.

Examples

Terminal window
# Make a card of spend by platform from the request in new-card.json
kater explore card create --request-file new-card.json
# Show a card's SQL, chart and next questions
kater explore card show --request-file card.json
# Run the card on the warehouse and wait for its chart
kater explore card preview --request-file card.json
# Save cards to a workspace as queries and charts
kater explore card add --request-file add.json

See also