API ReferenceDirect Nominal Channel Writer

Write Batches

Synchronously writes batches of records to a Nominal data source. This endpoint bypasses the Channel Writer service entirely, and should only be used if the implications are well understood.

If you call this endpoint, writes will go directly into Nominal DB and will not be placed in Nominal’s durable queue. This results in lower latency, but also consequently lower durability.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
batcheslist of objectsRequired
dataSourceRidstringRequired

Unique resource identifier for a NominalDataSource or Dataset. Though named similarly to a DataSourceRid, a NominalDataSourceRid specifically refers To a NominalDataSource, which is a nominal hosted database for streaming writes.

asynchronousInsertbooleanOptional

Defaults to true if not specified. If enabled, the server handles batching of requests. Request latency will be slower, but overall throughput will be faster if requests are sent in parallel.