Vantiq平台数据接口介绍

Vantiq作为一个PaaS平台提供了一个强大的实时信息处理功能，并可根据实时的数据输入，预设的场景来实现人机交互，控制或生成新的事件。一个典型的Vantiq数据处理流程如下：

这些部分的作用：
External world: 外界的物理事件或事务流程产生的事件都可以接入到Vantiq平台。这些数据是按照一定的网路的协议接入到Vantiq平台，并且数据是以JSON的格式来表达的
Ingest: 通过Vantiq的规则引擎，每当数据源有数据变化时，Vantiq可以捕获这种变化，并结合本地数据生成新的数据流。比如一个传感器传入的数据含有一个传感器的id，但是它并不含有它的设备id及位置信息等。这个传感器的id可以和Vantiq本地数据结合来生成更加丰富的数据。
State of the world: Vantiq可以帮我们把这个数据保存于一个type里。这个type针对每个事件或传感器只生成一个record。通常会使用upcert的方法来生成这个record。这个唯一的record就会为后面的数据流不断地更新数据。在这里也可以丰富我们的数据，比如结合本地数据或其它更多的其它类型的传感器数据，生成新的数据流。结合Predictive models，比如人工智能虚拟现实，自然语音技术等
identify: 在这个过程中，我根据上面的model来识别我们的数据，比如说识别到的车牌号码，FaceAPI识别的脸数据等
Situation: 定义我们的场景。这个场景的定义非常重要。比如，温度及转速高过一个阈值，我们希望做什么事；FaceAPI返回的人脸识别是非法进入，我们应该去做什么。
Manage: 在这个过程里，我们通过规则引擎根据我们的场景来生成一些action。比如温度过高，Vantiq需要发出温度控制信号来控制温度，以保持温度在一个合适的范围。对于非法侵入，我们是否应该生成警告信号等
Collaborate: 在这个流程里，Vantiq可以帮我们发出信息到手机上，工作人员协同解决问题。比如机器坏了，或不在正常的工作范围，会发送这个信息到附近所有的技工的手机中，自动派单。如果有人接单了，并处理了，这个人工协同就算是完成了。如果在规定的时间里，没有人相应，系统也可以自动escalate到上级部门继续处理。这样形成一个闭环处理。
在上面的所有的流程中，Vantiq也可以在任何一个环节，把事件流处理后，并重新生成新的事件流。这些事件流可以被新的业务，或其它的业务所使用。通过事件的重新发布，对各个业务实现解耦，为未来的业务的重构带来极大的方便。
从上面我们可以看出来，外面的物理事件是Vantiq平台流处理的开始。在今天的文章中，我们来介绍一下如何把这些事件接入到Vantiq平台，并介绍了各种方法的优缺点。有的方法可行，但不是event driven。在本文中，为了细述的方便，我省去了网路gateway。
由于Vantiq是一个云平台，任何设备想接入到Vantiq平台，这个设备必须先具备连网的功能。

Vantiq平台数据接入总览
总体来说，外面的数据接入到Vantiq平台有两种方式：
事件驱动式接入：在这种方式下，只要有事件发生时，才会把数据发送Vantiq平台。如果没有数据就不会发送数据。在这种方式下，我们可以通过Vantiq平台提供的开箱即用的源AMQP，KAFKA 及 MQTT来连接我们外部的数据。需要做一些配置就可以了。当然我们也可以使用Vantiq平台提供的REST API/Websocket API方式来把数据提交到Vantiq平台定义的一个type （数据表格）或发布到一个Vantiq内部的topic，或者调用在Vantiq平台定义的一个procedure。对于一些目前在平台不被支持的源，我们可以通过Vantiq所提供的extension架构来构建自己的Connector来连接到Vantiq平台。在下面的章节里介绍。这种方式的接入是被建议的方式。

被动式数据接入：在这种方式下，数据源不主动向Vantiq平台发送数据，而是以一种Web Service的方式提供接口。这个接口可以让Vantiq平台使用REST API的方式来调用。Vantiq平台可以利用REMOTE源（REST API方式）按照一个时间的周期来访问这个接口，并形成数据流。这种访问方式，可能会造成网路流量的浪费，比如在没有数据变化的情况下，每隔一段时间还需要我们来采集数据，显然这个数据并不有用。另外采样频率低的时候，也有可能会漏掉一些细节。这个看具体的实时性要求而定。

理解Vantiq平台和外面的接口
REST API及Websocket API
首先想说的一点是：Vantiq平台里的任何一个东西都是可以通过REST API及Websocket API的方式来访问的。任何一个东西都是一个服务。理解这点非常的重要。我们不需要去特意创建一个Web Server并为之创建API来访问它。Vantiq里的任何一个资源本身就是一个服务。它自己就带有接口来访问它。比如，我们可以通过https://dev.vantiq.cn/api/v1/resources/custom/Person来访问在Vantiq平台中的一个叫做Person的type（数据表）。