Zum Hauptinhalt springen
Connic
Platform

Database

Jedes Environment enthält eine verwaltete, schemalose Datenbank. Daten werden in benannten Collections gespeichert, mit umfangreichen Filtern abgefragt und im Dashboard angezeigt. Migrationen, Schema-Setup und externes Hosting entfallen.

Zuletzt aktualisiert
Auf dieser Seite
Collections
Gruppiere Dokumente in benannten Collections. Namen müssen mit einem Buchstaben beginnen und dürfen nur Kleinbuchstaben, Ziffern und Unterstriche enthalten, maximal 50 Zeichen.
Ohne Setup, automatisch erstellt
Collections werden bei Bedarf erstellt, sobald db_insert oder db_upsert über die Database Tools erstmals Daten darin speichert.
Umfangreiche Filter
Filtere mit $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $and, $or, $nor, $not, $exists, $contains, $elemMatch und $regex. Sortiere die Ergebnisse, teile sie in Seiten auf, wähle einzelne Felder aus oder ermittle alle unterschiedlichen Werte eines Feldes.

Datenmodell

Dokumente können beliebige Felder enthalten und benötigen kein festes Schema. Drei Felder werden vom System verwaltet:

  • _id: automatisch generierte UUID, eindeutig innerhalb der Collection
  • _created_at: beim Einfügen gesetzter Zeitstempel im ISO-8601-Format
  • _updated_at: bei jedem Schreibvorgang gesetzter Zeitstempel im ISO-8601-Format
document-shape.py
# Jedes Dokument enthält neben eigenen Daten diese Systemfelder:
{
    "order_id": "ORD-001",
    "status":   "pending",
    "amount":   99.50,
    "_id":         "550e8400-e29b-41d4-a716-446655440000",  # automatisch erzeugte UUID
    "_created_at": "2026-01-15T10:30:00Z",
    "_updated_at": "2026-01-15T10:30:00Z",
}

Automatische Erstellung

Collections müssen nicht explizit erstellt werden. Der erste Aufruf von db_insert oder db_upsert erstellt sie automatisch.

tools/orders.py
# Kein Setup erforderlich: Die Collection "orders" wird automatisch erstellt,
# sobald db_insert oder db_upsert erstmals darin schreibt
result = await db_insert("orders", {
    "order_id": "ORD-001",
    "customer": "alice@example.com",
    "amount":   99.50,
    "status":   "pending",
})

Collections lassen sich auch manuell im Dashboard unter Storage → Database erstellen.

Dashboard

Der Tab Storage → Database im Projekt-Dashboard bietet folgende Funktionen:

  • alle Collections mit Dokumentanzahl und Speichergröße anzeigen
  • Dokumente mit Filter- und Sortieroptionen durchsuchen
  • Filter und Sortierreihenfolge aus natürlich formulierten Anfragen generieren
  • Dokumente manuell einfügen
  • das abgeleitete Schema mit Feldnamen, Typen und Anteil ausgefüllter Felder anzeigen
  • Collections erstellen und löschen
Der Tab Storage → Database im Dashboard: Eine Collections Sidebar listet customers (3), incidents (2) und orders (3). Daneben ist die Collection customers mit 3 docs und 56.0 KB ausgewählt; ihr Browse Tab zeigt drei Dokumente in einer Tabelle mit den Spalten id, name, tier, health, created_at und updated_at.
Der Database Tab: links Collections mit ihrer Dokumentanzahl, rechts die Dokumente der ausgewählten Collection.
Der Schema Tab der Collection customers: Eine Tabelle der abgeleiteten Felder health, id, name und tier, jeweils vom Typ string, mit einem Anteil ausgefüllter Felder von 100 % und Beispielwerten wie enterprise und pro.
Der Schema Tab leitet den Typ jedes Feldes und den Anteil der Dokumente, in denen es ausgefüllt ist, aus einer Stichprobe der Dokumente in der Collection ab.

Plattform erkunden

Database-Tools-Referenz

Vollständige Referenz für db_find, db_insert, db_update, db_upsert, db_delete, db_count und db_list_collections.

Retrieval

Semantische Suche in indexierten Inhalten.

Environments

Wie Environments isoliert sind und Datenbankdaten je Environment getrennt bleiben.

Observability

Datenbankaufrufe in den Traces der Runs prüfen und ihre Nutzung verfolgen.