HTTP Input

The HTTP input plugin opens a port for listening to HTTP requests.
Each request can contain one single record or a batch of records. If a request can contain a batch of records, then it will be up to the PARSER plugin to separate records from the same batch.

Note, the user executing RioDB must have firewall permissions in the operating system to open a network port.

Parameters

host: OPTIONAL, whitelist of host that can send requests to the listener. Requests will only be accepted from the host specified. It can be used to limit requests from localhost only.

port: REQUIRED, The port number to be opened. The value must be a positive integer and not conflict with any other ports in use. When starting multiple streams, make sure they each use a different port number.

backlog: OPTIONAL, The HTTP server handler backlog property. Value must be a positive intenger. If not specified, the default value used is zero.

Syntax

INPUT http (
    port <int value>
    host <string>
    backlog <int value>
)

Example

To start listening for HTTP requests on port 9898:

INPUT http (
    port 9898
)