更新 Dataform 核心软件包

本文档介绍了如何将 Dataform 核心更新到最新版本。

Dataform Core 是用于使用 SQLX 和 JavaScript 开发 SQL 工作流的开源 Dataform 框架。

当您初始化代码库中的第一个工作区时，Dataform 会自动将 Dataform 核心作为依赖项软件包安装在 package.json 文件中。

我们建议您始终使用 Dataform 核心框架的最新可用版本。如需了解 Dataform 核心框架的版本，请参阅 GitHub 上的 Dataform 版本。

为防止生产环境中的软件包安装出现问题，我们建议您执行以下操作：

• 在 package.json 中明确指定 Dataform 核心软件包版本，例如 3.0.0。不要使用 package.json 的其他 dependencies 选项，例如 >version。

• 在非生产环境中测试新的软件包版本。如需详细了解如何配置不同的代码生命周期环境，请参阅管理代码生命周期。

准备工作

1. 创建代码库。
2. 创建并初始化开发工作区。

所需的角色

如需获取更新 Dataform 所需的权限，请让管理员向您授予工作区的 Dataform Editor (roles/dataform.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

更新 Dataform 核心

1. 在 GitHub 上的 Dataform 版本页面上查找最新版本的 @dataform/core。

2. 在 Google Cloud 控制台中，前往 Dataform 页面。

   转到 Dataform 页面

3. 选择一个代码库，然后选择一个工作区。

4. 在 Files 窗格中，打开 package.json 文件。

5. 按以下格式使用最新的 Dataform 版本更新 @dataform/core 依赖项：

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

   将 VERSION 替换为最新版本的 Dataform，例如 3.0.0。

6. 点击安装软件包。

7. 提交更改。

8. 将更改推送到您的代码库。

以下代码示例显示了在 package.json 文件中更新为 3.0.0 版本的 @dataform/core 依赖项：

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

后续步骤

• 如需了解如何设置 Dataform 权限，请参阅使用 IAM 控制访问权限。
• 如需了解如何配置 Dataform 设置，请参阅配置 Dataform 设置。
• 如需详细了解 Dataform，请参阅 Dataform 概览。