用途:在仓库中运行与排查 community-domo-cli 命令,基于当前锁定的端点范围进行 Domo Product API 操作。
安装与运行:推荐用户执行 pipx install "git+https://github.com/stahura/community-domo-cli.git",然后 community-domo-cli --help。贡献者/测试路径为 python3 -m pip install -e .,再运行 community-domo-cli --help;本地开发可用 python3 -m community_domo_cli --help。
认证设置(Ryuu 会话):先安装 Domo CLI 并登录一次:npm install -g ryuu、domo login -i modocorp.domo.com,然后设置环境变量 export DOMO_INSTANCE=modocorp、export DOMO_AUTH_MODE=ryuu-session,之后可运行 community-domo-cli datasets list。CLI 读取 ~/.config/configstore/ryuu/<instance>.json 的登录文件,并复用 domo login 的刷新/会话行为。
主要能力:当前支持的命令面包括 datasets list、datasets schema <dataset_id>、datasets sql <dataset_id> --body/--body-file;appdb collections、appdb collection-get <collection_id>、appdb document-create <collection_id> --body/--body-file;code-engine get-package <package_id>、code-engine create-package --body/--body-file、code-engine update-version <package_id> <version> --body/--body-file;workflows get <workflow_id>;filesets get <fileset_id>、filesets file-get <fileset_id> <file_id>、filesets upload <fileset_id> --body/--body-file、filesets download <fileset_id> <file_id> --output <path>。
实现约束:Product API 基础地址为 https://<instance>.domo.com/api,CLI 已处理 /api;不支持删除操作;不存在原始透传命令;变更操作应先使用 --dry-run 验证负载。
排查要点:优先使用 community-domo-cli ... 调用方式,python3 -m community_domo_cli ... 主要用于本地贡献者测试,不要运行 python3 community_domo_cli ...;确认 DOMO_INSTANCE 与 DOMO_AUTH_MODE=ryuu-session 已设置,且已成功为目标实例运行 domo login;确认标识符类型,datasets 命令使用 dataset UUID,filesets 命令使用 fileset UUID 与 file UUID;遇到 400/404 时先用已知可用的 GET 重试,如 datasets list 或 appdb collections;变更调用先用 --dry-run 验证负载。
适用场景:需要以命令行方式查询或操作 Domo 数据集、AppDB、Code Engine、工作流与文件集时。限制:仅覆盖上述命令面,无删除与原始透传能力;具体收费、价格、平台与效果信息暂未提供。响应风格要求简洁具体,优先给出确切命令与直接修复方式。