edfialliance/data-import

Data Import

概述

Data Import 是一款简化CSV数据加载至 https://docs.ed-fi.org/reference/ods-api 操作数据存储(ODS)的工具。该工具用于处理与Ed-Fi API集成不完善或不存在的场景，例如从州评估系统等遗留数据源导入数据。系统通过提供从基于电子表格的CSV数据文件中提取信息，并转换加载至Ed-Fi ODS / API的方法实现功能。

Data Import旨在匹配教育服务实体选择的Ed-Fi ODS / API操作模型。该解决方案供系统IT管理员和技术数据分析师使用，以满足直接集成API解决方案不存在的地方教育机构(LEA)和州教育机构(SEA)的需求。

Data Import文档可在此处获取：https://docs.ed-fi.org/reference/data-import/

https://api.securityscorecards.dev/projects/github.com/Ed-Fi-Alliance-OSS/Ed-Fi-DataImport/badge](https://securityscorecards.dev/viewer/?uri=github.com/Ed-Fi-Alliance-OSS/Ed-Fi-DataImport)

核心功能与特性

• 通过SFTP、FTPS、网站或手动上传获取CSV文件
• 将CSV映射到Ed-Fi API端点，并将CSV列映射到Ed-Fi属性
• 基于映射将CSV行数据填充到Ed-Fi ODS / API
• 查看导入作业状态和其他详细信息
• 模板共享
  • Data Import允许用户定义模板，将数据源映射到Ed-Fi ODS / API。这些配置模板包含CSV文件到Ed-Fi API端点映射的元数据信息、值替换查找表以及导入作业前所需的Ed-Fi API引导数据。
  • 导入或导出模板文件在Ed-Fi Exchange GitHub的 https://github.com/Ed-Fi-Exchange-OSS/DataImport-Templates 仓库中共享。有关使用和共享的更多信息可在该仓库中找到。

项目概述

Data Import是一个多项目C# .NET解决方案，包含ASP.NET Web管理面板（用于查看数据和作业状态）和作为.NET命令行应用程序的服务器组件（用于处理数据）。Data Import设计为可在本地运行或在Docker容器中运行。

• 本地设置Data Import，请参见 https://github.com/Ed-Fi-Alliance-OSS/Ed-Fi-DataImport/blob/main/docs/build-script.md%E3%80%82
• 在Docker容器中设置Data Import，请参见 https://docs.ed-fi.org/reference/data-import/technical-articles/quick-start-for-data-import-in-docker%E3%80%82

安装要求

前提条件

Data Import 2.3+ 需要 .NET 10

此外，安装和配置Data Import需要熟悉以下技术：

• PowerShell
• Microsoft SQL Server 2016或更高版本
• Postgres 11或更高版本数据库服务器
• SQL Server Management Studio (SSMS)

兼容性与支持的ODS / API版本

Data Import设计用于 Ed-Fi ODS / API v3.1+。Data Import可安装在Ed-Fi ODS / API服务器旁边，也可作为独立应用程序使用。此外，Ed-Fi ODS / API实例必须可从运行Data Import工具的网络访问。

有关ODS / API和版本兼容性的更多详细信息，请参见 https://docs.ed-fi.org/reference/ods-api 部分。

使用Data Import的功能要求

• 需要具有创建目标实体数据访问权限的API密钥和密钥。

• Data Import使用的SQL登录。此登录可使用Windows身份验证或SQL身份验证，并在Data Import安装期间提供。该登录必须分配 dbcreator 角色。

安装

Data Import支持两种安装方法：PowerShell脚本和Docker。

PowerShell安装

PowerShell安装提供了使用PowerShell脚本和简单配置文件安装Data Import的便捷方法。

• 有关安装说明，请根据您要安装的版本参见 https://github.com/Ed-Fi-Alliance-OSS/Ed-Fi-DataImport/blob/main/docs/powershell-installation.md%E3%80%82

Docker部署

• 有关一般Docker部署信息，请参见 https://docs.ed-fi.org/reference/data-import/technical-articles/quick-start-for-data-import-in-docker%E3%80%82

首次配置

有关安装后Data Import的配置过程信息，请参见 https://github.com/Ed-Fi-Alliance-OSS/Ed-Fi-DataImport/blob/main/docs/build-script.md%E3%80%82

快速入门

请参考 https://docs.ed-fi.org/reference/data-import/getting-started/quick-start 验证安装并使用Ed-Fi ODS / API v3.2和Grand Bend示例数据集执行简单的端到端导入。

文档

有关详细文档，请参见 https://docs.ed-fi.org/reference/data-import/%E3%80%82

贡献

Ed-Fi联盟欢迎社区贡献代码。请阅读 https://docs.ed-fi.org/community/sdlc/code-contribution-guidelines/ 了解有关如何贡献源代码的详细信息。

许可

版权所有 (c) 2026 Ed-Fi Alliance, LLC及贡献者。

根据Apache License 2.0（"许可"）授权。

除非适用***要求或书面同意，根据许可分发的软件按"原样"分发，不提供任何明示或暗示的保证或条件。有关许可下的具体权限和限制，请参见许可。

有关其他版权和许可通知，请参见 NOTICES。