CLI: public datasets and support
Discover without signing in
Section titled “Discover without signing in”mr-data public search "weather" --limit 10 --jsonmr-data public show DATASET_SLUG --jsonmr-data public tables DATASET_SLUG --jsonmr-data public schema PUBLIC_TABLE_ID --jsonmr-data public sample PUBLIC_TABLE_ID --jsonmr-data public fetch DATASET_SLUG --jsonsearch finds published datasets, show reads an overview, tables returns table identifiers, schema describes columns, and sample reads published preview rows. fetch returns the dataset’s Markdown. lookup "QUERY" returns the connector search shape. These seven commands need no login.
Use --topic, --limit and --cursor with catalog search. A catalog match does not mean a row matched: use search query to search inside a table. A preview is a sample, not the complete dataset.
Read with your workspace
Section titled “Read with your workspace”mr-data loginmr-data public query PUBLIC_TABLE_ID --body-file query.json --jsonmr-data public download-url PUBLIC_TABLE_ID --jsonquery.json uses the Public Dataset API query grammar. Inline JSON can be passed with --body instead. download-url returns download instructions; it does not stream table bytes through the CLI. Treat returned authorized URLs as credentials.
Connect a dataset
Section titled “Connect a dataset”mr-data connected list --jsonmr-data connected add DATASET_SLUG --jsonBoth use the active workspace and require login. add changes the workspace’s connected dataset list; it does not copy or rebuild the dataset.
Ask for support
Section titled “Ask for support”mr-data ask "Why did this run fail?" --run RUN_ID --jsonmr-data ask "What does this refusal mean?" --failure-code CODE --no-wait --jsonmr-data ask status QUESTION_ID --jsonThe support agent must be enabled for the workspace. THIN_CLOUD_SUPPORT_AGENT_DISABLED is a final refusal, not a reason to keep retrying. The agent may file a problem and return an SR-N reference. Keep that reference with the run ID when reporting a platform fault.