用途:从工作区中永久删除一个连接器,属于 airbyte-agent CLI 的 connectors 子命令。
前提:需在 PATH 中安装 airbyte-agent CLI,可用 brew install airbytehq/tap/airbyte-agent 安装,或参见项目 README。
用法:参数必须通过 --json '{...}' 传入,代理不应使用逐参数标志。按名称删除示例:airbyte-agent connectors delete --json '{"workspace": "my-workspace", "name": "my-source"}';按 ID 删除示例:airbyte-agent connectors delete --json '{"id": ""}'。workspace 可选,若使用 name 时省略,会回退到名为 default 的工作区并在 stderr 打印 JSON 提示;删除前应确认,避免操作错误工作区的连接器。
确认机制:默认在 stderr 提示 Type 'yes' to confirm: 并从 stdin 读取,非精确 yes 即中止。非交互删除有两种方式:一是在 ~/.airbyte-agent/settings.json 中设置 "allow_destructive": true(推荐,需用户明确授权,不要静默开启);二是单次调用环境变量 AIRBYTE_ALLOW_DESTRUCTIVE=true airbyte-agent connectors delete ...。两者都未设置且 stdin 非 TTY 时,命令以 validation_error 拒绝并提示该设置(退出码 4)。
错误恢复:未找到(退出码 3)可运行 connectors list 确认名称;名称歧义(退出码 4)改用 "id": "<uuid>";提示 destructive action requires confirmation but no TTY is available(退出码 4)说明 stdin 非终端且未启用 allow_destructive,请用户授权或改为交互运行;destructive action cancelled by user(退出码 4)表示用户输入非 yes,未经确认不要重试。
限制与注意:删除不可逆,未经用户明确确认不得执行;不要用该命令“重置”连接器凭据,应删除后重建,或通过连接器配置流程直接更新凭据。