TDengine.Connector 3.1.6

.NET 5.0 This package targets .NET 5.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. .NET Framework 4.5 This package targets .NET Framework 4.5. The package is compatible with this framework or higher. 
dotnet add package TDengine.Connector --version 3.1.6                

                    
                

            
NuGet\Install-Package TDengine.Connector -Version 3.1.6
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="TDengine.Connector" Version="3.1.6" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add TDengine.Connector --version 3.1.6                

                    
                

            
#r "nuget: TDengine.Connector, 3.1.6"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install TDengine.Connector as a Cake Addin
#addin nuget:?package=TDengine.Connector&version=3.1.6

// Install TDengine.Connector as a Cake Tool
#tool nuget:?package=TDengine.Connector&version=3.1.6

TDengine C# Connector

GitHub Actions Workflow Status codecov GitHub commit activity GitHub License NuGet Version <br /> Twitter Follow YouTube Channel Discord Community LinkedIn StackOverflow

English | 简体中文

Table of Contents

1. Introduction

TDengine.Connector is the C# language connector provided by TDengine. C# developers can use it to develop C# application software that accesses TDengine cluster data.

2. Documentation

  • To use C# connector, please check Developer Guide, which includes how an application can introduce the TDengine.Connector, as well as examples of data writing, querying, schemaless writing, parameter binding, and data subscription.
  • For other reference information, please check Reference Manual, which includes version history, data types, example programs, API descriptions, and FAQs.
  • This quick guide is mainly for developers who like to contribute/build/test the C# connector by themselves. To learn about TDengine, you can visit the official documentation.

3. Prerequisites

4. Build

  1. dotnet restore Restore the project's dependencies.
  2. dotnet build --no-restore Build the project.

5. Testing

5.1 Test Execution

  1. Before running tests, ensure that the TDengine server is installed and that taosd and taosAdapter are running. The database should be empty.
  2. In the project directory, run dotnet test to execute the tests. The tests will connect to the local TDengine server and taosAdapter for testing.
  3. If the tests pass, Test Run Successful will be printed. If the tests fail, the failure information Test Run Failed will be printed.

5.2 Test Case Addition

Add test cases in the test directory. Add ADO.NET test cases to test/Data.Tests and client driver test cases to test/Driver.Test/Client. The test cases use the xunit framework.

5.3 Performance Testing

Performance testing is in progress.

6. CI/CD

7. Submitting Issues

We welcome the submission of GitHub Issue. When submitting, please provide the following information:

  • Description of the issue and whether it is consistently reproducible
  • Driver version
  • Connection parameters (excluding server address, username, and password)
  • TDengine version

8. Submitting PRs

We welcome developers to contribute to this project. Please follow the steps below to submit a PR:

  1. Fork this project. Please refer to how to fork a repo.
  2. Create a new branch from the main branch with a meaningful branch name (git checkout -b my_branch).
  3. Modify the code, ensure all unit tests pass, and add new unit tests to verify the changes.
  4. Push the changes to the remote branch (git push origin my_branch).
  5. Create a Pull Request on GitHub. Please refer to how to create a pull request.
  6. After submitting the PR, you can find your PR through the Pull Request. Click on the corresponding link to see if the CI for your PR has passed. If it has passed, it will display "All checks have passed". Regardless of whether the CI passes or not, you can click "Show all checks" → "Details" to view the detailed test case logs.
  7. After submitting the PR, if the CI passes, you can find your PR on the codecov page to check the coverage.

9. References

10. License

MIT License

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net45 is compatible.  net451 is compatible.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on TDengine.Connector:

Package Downloads
TDengine.Ado.Data

TDengine ADO.NET驱动,使用用例看：https://github.com/DotNetNext/SqlSugar/blob/master/Src/Asp.NetCore2/TDengineTest/Program.cs
Nexus.System.DataBase

Nexus - DataBase - 연동 데이터베이스 리스트 1) MariaDB 2) MysqlDB 3) TimescaleDB 4) MssqlDB 5) OracleDB (OLEDB) 6) PostgreSQL 7) TDengine 8) SQLite ---------------------------------------------- * 각종 데이터베이스 사용 통합 모듈 1) 데이터베이스 정보 XML 관리 기능. 2) 데이터베이스 쿼리 실패시 로그 기록. 3) 쿼리 문자열 EscapeString 확장 메서드 제공. 4) 특수문자 삭제 확장 메서드 추가. 5) SetDataBase 함수 문자열 파라미터 추가 (static) 6) 데이터베이스 타입 숫자 표시 가능 처리 7) 서버 이름으로 데이터베이스 연결정보 가져오는 기능 추가 ----------------------------------------------
Zongsoft.Data.TDengine

This is a data driver for TDengine of the Zongsoft data engine.
FreeSql.Provider.TDengine

FreeSql 数据库实现，基于TDengine.Connector
Fhjun.TDengine

TDengine操作辅助类，同时使用source generator自动生成代码

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on TDengine.Connector:

Repository Stars
dotnetcore/FreeSql
🦄 .NET aot orm, C# orm, VB.NET orm, Mysql orm, Postgresql orm, SqlServer orm, Oracle orm, Sqlite orm, Firebird orm, 达梦 orm, 人大金仓 orm, 神通 orm, 翰高 orm, 南大通用 orm, 虚谷 orm, 国产 orm, Clickhouse orm, DuckDB orm, TDengine orm, QuestDB orm, MsAccess orm.
Version Downloads Last updated
3.1.6 87 2/14/2025
3.1.5 802 1/7/2025
3.1.4 2,319 11/29/2024
3.1.3 9,975 5/22/2024
3.1.2 1,249 4/11/2024
3.1.1 1,532 2/2/2024
3.1.0 28,141 12/14/2023
3.0.2 39,051 1/16/2023
3.0.1 7,811 9/2/2022
3.0.0 7,029 8/12/2022
1.0.8 1,375 1/18/2023
1.0.7 1,542 7/22/2022
1.0.6 4,759 4/2/2022
1.0.5 1,271 4/1/2022
1.0.4 1,287 1/6/2022
1.0.3 1,591 12/28/2021
1.0.2 8,033 11/25/2021
1.0.1 13,511 11/25/2021 1.0.1 is deprecated because it has critical bugs.
1.0.0 11,770 11/25/2021 1.0.0 is deprecated because it has critical bugs.