本文以使用官方示例驱动的LightSensor设备为例,描述将设备的数据存储到本地数据库的方法。

前提条件

  • 本示例仅适用于Link IoT Edge专业版,请您确保已根据专业版环境搭建内容完成边缘实例的创建。
  • 根据示例驱动内容创建光照度传感器产品以及该产品下的LightSensor设备,并将设备分配至边缘实例。

背景信息

在生产中常需要结合传感器的历史数据和行业的算法模型,在边缘端进行分析和判断现场状态。实现此操作首先需要把设备上报的数据存储到本地数据库。

边缘函数计算提供本地数据库存储助手,根据ProductKey_DeviceName格式,将设备上报数据分为不同的表,并存储到本地SQLite数据库,供函数计算中的其他函数(算法逻辑)查询。同时,因为边缘设备的存储空间受限,本地数据库存储助手还提供数据库单表存储上限配置(默认为1万条记录)和数据写满回滚机制。

操作步骤

  1. 创建本地数据库存储函数。
    1. 下载本地数据库存储函数。
    2. 登录阿里云函数计算控制台
      如尚未开通该服务,请阅读并勾选我已阅读并同意内容,单击立即开通,开通服务。
    3. 单击服务列表后的“+”图标,根据界面提示配置参数后,单击确定创建一个服务。
      其中,服务名称必须填写,此处设置为EdgeFC,其余参数可根据您的需求设置,也可以不设置。
      说明 若已操作过其他应用场景示例或小程序示例,即已创建EdgeFC服务,则无需重复创建。
    4. 创建服务成功后,在服务概览页面单击函数列表后的“+”图标,创建函数,并选择空白函数模板。
    5. 触发器配置中,选择不创建触发器,单击下一步
    6. 设置本地数据库存储函数的基础管理配置参数。
      参数 描述
      所在服务 选择已创建的EdgeFC服务。
      函数名称 设置为saveSqliteDB
      运行环境 设置函数的运行环境,此示例中选择python3
      代码配置 选择代码包上传,上传已下载的saveSqliteDB-code.zip代码包。

      其余参数的值请根据您的需求,参见函数计算设置,也可以不设置。

    7. 单击下一步,进入模板授权管理页面。此处无需设置,单击下一步
    8. 确认函数信息后,单击创建
      创建函数完成后,单击函数名称,可在代码执行页签下查看源码。
      在线编辑函数
    9. (可选)配置数据库参数。
      saveSqliteDB是一个设备数据存储到本地SQLite数据库的参考示例,您可以按需调整和更改示例。目前预留的可调整参数有:
      • db_file_path:SQLite文件路径,默认为/linkedge/run/fc-runtime-data/
      • db_file_name:SQLite文件名径,默认为device-data-sqlite3.db
      • table_max_entries:数据库单表最大记录条数,默认为1万条。
      • table_retain_count:数据库记录到达上限,清理数据库时需要保留的最近记录数,默认为6000条。
  2. 分配函数到边缘实例。
    1. 登录物联网平台控制台
    2. 左侧导航栏选择边缘计算 > 边缘实例
    3. 前提条件中完成的边缘实例右侧,单击查看
    4. 实例详情页面,选择函数计算,单击分配函数
    5. 根据界面提示设置参数,将已创建的本地数据库存储函数saveSqliteDB分配到边缘实例中。
      函数信息配置说明如下:
      参数 描述
      地域 选择您创建的服务所在的地域。
      服务 选择EdgeFC服务。
      函数 选择saveSqliteDB函数。
      授权 选择AliyunIOTAccessingFCRole
      函数配置说明如下:
      参数 描述
      运行模式 运行模式有两种。此处选择持续运行模式。程序部署后会立即执行。
      内存限制 函数运行可使用的内存资源上限,单位为MB。此处设置为512 MB。当函数使用内存超出该限制时,该函数计算程序会被强制重启。
      超时限制 函数收到事件后的最长处理时间,此处使用默认值5秒。如超过该时间函数仍未返回结果,该函数计算程序将会被强制重启。
      定时运行 使用默认配置:关闭

      其余参数无需配置。

    6. 单击确认,至此您已将本地数据库存储函数分配到边缘实例中。
  3. 添加消息路由。
    将设备上报的数据发送给saveSqliteDB函数处理,通过saveSqliteDB函数将设备数据存储到本地数据库。添加消息的详细步骤及各个参数的解释,请参考设置消息路由
    1. 单击添加路由,添加LightSensor设备到函数计算的消息路由。
    2. 按照界面提示,设置如下参数,参数设置完成后单击确定
      参数 描述
      消息来源 此处选择设备,选择光照度传感器 > LightSensor
      消息主题过滤 此处选择全部
      消息目标 此处选择函数计算EdgeFC/saveSqliteDB函数。
  4. 部署边缘实例并查看设备的运行结果。
    1. 实例详情页面,单击右上角部署后在弹出框中单击确定,将子设备、函数计算下发到边缘端。
      您可以通过部署进程查看部署进度及结果。
    2. (可选)在实例详情 > 监控信息页面,选择函数计算,查看已分配到边缘实例的函数计算监控信息。
      单击函数名称对应操作栏中的查看,查看详细的监控信息。
      查看函数监控信息
    3. 实例部署成功后,本地数据库存储函数做为一个后台服务存在,将LightSensor设备上报的数据存储到SQLite数据库中。
      可以在您的网关设备上查看/linkedge/run/fc-runtime-data/device-data-sqlite3.db文件内容。也可以登录您的网关,执行tail -f /linkedge/run/logger/fc-base/saveSqliteDB/log.INFO命令,查看该函数的日志来观察实际函数运行情况。
      查看函数运行情况
    至此您已经完整地体验了使用边缘函数计算实现本地数据库存储的功能。