English | 简体中文
TDengine.Connector 是 TDengine 提供的 C# 语言连接器。C# 开发人员可以通过它开发存取 TDengine 集群数据的 C# 应用软件。
- 使用 C# Connector, 请参考 开发指南，包含了应用如何引入
TDengine.Connector和数据写入、查询、无模式写入、参数绑定和数据订阅等示例。 - 其他参考信息请看 参考手册，包含了版本历史、数据类型、示例程序汇总、API 说明和常见问题等。
- 本README主要是为想自己贡献、编译、测试 C# Connector的开发者写的。如果要学习 TDengine，可以浏览 官方文档。
dotnet restore还原项目依赖。dotnet build --no-restore构建项目。
- 执行测试前确保已经安装 TDengine 服务端，并且已经启动 taosd 与 taosAdapter，数据库干净无数据。
- 项目目录下执行
dotnet test运行测试，测试会连接到本地的 TDengine 服务器与 taosAdapter 进行测试。 - 测试成功会打印
Test Run Successful，测试失败会打印失败信息Test Run Failed。
在 test 目录下添加测试用例，ADO.NET 的测试用例添加到 test/Data.Tests，客户端驱动的测试用例添加到 test/Driver.Test/Client。
用例使用 xunit 框架。
性能测试还在开发中。
我们欢迎提交 GitHub Issue。 提交时请说明下面信息：
- 问题描述，是否必现。
- 驱动版本。
- 连接参数（不需要服务器地址、用户名和密码）。
- TDengine 版本。
我们欢迎开发者一起开发本项目，提交 PR 时请参考下面步骤：
- Fork 本项目，请参考 (how to fork a repo)
- 从 main 分支创建一个新分支，请使用有意义的分支名称 (
git checkout -b my_branch)。 - 修改代码，保证所有单元测试通过，并增加新的单元测试验证修改。
- 提交修改到远端分支 (
git push origin my_branch)。 - 在 GitHub 上创建一个 Pull Request (how to create a pull request)。
- 提交 PR 后，可以通过 Pull Request 找到自己的 PR，点击对应链接进去可以看到自己 PR CI 是否通过，如果通过会显示 “All checks have passed”。无论 CI 是否通过，都可以点击 “Show all checks” -> “Details” 来查看详细用例日志。
- 提交 PR 后，如果 CI 通过，可以在 codecov 页面找到自己 PR 查看覆盖率。