{"id":19381759,"url":"https://github.com/taosdata/taos-connector-dotnet","last_synced_at":"2025-04-23T20:32:00.332Z","repository":{"id":39432153,"uuid":"485243264","full_name":"taosdata/taos-connector-dotnet","owner":"taosdata","description":"TDengine connector for .Net","archived":false,"fork":false,"pushed_at":"2025-03-24T10:49:27.000Z","size":828,"stargazers_count":25,"open_issues_count":22,"forks_count":7,"subscribers_count":24,"default_branch":"3.0","last_synced_at":"2025-04-02T19:47:03.279Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taosdata.png","metadata":{"files":{"readme":"README-CN.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-25T06:05:59.000Z","updated_at":"2025-03-24T10:49:28.000Z","dependencies_parsed_at":"2024-04-28T06:33:49.855Z","dependency_job_id":"9e26d87d-d816-4a11-83dd-17206d016bbc","html_url":"https://github.com/taosdata/taos-connector-dotnet","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Ftaos-connector-dotnet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Ftaos-connector-dotnet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Ftaos-connector-dotnet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Ftaos-connector-dotnet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taosdata","download_url":"https://codeload.github.com/taosdata/taos-connector-dotnet/tar.gz/refs/heads/3.0","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250509718,"owners_count":21442483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T09:18:17.653Z","updated_at":"2025-04-23T20:32:00.325Z","avatar_url":"https://github.com/taosdata.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- omit in toc --\u003e\r\n# TDengine C# Connector\r\n\u003c!-- omit in toc --\u003e\r\n\r\n[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/taosdata/taos-connector-dotnet/build.yml)](https://github.com/taosdata/taos-connector-dotnet/actions/workflows/build.yml)\r\n[![codecov](https://codecov.io/gh/taosdata/taos-connector-dotnet/graph/badge.svg?token=U30JZYDGMS)](https://codecov.io/gh/taosdata/taos-connector-dotnet)\r\n![GitHub commit activity](https://img.shields.io/github/commit-activity/m/taosdata/taos-connector-dotnet)\r\n![GitHub License](https://img.shields.io/github/license/taosdata/taos-connector-dotnet)\r\n[![NuGet Version](https://img.shields.io/nuget/v/TDengine.Connector)](https://www.nuget.org/packages/TDengine.Connector)\r\n\u003cbr /\u003e\r\n[![Twitter Follow](https://img.shields.io/twitter/follow/tdenginedb?label=TDengine\u0026style=social)](https://twitter.com/tdenginedb)\r\n[![YouTube Channel](https://img.shields.io/badge/Subscribe_@tdengine--white?logo=youtube\u0026style=social)](https://www.youtube.com/@tdengine)\r\n[![Discord Community](https://img.shields.io/badge/Join_Discord--white?logo=discord\u0026style=social)](https://discord.com/invite/VZdSuUg4pS)\r\n[![LinkedIn](https://img.shields.io/badge/Follow_LinkedIn--white?logo=linkedin\u0026style=social)](https://www.linkedin.com/company/tdengine)\r\n[![StackOverflow](https://img.shields.io/badge/Ask_StackOverflow--white?logo=stackoverflow\u0026style=social\u0026logoColor=orange)](https://stackoverflow.com/questions/tagged/tdengine)\r\n\r\n[English](README.md) | 简体中文\r\n\r\n\u003c!-- omit in toc --\u003e\r\n## 目录\r\n\u003c!-- omit in toc --\u003e\r\n\r\n- [1. 简介](#1-简介)\r\n- [2. 文档](#2-文档)\r\n- [3. 前置条件](#3-前置条件)\r\n- [4. 构建](#4-构建)\r\n- [5. 测试](#5-测试)\r\n  - [5.1 运行测试](#51-运行测试)\r\n  - [5.2 添加用例](#52-添加用例)\r\n  - [5.3 性能测试](#53-性能测试)\r\n- [6. CI/CD](#6-cicd)\r\n- [7. 提交 Issue](#7-提交-issue)\r\n- [8. 提交 PR](#8-提交-pr)\r\n- [9. 引用](#9-引用)\r\n- [10. 许可证](#10-许可证)\r\n\r\n## 1. 简介\r\n\r\n`TDengine.Connector` 是 TDengine 提供的 C# 语言连接器。C# 开发人员可以通过它开发存取 TDengine 集群数据的 C# 应用软件。\r\n\r\n## 2. 文档\r\n\r\n- 使用 C# Connector, 请参考 [开发指南](https://docs.taosdata.com/develop/)，包含了应用如何引入 `TDengine.Connector` 和数据写入、查询、无模式写入、参数绑定和数据订阅等示例。\r\n- 其他参考信息请看 [参考手册](https://docs.taosdata.com/reference/connector/csharp/)，包含了版本历史、数据类型、示例程序汇总、API 说明和常见问题等。\r\n- 本README主要是为想自己贡献、编译、测试 C# Connector的开发者写的。如果要学习 TDengine，可以浏览 [官方文档](https://docs.taosdata.com/)。\r\n\r\n## 3. 前置条件\r\n\r\n- 安装 [.NET SDK 6.0](https://dotnet.microsoft.com/download/dotnet/6.0)\r\n- [Nuget 客户端](https://docs.microsoft.com/en-us/nuget/install-nuget-client-tools)\r\n- 本地已经部署 TDengine，具体步骤请参考 [部署服务端](https://docs.taosdata.com/get-started/package/)，且已经启动 taosd 与 taosAdapter。\r\n\r\n## 4. 构建\r\n\r\n项目目录下执行 `dotnet restore` 还原项目依赖，然后执行 `dotnet build --no-restore` 构建项目。\r\n\r\n## 5. 测试\r\n\r\n### 5.1 运行测试\r\n\r\n1. 执行测试前确保已经安装 TDengine 服务端，并且已经启动 taosd 与 taosAdapter，数据库干净无数据。\r\n2. 项目目录下执行 `dotnet test` 运行测试，测试会连接到本地的 TDengine 服务器与 taosAdapter 进行测试。\r\n3. 测试成功会打印 `Test Run Successful`，测试失败会打印失败信息 `Test Run Failed`。\r\n\r\n### 5.2 添加用例\r\n\r\n在 `test` 目录下添加测试用例，ADO.NET 的测试用例添加到 `test/Data.Tests`，客户端驱动的测试用例添加到 `test/Driver.Test/Client`。\r\n用例使用 xunit 框架。\r\n\r\n### 5.3 性能测试\r\n\r\n性能测试还在开发中。\r\n\r\n## 6. CI/CD\r\n\r\n- [Build Workflow](https://github.com/taosdata/taos-connector-dotnet/actions/workflows/build.yml)\r\n- [Code Coverage](https://app.codecov.io/gh/taosdata/taos-connector-dotnet)\r\n\r\n## 7. 提交 Issue\r\n\r\n我们欢迎提交 [GitHub Issue](https://github.com/taosdata/taos-connector-dotnet/issues/new?template=Blank+issue)。 提交时请说明下面信息：\r\n\r\n- 问题描述，是否必现。\r\n- 驱动版本。\r\n- 连接参数（不需要服务器地址、用户名和密码）。\r\n- TDengine 版本。\r\n\r\n## 8. 提交 PR\r\n\r\n我们欢迎开发者一起开发本项目，提交 PR 时请参考下面步骤：\r\n\r\n1. Fork 本项目，请参考 ([how to fork a repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo))\r\n2. 从 main 分支创建一个新分支，请使用有意义的分支名称 (`git checkout -b my_branch`)。\r\n3. 修改代码，保证所有单元测试通过，并增加新的单元测试验证修改。\r\n4. 提交修改到远端分支 (`git push origin my_branch`)。\r\n5. 在 GitHub 上创建一个 Pull\r\n   Request ([how to create a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request))。\r\n6. 提交 PR 后，可以通过 [Pull Request](https://github.com/taosdata/taos-connector-dotnet/pulls) 找到自己的 PR，点击对应链接进去可以看到自己 PR CI 是否通过，如果通过会显示 “All checks have passed”。无论 CI 是否通过，都可以点击 “Show all checks” -\u003e “Details” 来查看详细用例日志。\r\n7. 提交 PR 后，如果 CI 通过，可以在 [codecov](https://app.codecov.io/gh/taosdata/taos-connector-dotnet/pulls) 页面找到自己 PR 查看覆盖率。\r\n\r\n## 9. 引用\r\n\r\n- [TDengine 官网](https://www.taosdata.com/)\r\n- [TDengine GitHub](https://github.com/taosdata/TDengine)\r\n\r\n## 10. 许可证\r\n\r\n[MIT License](./LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaosdata%2Ftaos-connector-dotnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaosdata%2Ftaos-connector-dotnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaosdata%2Ftaos-connector-dotnet/lists"}