InfluxDB3.Client 0.7.0-dev.1061

This is a prerelease version of InfluxDB3.Client.
There is a newer version of this package available.
See the version list below for details.
dotnet add package InfluxDB3.Client --version 0.7.0-dev.1061                
NuGet\Install-Package InfluxDB3.Client -Version 0.7.0-dev.1061                
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="InfluxDB3.Client" Version="0.7.0-dev.1061" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add InfluxDB3.Client --version 0.7.0-dev.1061                
#r "nuget: InfluxDB3.Client, 0.7.0-dev.1061"                
#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 InfluxDB3.Client as a Cake Addin
#addin nuget:?package=InfluxDB3.Client&version=0.7.0-dev.1061&prerelease

// Install InfluxDB3.Client as a Cake Tool
#tool nuget:?package=InfluxDB3.Client&version=0.7.0-dev.1061&prerelease                

<p align="center"> <img src="net_logo.svg" alt=".NET Logo" width="150px"> </p> <p align="center"> <a href="https://www.nuget.org/packages/InfluxDB3.Client"> <img src="https://buildstats.info/nuget/InfluxDB3.Client" alt="NuGet Badge"> </a> <a href="https://influxcommunity.github.io/influxdb3-csharp/"> <img src="https://img.shields.io/badge/-docfx-blue?logo=csharp&logoColor=white" alt="docfx"> </a> <a href="https://github.com/InfluxCommunity/influxdb3-csharp/actions/workflows/codeql-analysis.yml"> <img src="https://github.com/InfluxCommunity/influxdb3-csharp/actions/workflows/codeql-analysis.yml/badge.svg?branch=main" alt="CodeQL analysis"> </a> <a href="https://github.com/InfluxCommunity/influxdb3-csharp/actions/workflows/linter.yml"> <img src="https://github.com/InfluxCommunity/influxdb3-csharp/actions/workflows/linter.yml/badge.svg" alt="Lint Code Base"> </a> <a href="https://dl.circleci.com/status-badge/redirect/gh/InfluxCommunity/influxdb3-csharp/tree/main"> <img src="https://dl.circleci.com/status-badge/img/gh/InfluxCommunity/influxdb3-csharp/tree/main.svg?style=svg" alt="CircleCI"> </a> <a href="https://codecov.io/gh/InfluxCommunity/influxdb3-csharp"> <img src="https://codecov.io/gh/InfluxCommunity/influxdb3-csharp/branch/main/graph/badge.svg" alt="Code Cov"/> </a> <a href="https://app.slack.com/huddle/TH8RGQX5Z/C02UDUPLQKA"> <img src="https://img.shields.io/badge/slack-join_chat-white.svg?logo=slack&style=social" alt="Community Slack"> </a> </p>

InfluxDB 3 C# .NET Client

The C# .NET client that provides an easy and convenient way to interact with InfluxDB 3. This package supports both writing data to InfluxDB and querying data using the FlightSQL client, which allows you to execute SQL queries against InfluxDB IOx.

We offer this Getting Started: InfluxDB 3.0 C# Client Library video to learn more about the library.

Installation

Add the latest version of the client to your project:

dotnet add package InfluxDB3.Client

Usage

To start with the client, import the InfluxDB3.Client package and create a InfluxDBClient by constructor initializer:

using System.Threading.Tasks;
using InfluxDB3.Client;
using InfluxDB3.Client.Write;

namespace InfluxDB3.Examples.IOx;

public class IOxExample
{
    static async Task Main(string[] args)
    {
        const string host = "https://us-east-1-1.aws.cloud2.influxdata.com";
        const string token = "my-token";
        const string database = "my-database";

        using var client = new InfluxDBClient(host, token: token, database: database);
    }
}

to insert data, you can use code like this:

//
// Write by Point
//
var point = PointData.Measurement("temperature")
    .SetTag("location", "west")
    .SetField("value", 55.15)
    .SetTimestamp(DateTime.UtcNow.AddSeconds(-10));
await client.WritePointAsync(point: point);

//
// Write by LineProtocol
//
const string record = "temperature,location=north value=60.0";
await client.WriteRecordAsync(record: record);

to query your data, you can use code like this:

//
// Query by SQL
//
const string sql = "select time,location,value from temperature order by time desc limit 10";
Console.WriteLine("{0,-30}{1,-15}{2,-15}", "time", "location", "value");
await foreach (var row in client.Query(query: sql))
{
    Console.WriteLine("{0,-30}{1,-15}{2,-15}", row[0], row[1], row[2]);
}
Console.WriteLine();

//
// Query by parametrized SQL
//
const string sqlParams = "select time,location,value from temperature where location=$location order by time desc limit 10";
Console.WriteLine("Query by parametrized SQL");
Console.WriteLine("{0,-30}{1,-15}{2,-15}", "time", "location", "value");
await foreach (var row in client.Query(query: sqlParams, namedParameters: new Dictionary<string, object> { { "location", "west" } }))
{
    Console.WriteLine("{0,-30}{1,-15}{2,-15}", row[0], row[1], row[2]);
}
Console.WriteLine();

//
// Query by InfluxQL
//
const string influxQL =
    "select MEAN(value) from temperature group by time(1d) fill(none) order by time desc limit 10";
Console.WriteLine("{0,-30}{1,-15}", "time", "mean");
await foreach (var row in client.Query(query: influxQL, queryType: QueryType.InfluxQL))
{
    Console.WriteLine("{0,-30}{1,-15}", row[1], row[2]);
}

Feedback

If you need help, please use our Community Slack or Community Page.

New features and bugs can be reported on GitHub: https://github.com/InfluxCommunity/influxdb3-csharp

Contribution

If you would like to contribute code you can do through GitHub by forking the repository and sending a pull request into the main branch.

License

The InfluxDB 3 C# .NET Client is released under the MIT License.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  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. 
.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 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 (1)

Showing the top 1 NuGet packages that depend on InfluxDB3.Client:

Package Downloads
Dijing.InfluxdbExt

influxdb2.0 extension tool

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.9.0-dev.1229 17 11/4/2024
0.9.0-dev.1222 28 10/22/2024
0.9.0-dev.1215 42 10/14/2024
0.9.0-dev.1208 44 10/7/2024
0.9.0-dev.1198 57 9/13/2024
0.8.0 1,488 9/13/2024
0.8.0-dev.1190 47 9/9/2024
0.8.0-dev.1183 41 9/9/2024
0.8.0-dev.1182 40 9/9/2024
0.8.0-dev.1166 48 9/3/2024
0.8.0-dev.1156 46 9/3/2024
0.8.0-dev.1149 43 9/3/2024
0.8.0-dev.1148 42 9/3/2024
0.8.0-dev.1103 58 8/12/2024
0.8.0-dev.1096 55 8/12/2024
0.7.0 2,989 8/12/2024
0.7.0-dev.1087 34 8/5/2024
0.7.0-dev.1068 32 8/5/2024
0.7.0-dev.1061 33 8/5/2024
0.7.0-dev.1054 44 8/5/2024
0.7.0-dev.1026 71 7/22/2024
0.7.0-dev.1019 51 7/15/2024
0.7.0-dev.1012 619 7/1/2024
0.7.0-dev.1008 49 7/1/2024
0.7.0-dev.1001 59 6/10/2024
0.7.0-dev.994 43 6/3/2024
0.7.0-dev.981 50 5/27/2024
0.7.0-dev.977 50 5/27/2024
0.7.0-dev.967 40 5/20/2024
0.7.0-dev.965 37 5/20/2024
0.7.0-dev.953 52 5/13/2024
0.7.0-dev.946 56 5/3/2024
0.7.0-dev.942 54 4/29/2024
0.7.0-dev.934 72 4/22/2024
0.7.0-dev.925 55 4/16/2024
0.6.0 8,916 4/16/2024
0.6.0-dev.917 60 4/8/2024
0.6.0-dev.910 57 4/3/2024
0.6.0-dev.891 50 3/25/2024
0.6.0-dev.890 39 3/25/2024
0.6.0-dev.877 52 3/18/2024
0.6.0-dev.869 51 3/18/2024
0.6.0-dev.859 49 3/11/2024
0.6.0-dev.858 38 3/11/2024
0.6.0-dev.845 61 3/1/2024
0.5.0 948 3/1/2024
0.5.0-dev.837 52 3/1/2024
0.5.0-dev.830 50 2/29/2024
0.5.0-dev.821 49 2/26/2024
0.5.0-dev.782 56 2/20/2024
0.5.0-dev.775 53 2/19/2024
0.5.0-dev.771 53 2/19/2024
0.5.0-dev.770 51 2/19/2024
0.5.0-dev.748 72 1/29/2024
0.5.0-dev.744 48 1/29/2024
0.5.0-dev.732 62 1/22/2024
0.5.0-dev.710 97 1/2/2024
0.5.0-dev.708 65 1/2/2024
0.5.0-dev.693 110 12/11/2023
0.5.0-dev.686 83 12/8/2023
0.4.0 8,088 12/8/2023
0.4.0-dev.678 75 12/8/2023
0.4.0-dev.674 76 12/4/2023
0.4.0-dev.673 73 12/4/2023
0.4.0-dev.660 79 12/4/2023
0.4.0-dev.650 97 11/13/2023
0.4.0-dev.649 65 11/13/2023
0.4.0-dev.648 59 11/13/2023
0.4.0-dev.629 65 11/6/2023
0.4.0-dev.627 56 11/6/2023
0.4.0-dev.615 78 10/31/2023
0.4.0-dev.608 79 10/17/2023
0.4.0-dev.601 73 10/11/2023
0.4.0-dev.597 80 10/2/2023
0.4.0-dev.581 73 10/2/2023
0.3.0 2,780 10/2/2023
0.3.0-dev.573 71 9/27/2023
0.3.0-dev.569 71 9/27/2023
0.3.0-dev.556 71 9/26/2023
0.3.0-dev.540 70 9/26/2023
0.3.0-dev.483 74 9/18/2023
0.3.0-dev.471 75 9/4/2023
0.3.0-dev.467 77 9/4/2023
0.3.0-dev.445 85 8/24/2023
0.3.0-dev.441 86 8/21/2023
0.3.0-dev.440 70 8/21/2023
0.3.0-dev.427 84 8/11/2023
0.2.0 2,913 8/11/2023
0.2.0-dev.419 78 8/7/2023
0.2.0-dev.418 73 8/7/2023
0.2.0-dev.405 71 8/7/2023
0.2.0-dev.360 101 7/26/2023
0.2.0-dev.353 88 7/25/2023
0.2.0-dev.337 89 7/17/2023
0.2.0-dev.327 84 7/10/2023
0.2.0-dev.314 87 6/29/2023
0.2.0-dev.310 81 6/29/2023
0.2.0-dev.306 67 6/28/2023
0.2.0-dev.299 78 6/27/2023
0.2.0-dev.295 78 6/27/2023
0.2.0-dev.285 81 6/23/2023
0.2.0-dev.278 84 6/13/2023
0.2.0-dev.271 82 6/12/2023
0.2.0-dev.264 87 6/9/2023
0.1.0 898 6/9/2023
0.1.0-dev.258 84 6/9/2023
0.1.0-dev.242 76 6/8/2023
0.1.0-dev.235 78 6/8/2023
0.1.0-dev.2 77 6/8/2023
0.1.0-dev.1 77 6/8/2023