dbt-core软件适配GaussDB开源开发任务
1 背景介绍
开源for Huawei(参考:https://developer.huaweicloud.com/programs/opensource/contributing/) 通过和公司、高校、社区的开发者合作,完成鲲鹏、昇腾、欧拉、鸿蒙、高斯、云服务等与开源软件的适配开发,帮助繁荣Huawei的基础生态,同时让开源软件能够更加简单、高效的运行于华为云上。
开始之前,开发者可以下载 开源for Huawei Wiki(参考:https://gitcode.com/HuaweiCloudDeveloper/OpenSourceForHuaweiWiki/overview) 了解详细的开发步骤,技术准备,以及开发过程需要的各种资源。
2 需求分析
2.1 项目影响力
dbt-core 是一个用于数据建模和转化的开源工具(https://github.com/dbt-labs/dbt-core
),它帮助分析师和数据工程师将数据转换为可用的信息。
项目数据:Fork 1.6K, Star 9.7K, Contributor 312
star历史(https://star-history.com/):
2.2 任务目的和范围
本任务的主要目的是让 dbt-core 社区支持 GaussDB(DWS)。这一举措旨在拓展GaussDB(DWS) 的影响力,同时为 dbt-core 用户提供更灵活的数据库选择,使其能够轻松使用 GaussDB(DWS)。
适配任务清单
生态 |
生态细类 |
是否需要验证 |
验证逻辑说明 |
是否需要适配 |
适配场景说明 |
昇腾生态 |
指令 |
否 |
使用昇腾处理器运行应用。 |
否 |
使用昇腾指令实现适配逻辑。 |
CANN |
否 |
应用功能依赖于CANN运行。 |
否 |
使用CANN实现适配逻辑。 |
|
MindSpore |
否 |
应用功能依赖于MindSpore运行。 |
否 |
使用MindSpore实现适配逻辑。 |
|
鲲鹏生态 |
指令 |
是 |
使用鲲鹏处理器运行应用。 |
否 |
使用鲲鹏指令实现适配逻辑。 |
Euler |
是 |
使用Euler系统运行应用。 |
否 |
使用Euler系统调用实现适配逻辑。 |
|
数据库生态 |
GaussDB |
是 |
使用GaussDB功能。 |
是 |
使用GaussDB的驱动和SQL实现适配逻辑。 |
|
GaussDB(DWS) |
否 |
使用GaussDB(DWS)功能。 |
否 |
使用GaussDB(DWS)的驱动和SQL实现适配逻辑。 |
存储生态 |
OBS |
否 |
使用OBS功能。 |
否 |
基于OBS API访问实现适配逻辑。 |
鸿蒙生态 |
HarmonyOS |
否 |
使用HarmonyOS系统运行应用。 |
否 |
使用HarmonyOS系统调用实现适配逻辑。 |
3 工作量评估和任务分解
3.1 工作量评估
任务 |
人/天 |
完成GaussDB数据库适配功能开发 |
3 |
完成DEMO设计和功能验证 |
5 |
基于CCE容器完成环境搭建和DEMO验证 |
2 |
输出开发资料和博客 |
1 |
代码推送上游社区和发布版本 |
2 |
总计 |
13人天 |
3.2 完成GaussDB数据库适配功能开发
- 在GitCode完成项目Fork(https://github.com/dbt-labs/dbt-postgres 这是dbt-core对PostgresDB数据的一个依赖库,为了适配 GaussDB 可参考这个库来完成适配),并完成与 GaussDB(DWS) 适配需要的脚本和代码开发。
- 分析 GaussDB 支持的 SQL 语法,调整 SQL 以确保兼容性。例如,使用 GaussDB 支持的函数和表达式,确保 dbt-core 中使用的 SQL 函数和表达式能够在 GaussDB 中正常工作,必要时进行替换。
3.3 完成GaussDB演示DEMO设计
DEMO在resource-server-python中完成, https://docs.getdbt.com/docs/core/connect-data-platform/postgres-setup 的例子开发任务,https://docs.getdbt.com/reference/resource-configs/postgres-configs 可参考该链接完成简单的demo。大概流程如下:
- 通过本地 GaussDB 作为数据源,通过 dbt-core 将数据转换成 GaussDB(DWS)适用的数据,通过 GaussDB(DWS) 的API上传数据
- GaussDB(DWS) 接收到转换后的数据,利用 GaussDB(DWS) 高效的数据加载、转换和查询性能等优势,生成目标数据
- 最后,通过RESTful API操作数据库供前端使用。
DEMO的简单部署图如下:
3.4 DEMO开发、部署和验证
根据DEMO设计,完成演示功能开发和部署。要求使用CCE容器(Euler镜像)进行部署。
3.5 在华为云开发者论坛输出博客
访问华为云开发者论坛(参考:https://bbs.huaweicloud.com/blogs)发表博客,介绍完成这些任务的过程和心得。包括如下内容:dbt-core和GaussDB(DWS)功能介绍;安装部署指导;验证DEMO功能等。
3.6 代码推送上游社区
将代码合并到 dbt-core 官网主干代码;更新 dbt-core 官网资料,包括版本说明、开发指南等。
4 验收材料
验收细则 |
评分说明 |
是否为验收必选项 |
结果(通过/不通过) |
开发者举证 |
功能开发:完成与华为三大根技术生态(鲲鹏云、昇腾云、鸿蒙)适配的功能开发 |
完成GaussDB数据库适配功能开发。举证提供PR链接。 |
是 |
||
代码质量:适配华为三大根技术生态的代码质量经过工具检测达标 |
推送给开源社区的代码符合开源社区关于代码风格、功能、自动化测试等要求。 |
是 |
||
提供相关文档,比如部署文档、使用文档、配置文档等 |
根据社区要求,完善相关的开发指南和部署指导 |
否 |
||
合入到开源项目主仓:代码推送上游社区 |
代码合并到当前主干分支。举证提供代码仓库链接。 |
是 |
||
Deomo设计&开发:完成功能演示Demo的开发 |
举证提供DEMO仓库地址和DEMO开发提交记录。 |
是 |
||
Demo部署&验证:完成功能演示DEMO基于华为云鲲鹏环境的部署和功能验证 |
提供DEMO部署验证结果的关键截图进行举证。提供DEMO运行环境和资源的规格清单。 |
是 |
||
发布博客:发布博客介绍适配心得。 |
提供博客的地址。 |
是 |
||
制作单机版无高危开源镜像。 |
上架云商店。 |
否 |
||
单机版镜像上架时支持模板部署。 |
否 |
|||
制作集群版无高危开源镜像 |
上架云商店。 |
否 |
||
集群版镜像上架时支持模板部署 |
否 |
5 参考资料
- 开源for Huawei介绍、环境搭建、示例项目、开发和部署指南:https://gitcode.com/HuaweiCloudDeveloper/OpenSourceForHuaweiWiki/overview
- 点赞
- 收藏
- 关注作者
评论(0)