按Google Dataform快速入门操作时遇执行按钮无法点击及@dataform/core转译器错误

问题详情 #

按照Google官方Dataform快速入门示例操作，执行工作流时无法点击「Start execution」按钮，右侧面板提示错误：

Failed to find the transpiler exported from @dataform/core. Ensure packages are installed and upgrade to a recent version.

尝试添加以下package.json文件后，问题仍未解决：

{
    "dependencies": {
        "@dataform/core": "1.6.2"
    }
}

错误截图：

• 右侧错误提示面板
• 工作流执行界面（按钮不可点击）

解决步骤 #

• 升级@dataform/core到兼容版本：1.6.2版本过于老旧，与当前Dataform控制台版本存在兼容性问题。建议升级至最新稳定版，修改package.json如下：

{
    "dependencies": {
        "@dataform/core": "^2.0.0"
    }
}

可参考Dataform官方文档确认当前推荐的最低兼容版本。

• 重新安装依赖：修改package.json后，在Dataform控制台的项目管理区域找到「Install dependencies」按钮执行安装；若使用CLI，运行以下命令：

dataform install

• 同步配置文件版本：检查项目根目录下的dataform.json，确保coreVersion字段与package.json中的版本一致，示例：

{
  "defaultDatabase": "你的数据库名称",
  "defaultSchema": "你的Schema名称",
  "projectId": "你的GCP项目ID",
  "coreVersion": "2.0.0"
}

• 清除缓存并刷新项目：刷新Dataform控制台页面，或点击「Reload project」选项，清除本地缓存后重新加载项目配置。

• 验证权限与项目关联：确认操作账号拥有Dataform项目的编辑权限，且项目已正确关联到对应的GCP项目，避免因权限问题导致依赖安装失败。

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