Baradb/docs/de/api-binary.md

Binärprotokoll API

Niedrigstufiges Wire-Protokoll für hochperformante Client-Verbindungen.

Nachrichtenformat

Alle Nachrichten verwenden Big-Endian-Byte-Reihenfolge:

┌────────┬────────┬────────┬────────┬─────────────┐
│ Length │  Type  │  Seq   │ Status │   Payload   │
│ 4 bytes│ 1 byte │ 2 bytes│ 1 byte │  N bytes    │
└────────┴────────┴────────┴────────┴─────────────┘

Nachrichtentypen

Query (0x01)

let msg = makeQueryMessage(seq, "SELECT * FROM users")

Insert (0x02)

let msg = makeInsertMessage(seq, "users", data)

Update (0x03)

let msg = makeUpdateMessage(seq, "users", updates, where)

Delete (0x04)

let msg = makeDeleteMessage(seq, "users", where)

Ready (0x05)

let msg = makeReadyMessage(seq)

Error (0x06)

let msg = makeErrorMessage(seq, code, message)

Antwortcodes

Code	Name	Beschreibung
0x00	OK	Erfolg
0x01	ERROR	Allgemeiner Fehler
0x02	AUTH_REQUIRED	Authentifizierung erforderlich
0x03	INVALID_QUERY	Abfragesyntaxfehler
0x04	NOT_FOUND	Ressource nicht gefunden

Serialisierung

import barabadb/protocol/wire

# Wert serialisieren
let bytes = serializeValue(Value(kind: vkString, strVal: "test"))

# Wert deserialisieren
let value = deserializeValue(bytes)