Microsoft Data Connectors SDK 指南

本指南将带您深入了解微软的 DataConnectors 开源项目，该项目提供了SDK和样例代码，用于构建Power Query和Power BI的数据连接器。下面是关于项目的核心组成部分，包括目录结构、启动文件以及配置文件的详细介绍。

1. 项目的目录结构及介绍

Microsoft的DataConnectors仓库采用了一种组织良好的目录结构，便于开发者快速理解和上手：

• 根目录:

  • CODE_OF_CONDUCT.md: 规定了贡献者的行为准则。
  • LICENSE: 显示该项目遵循的MIT开放源代码许可协议。
  • README.md: 项目的主要说明文档，包含了如何开始、更新日志和重要资源的链接。
  • SECURITY.md: 关于项目安全政策的信息。

• 核心组件:

  • PowerQuerySdk: 包含了开发Power Query连接器所需的SDK代码，可能以.vsix形式提供Visual Studio Code扩展。
  • docs: 文档资料，帮助理解如何使用SDK。
  • samples: 示例项目，展示了如何创建数据连接器的基本框架。
  • testframework: 测试框架相关文件，确保你的连接器按预期工作。

• 常规文件:

  • .gitattributes, .gitignore, .gitmodules: 版本控制相关的配置文件。

每个子目录内部通常包含具体实现文件，如源码、测试案例、图标和其他资源文件，具体到每个连接器的逻辑实现在对应的sample中详细展示。

2. 项目的启动文件介绍

在DataConnectors项目中，并没有传统意义上的“启动文件”作为应用入口点，因为这个项目主要是SDK和工具集。不过，对于开发者来说，关键的入手点可能是创建一个新的数据连接器项目。这通常通过以下步骤开始：

• 使用VS Code安装新的Power Query SDK扩展（基于提供的指导）。
• 在VS Code中创建一个新项目，参照samples目录下的示例来定义你的连接器逻辑。

因此，从开发流程的角度看，PowerQuerySdk.vsix可以视为“启动”开发环境的关键组件之一，虽然它并不是程序运行时的启动文件。

3. 项目的配置文件介绍

项目中的配置主要体现在几个方面：

• 项目级配置: 对于数据连接器本身，配置更多地是通过M语言脚本来指定，比如在samples内的脚本定义数据源的属性、认证方式等。
• 开发环境配置: 开发过程中，可能需要在Power BI Desktop设置中调整安全性选项，允许加载未经签名的扩展（为了开发测试之需）。
• 特定连接器配置: 连接器的配置信息通常嵌入在M语言函数中或通过.md文件说明，例如在samples里的各个HelloWorld示例，配置了数据源的标签、图标等。

总之，在DataConnectors项目中，配置并非集中在一个特定的配置文件中，而是分散在项目的多个部分，尤其是M语言脚本和示例代码里，这些构成了连接器特性和行为的定制化配置。开发者应当仔细阅读每个示例代码以及官方文档来理解配置细节。