ASP.NET Core2讀寫InfluxDB時序資料庫

Andre-Hub發表於2018-10-31

在我們很多應用中會遇到有一種基於一系列時間的資料需要處理,通過時間的順序可以將這些資料點連成線,再通過資料統計後可以做成多緯度的報表,也可通過機器學習來實現資料的預測告警。而時序資料庫就是用於存放管理這種有著時間順序資料的,時序資料庫一般都支援時序資料的快速寫入、持久化、多緯度的聚合查詢等基本功能。

 

InfluxDB簡介

InfluxDB是一個基於時間序列資料而開發的高效能資料儲存平臺,它可以對時序資料進行高吞吐量的攝取、壓縮和實時查詢。InfluxDB是用Go語言編寫的,它會編譯成一個沒有外部依賴的二進位制檔案來執行,支援Java、JavaScript、c#等語言。InfluxDB支援類似SQL的查詢語言,同時還支援正規表示式、算術表示式和時間序列特定函式以加速資料的處理效率。如下是跟InfluxDB相關的網址:

InfluxDB官網:https://www.influxdata.com/

InfluxDB官方文件:https://docs.influxdata.com/influxdb/

InfluxDB官方下載:https://portal.influxdata.com/downloads

InfluxDB客戶端工具下載:https://docs.influxdata.com/influxdb/v1.6/tools/api_client_libraries/

 

InfluxDB操作

這裡將會簡單的介紹下如何操作InfluxDB,通過這些操作基本也能滿足工作上的需要了。操作InfluxDB可以通過命令列工具,也可藉助開源的客戶端工具,我這裡使用的是一款名叫“InfluxDBStudio”基於C#編寫的開源工具。常用操作的程式碼如下:

  1 #顯示使用者
  2 show users
  3 
  4 #建立使用者
  5 create user "username" with password `password`
  6 
  7 #建立管理員許可權使用者
  8 create user "username" with password `password` with all privileges
  9 
 10 #刪除使用者
 11 drop user "username"
 12 
 13 #建立資料庫
 14 create database "db_name"
 15 
 16 #顯示所有的資料庫
 17 show databases
 18 
 19 #刪除資料庫
 20 drop database "db_name"
 21 
 22 #使用資料庫
 23 use db_name
 24 
 25 #顯示該資料庫中所有的表
 26 show measurements
 27 
 28 #建立表,直接在插入資料的時候指定表名,其中test為表名
 29 insert test,host=127.0.0.1,monitor_name=test count=1
 30 
 31 #刪除表
 32 drop measurement "measurement_name"
 33 
 34 #查詢資料
 35 select * from test order by time desc
 36 
 37 #檢視當前資料庫的資料儲存策略(Retention Policies)
 38 show retention policies on "db_name"
 39 
 40 #建立新的資料儲存策略
 41 #rp_name:策略名
 42 #db_name:具體的資料庫名;
 43 #3w:儲存3周,3周之前的資料將被刪除,influxdb具有各種事件引數,比如:h(小時),d(天),w(星期)
 44 #replication 1:副本個數,一般為1就可以了
 45 #default:設定為預設策略
 46 create retention policy "rp_name" on "db_name" duration 3w replication 1 default
 47 
 48 #修改資料儲存策略
 49 alter retention policy "rp_name" on "db_name" duration 30d default
 50 
 51 #刪除資料儲存策略
 52 drop retention policy "rp_name"
 53 
 54 #檢視資料庫的連續查詢(Continous Queries)
 55 show continuous queries
 56 
 57 #建立新的連續查詢(Continous Queries)
 58 #cq_name:連續查詢名字
 59 #db_name:資料庫名字
 60 #sum(count):計算總和
 61 #table_name:當前表名
 62 #new_table_name:存新的資料的表名
 63 #30m:時間間隔為30分鐘
 64 create continous query cq_name on db_name begin select sum(count) into new_table_name from table_name group by time(30m) end
 65 
 66 #刪除連續查詢
 67 drop continous query cp_name on db_name
 68 

 

實現

通過上述的介紹與操作我們已基本熟悉了InfluxDB資料庫,那麼接下來我們們就一起來看看在ASP.NET Core2程式中如何來讀寫操作InfluxDB資料庫吧。而這裡我們藉助一個名為“InfluxData.Net”的第三方庫來與InfluxDB互動通訊,基於“InfluxData.Net”庫可以使得我們很簡單的完成資料庫的讀寫操作。在ASP.NET Core2專案中通過Nuget管理器引用“InfluxData.Net”類庫後,敲入實現程式碼如下:

  1 using System;
  2 using System.Collections.Generic;
  3 using System.Linq;
  4 using System.Threading.Tasks;
  5 using InfluxData.Net.Common.Enums;
  6 using InfluxData.Net.InfluxDb;
  7 using InfluxData.Net.InfluxDb.Models;
  8 using Microsoft.AspNetCore.Mvc;
  9 
 10 namespace WebApplication1.Controllers
 11 {
 12     public class InfoController : Controller
 13     {
 14         //宣告InfluxDbClient
 15         private InfluxDbClient clientDb;
 16 
 17         public InfoController()
 18         {
 19             //連線InfluxDb的API地址、賬號、密碼
 20             var infuxUrl = "http://localhost:8086/";
 21             var infuxUser = "admin";
 22             var infuxPwd = "admin";
 23 
 24             //建立InfluxDbClient例項
 25             clientDb = new InfluxDbClient(infuxUrl, infuxUser, infuxPwd, InfluxDbVersion.Latest);
 26         }
 27 
 28 
 29         /// <summary>
 30         /// 從InfluxDB中讀取資料
 31         /// </summary>
 32         public async void GetData()
 33         {
 34             //傳入查詢命令,支援多條
 35             var queries = new[]
 36             {
 37                 " SELECT * FROM Reading WHERE time> now() -  24h "
 38             };
 39             var dbName = "code-hub";
 40 
 41             //從指定庫中查詢資料
 42             var response = await clientDb.Client.QueryAsync(queries, dbName);
 43             //得到Serie集合物件(返回執行多個查詢的結果)
 44             var series = response.ToList();
 45             //取出第一條命令的查詢結果,是一個集合
 46             var list = series[0].Values;
 47             //從集合中取出第一條資料
 48             var info_model = list.FirstOrDefault();
 49         }
 50 
 51 
 52 
 53         /// <summary>
 54         /// 往InfluxDB中寫入資料
 55         /// </summary>
 56         public async void AddData()
 57         {
 58             //基於InfluxData.Net.InfluxDb.Models.Point實體準備資料
 59             var point_model = new Point()
 60             {
 61                 Name = "Reading",//表名
 62                 Tags = new Dictionary<string, object>()
 63                 {
 64                     { "Id",  158}
 65                 },
 66                 Fields = new Dictionary<string, object>()
 67                 {
 68                     { "Val", "webInfo" }
 69                 },
 70                 Timestamp = DateTime.UtcNow
 71             };
 72             var dbName = "code-hub";
 73 
 74             //從指定庫中寫入資料,支援傳入多個物件的集合
 75             var response = await clientDb.Client.WriteAsync(point_model, dbName);
 76         }
 77     }
 78 }

 

總結

1、InfluxDB是個專業的時序資料庫,通過時序庫可幫助我們更高效的處理應用中的時序資料。

2、使用InfluxDB庫時需先了解該庫的一些特色功能,如資料儲存策略、連續查詢等。

3、通過“InfluxData.Net”類庫可快速簡便的幫助我們在ASP.NET Core2程式中實現對InfluxDB的讀寫操作。

 

宣告

本文為作者原創,轉載請備註出處與保留原文地址,謝謝。如文章能給您帶來幫助,請點下推薦或關注,感謝您的支援!

 

相關文章