ServicesScanDALHTTP APIWrites

Attach columns to a file

POST
/writes/columns

Write values of new columns for every row one file of a Table version keeps, as column files attached to that file, which leaves its existing files as they are. The service writes the rows as they arrive, holding what it has not yet written in the request's memory budget. The values stay invisible until a version that includes the receipt is prepared on an edit base, registered and committed.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Header Parameters

scandal-request*string

The AttachColumnsRequest request as JSON, base64url-encoded without padding.

Request Body

body*fileapplication/vnd.apache.arrow.stream
Formatbinary

Response Body

Success

application/json
  1. response

The receipt of an attachment of column files, to finalize.

receipt*

One file an append wrote. Pass it unchanged to finalize a write.

curl -X POST 'https://scandal.spiraldb.dev/writes/columns' \  -H 'scandal-request: string'
{  "receipt": {    "token": "string"  }}