容器内执行BigTable cbt import命令时指定参数不生效问题

1. 参数位置错误 #

cbt import record的参数顺序不能随意调整，--workers和--batch-size必须放在表名和源文件路径之后。正确的命令格式应为：

cbt import record <你的表名> <你的源文件路径> --workers=10 --batch-size=2000

如果将参数放在表名或源文件之前，cbt会直接忽略这些自定义配置，转而使用默认值（batch-size默认500，workers默认1）。

2. cbt与cloud-sdk版本不兼容 #

你使用的cloud-sdk版本为504.0.1，安装的google-cloud-cli-cbt可能和该版本存在兼容性问题，导致参数解析逻辑异常。执行cbt version查看cbt具体版本，确认该版本是否存在参数解析的已知bug——部分旧版本的cbt对--workers和--batch-size的支持不完善，会直接跳过自定义参数。

3. ~/.cbtrc配置覆盖命令行参数 #

检查~/.cbtrc文件，若其中存在batch_size或workers的全局配置项，cbt会优先使用配置文件中的值，而非命令行传入的参数。可以暂时重命名~/.cbtrc后重新执行命令，验证是否是这个原因导致参数未生效。

4. 服务账号权限/配额限制（间接影响） #

虽然权限不直接控制参数生效，但如果服务账号没有足够的并发写入权限，或触发了BigTable的配额限制，cbt会自动降级为单worker模式，同时将batch-size调整为默认值。检查服务账号是否拥有bigtable.tables.mutateRows、bigtable.tables.read等必要权限，同时确认是否存在配额限制。

5. 导入源文件格式异常 #

如果你的导入源文件格式不规范（比如单行数据过大、格式不符合要求），cbt会自动调整batch-size和worker数量，避免导入失败。可以使用一个符合格式要求的小测试文件执行导入命令，验证参数是否能正常生效。

内容的提问来源于stack exchange，提问作者peakit