farosai/airbyte-workday-source

Airbyte Workday 数据源连接器镜像

概述

该镜像为Airbyte数据集成平台提供Workday数据源连接器，用于从Workday企业云应用系统（涵盖人力资源、财务、供应链等模块）提取数据，支持与各类目标系统（如数据仓库、BI工具、数据库等）集成，实现数据的自动化同步与流转。

核心功能与特性

• 多模块数据提取：支持Workday核心业务模块数据提取，包括员工信息、组织架构、薪资数据、财务交易等
• 增量同步：支持基于时间戳或游标进行增量数据同步，减少数据传输量并提高同步效率
• 标准API集成：通过Workday REST API进行数据交互，确保数据提取的稳定性与合规性
• 灵活配置：支持自定义同步频率、数据范围及字段筛选，满足不同业务场景需求
• 认证安全：支持Workday API标准认证方式（如API客户端ID/密钥），保障数据传输安全

使用场景

• 企业数据集成：将Workday业务数据同步至数据仓库（如***、BigQuery）进行集中管理
• 数据分析与报表：为BI工具（如Tableau、Power BI）提供Workday数据支撑，实现业务指标可视化
• 跨系统数据流转：与HR系统、财务系统等其他企业应用进行数据互通
• 数据备份与归档：定期备份Workday关键业务数据，满足合规与审计需求

使用方法与配置说明

前置条件

1. 已部署Airbyte平台（v0.40.0+版本）
2. 拥有Workday租户访问权限及API凭证（包括租户ID、API客户端ID、API密钥）
3. 确保网络环境允许Airbyte服务访问Workday API端点（通常为https://<tenant>.workday.com）

配置步骤

1. 在Airbyte平台中创建新的"Source"，选择"Workday"连接器类型
2. 输入基础配置信息：
   • 租户ID：Workday租户标识符（如your-tenant）
   • API客户端ID：Workday API应用的客户端ID
   • API密钥：Workday API应用的密钥
   • API端点：Workday API服务地址（默认：https://<tenant>.workday.com/ccx/service/<tenant>/）
3. 配置数据同步参数：
   • 同步模式：全量同步或增量同步
   • 数据实体：选择需同步的Workday实体（如Worker、Organization、Position等）
   • 同步频率：设置数据同步周期（如每小时、每天）
4. 测试连接并保存配置，随后可与目标系统（Destination）建立数据同步任务

环境变量说明

该连接器可通过以下环境变量进行高级配置（适用于自定义部署场景）：

• WORKDAY_API_TIMEOUT：API请求超时时间（默认：300秒）
• WORKDAY_PAGE_SIZE：单次API请求返回数据条数（默认：100条）
• LOG_LEVEL：日志级别（可选：DEBUG、INFO、WARN、ERROR，默认：INFO）

Docker部署示例（独立运行场景）

若需独立测试该连接器，可通过以下Docker命令运行：

bash
docker run -d \
  --name airbyte-workday-source \
  -e WORKDAY_TENANT_ID=your-tenant \
  -e WORKDAY_CLIENT_ID=your-client-id \
  -e WORKDAY_CLIENT_SECRET=your-client-secret \
  -e WORKDAY_API_ENDPOINT=https://your-tenant.workday.com/ccx/service/your-tenant/ \
  airbyte/source-workday:latest

注意事项

• Workday API存在调用频率限制，建议根据租户规模合理设置同步频率
• 首次全量同步可能耗时较长，建议在非业务高峰期执行
• 敏感字段（如薪资、身份证信息）需在目标系统中配置数据脱敏策略，确保合规性