InfluxDB的初体验（windows下）

最新推荐文章于 2024-08-17 20:41:32 发布

Matrix Y

最新推荐文章于 2024-08-17 20:41:32 发布

阅读量579

点赞数 24

分类专栏：数据库文章标签：时序数据库 .net

本文链接：https://blog.csdn.net/weixin_42031602/article/details/141154601

版权

数据库专栏收录该内容

1 篇文章 0 订阅

订阅专栏

InfluxDB的应用场景

influxDB是一个时序数据库，通常用于监控每隔一段时间要记录数据的场景。最近要研究关于怎么样处理IOT数据时，偶然搜到了这个非关系型数据库，但网上关于influxDB的一些资料，需要到处找。因此为了之后省时间，故做个记录。

我觉得以下几篇文章也写的不错

InfluxDB-简介、理论原理介绍以及InfluxDB入门操作

InfluxDB存储结构、读写

官方中文文档

官方英文文档

有时间的话可以参考以上文章，没时间的话看以下快速入门——

实战

1）首先是在官网下载influxDB，我在英文文档中点击进入windows界面下载了influxDB v2，下载后如下图所示。

2）在这个文件夹下

3）此时会弹出一个shell窗口

4）输入./influxd.exe

此时influxDB服务打开，那我们就可以在vs中操作这个数据库了。

5）打开vs我们编写简易代码进行测试，新建一个winform程序

6）初始化环境变量和配置influxDB，这里可以借助ui或者控制台来看我们的试验是否成功。

首先是nuget：infulxDB.Client这个包

我们要知道，打开服务后，我们是可以访问这个数据库的，其在本机的默认端口是8086.当我们输入url时，可以看到

因为我已经注册过，所以直接输入用户名密码，一开始进入这个页面是要让你注册一个账号的。

我们要存数据，需要一个bucket，系统默认创建的是firstExample，我们可以

自己创建一个。然后还需要找到你的influxdb的token

点击右边clone复制token

此时在vs中进行代码编写，我们知道了这个token之后，我需要将其注入成环境变量，所以我的代码如下

然后我再通过influxDB.client这个包对数据库进行连接和访问。这里特别需要注意的是，一开始注册的时候，需要我们注册organization，这个名字需要注意，在后续的连接需要填写该值。

这样子，其实数据库就已经连上了，我不再赘述。

7）添加数据，通过webapi的形式将点位写入到influxDB中

此时，我们可以在web中看到加入了数据

如果WebUI中不会操作的话，我们可以在vs中写入C#代码来查询一下

当然，以上是入门操作，当我们想复用时，很难实现，因此我也写了一个帮助类来操作influxDB

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using InfluxDB.Client;
using InfluxDB.Client.Api.Domain;
using InfluxDB.Client.Writes;
using InfluxDB.Client.Flux.Domain;

public class InfluxDBHelper
{
    private readonly string _url;
    private readonly string _token;
    private readonly string _org;
    private readonly string _bucket;
    private readonly InfluxDBClient _client;

    public InfluxDBHelper(string url, string token, string org, string bucket)
    {
        _url = url;
        _token = token;
        _org = org;
        _bucket = bucket;
        _client = InfluxDBClientFactory.Create(_url, _token.ToCharArray());
    }

    // 插入数据
    public async Task InsertDataAsync(string measurement, Dictionary<string, object> fields, Dictionary<string, string> tags = null)
    {
        var point = PointData.Measurement(measurement)
                             .Timestamp(DateTime.UtcNow, WritePrecision.Ns);

        foreach (var field in fields)
        {
            point = point.Field(field.Key, field.Value);
        }

        if (tags != null)
        {
            foreach (var tag in tags)
            {
                point = point.Tag(tag.Key, tag.Value);
            }
        }

        using (var writeApi = _client.GetWriteApiAsync())
        {
            await writeApi.WritePointAsync(point, _bucket, _org);
        }
    }

    // 查询数据
    public async Task<List<FluxTable>> QueryDataAsync(string fluxQuery)
    {
        var queryApi = _client.GetQueryApi();
        var tables = await queryApi.QueryAsync(fluxQuery, _org);
        return tables;
    }

    // 更新数据 (更新操作通常是通过插入新数据来实现)
    public async Task UpdateDataAsync(string measurement, Dictionary<string, object> fields, Dictionary<string, string> tags = null)
    {
        await InsertDataAsync(measurement, fields, tags);
    }

    // 删除数据 (删除是通过时间范围或者标签过滤来实现的)
    public async Task DeleteDataAsync(DateTime start, DateTime stop, string predicate)
    {
        var deleteApi = _client.GetDeleteApi();
        await deleteApi.DeleteAsync(start, stop, predicate, _bucket, _org);
    }

    // 关闭客户端连接
    public void Dispose()
    {
        _client.Dispose();
    }
}

实际使用时

var helper = new InfluxDBHelper("http://localhost:8086", "your-token", "your-org", "your-bucket");

await helper.InsertDataAsync("temperature", new Dictionary<string, object>
{
    {"value", 25.3}
}, new Dictionary<string, string>
{
    {"location", "office"}
});

var result = await helper.QueryDataAsync(@"from(bucket: ""your-bucket"") |> range(start: -1h)");

foreach (var table in result)
{
    foreach (var record in table.Records)
    {
        Console.WriteLine($"{record.GetField()} : {record.GetValue()}");
    }
}

await helper.DeleteDataAsync(DateTime.UtcNow.AddHours(-2), DateTime.UtcNow, "location=\"office\"");

helper.Dispose();