如何通过wrench CLI连接Docker部署的Cloud Spanner本地模拟器

前置检查 #

• 确认Spanner模拟器容器启动时已正确映射端口，默认模拟器监听9010端口，Docker启动命令需包含-p 127.0.0.1:9010:9010参数
• 确认本地已正确安装wrench CLI工具

连接步骤 #

1. 设置模拟器连接环境变量，告诉wrench优先连接本地模拟器而非GCP官方云服务：

export SPANNER_EMULATOR_HOST=localhost:9010
# 模拟器不需要真实GCP凭证，可自定义占位的项目、实例、数据库名称
export GCP_PROJECT=test-demo-project
export SPANNER_INSTANCE=test-demo-instance
export SPANNER_DATABASE=test-demo-db

2. 初始化模拟器内的Spanner实例：
   wrench create-instance
   可根据需要追加--instance-config、--nodes等参数调整实例配置，测试场景用默认配置即可。
3. 创建对应数据库（如有本地schema文件可直接指定导入）：
   wrench create --schema-file ./your-schema-file.sql
4. 验证连接是否正常：
   wrench exec "SELECT 1 AS test_result"
   如果返回如下类似结果则说明连接成功：

test_result #

1

额外使用提示 #

• 若不想全局配置环境变量，可在每次执行wrench命令时临时传入参数，示例：
  SPANNER_EMULATOR_HOST=localhost:9010 GCP_PROJECT=test-demo-project SPANNER_INSTANCE=test-demo-instance SPANNER_DATABASE=test-demo-db wrench exec "SELECT 1"
• 建议使用最新版wrench CLI，避免出现模拟器兼容性问题。

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