Data-Warehouse-Integration

Dokumente in ClickHouse, in jedem Volumen

Holofin liest PDFs und Scans und fügt jedes Feld in ClickHouse ein, damit Sie Prüfquoten und Konfidenz über Millionen von Dokumenten verfolgen können.

Eléctrica del Turia S.A.
FACTURA DE ELECTRICIDAD
Nº factura: ET26-0981144
TitularLucía Navarro Gil
Dirección de suministroC/ de Sueca 41, 3º, 46006 Valencia
Periodo de facturación02/09/2026 a 01/10/2026
Fecha de emisión06/10/2026
Total a pagar84,37 €

✓7 Felder geladen

!1 zur Prüfung markiert

Von Holofin gelesen und in ClickHouse geladen: Versorgerrechnung. Beispieldokument, alle Namen und Zahlen sind erfunden.

So funktioniert es

  1. 1

    ClickHouse einmal verbinden

    Legen Sie eine Rolle mit Schreibrechten auf ein einziges Schema an und hinterlegen Sie ihre Zugangsdaten in Holofin. Holofin erstellt die Tabelle beim ersten Laden; darüber hinaus gibt ClickHouse nichts preis.

  2. 2

    Dokumente wie gewohnt senden

    Per Upload in der App, per E-Mail-Weiterleitung oder über die API. Holofin klassifiziert jede Datei, trennt Sammeldateien in einzelne Dokumente und liest die Felder jedes Dokumenttyps.

  3. 3

    Zeilen abfragen

    Jedes Feld landet als eigene Zeile, mit Konfidenz, Quellseite und needs_review-Flag. ClickHouse behandelt diese Zeilen wie jede andere Quelle: Verknüpfen Sie sie mit Ihren eigenen Tabellen.

So schreibt der ClickHouse-Connector

Holofin fügt in Batches über die HTTP-Schnittstelle von ClickHouse ein, mit TLS, in eine ReplacingMergeTree-Tabelle mit Dokument und Feld als Schlüssel, sodass eine Korrektur den vorherigen Wert ersetzt. Das funktioniert mit ClickHouse Cloud und mit selbst gehosteten Servern, die per HTTPS erreichbar sind.

Die einzige Berechtigung, die Holofin braucht:

CREATE USER holofin_loader IDENTIFIED WITH sha256_password BY '...';
GRANT INSERT, SELECT ON extracted.document_fields TO holofin_loader;

Die Tabelle, die Holofin schreibt

Eine Zeile pro Feld, damit ein neuer Dokumenttyp die Tabelle nie verändert. Die Spalten sind überall dieselben; die Datentypen tragen die Namen, die ClickHouse verwendet.

extracted.document_fields
document_idSTRINGHolofins Kennung des Dokuments, stabil über erneute Ladevorgänge hinweg.
document_typeSTRINGDie Klasse, die Holofin dem Dokument zugewiesen hat: supplier_invoice, payslip, bank_statement und so weiter.
fieldSTRINGDer Feldname in snake_case, wie in Ihrem Extraktionsschema definiert.
valueSTRINGDer Wert als normalisierter Text: ISO-Datumsangaben, Punkt als Dezimaltrennzeichen, IBANs ohne Leerzeichen.
confidenceFLOATZwischen 0 und 1. Wie sicher sich Holofin bei dem Wert ist.
pageINTEGERDie Seite der Quelldatei, auf der der Wert gelesen wurde.
bboxARRAY<FLOAT>Die Position auf dieser Seite: x, y, Breite, Höhe, als Anteile der Seite.
needs_reviewBOOLEANTrue, wenn die Konfidenz niedrig ist oder eine Regel fehlschlägt, etwa ein Saldo, der nicht aufgeht.
reviewed_bySTRINGWer den Wert in Holofin bestätigt oder korrigiert hat, sobald das geschehen ist.
loaded_atTIMESTAMPWann die Zeile geschrieben wurde. Korrekturen schreiben eine neue Zeile; die jüngste gilt.

Abfragen in ClickHouse

Prüfquote und Median der Konfidenz pro Dokumenttyp über 30 Tage, mit countIf und quantile:

-- Review rate per document type over the last 30 days
SELECT
    document_type,
    uniqExact(document_id) AS documents,
    round(countIf(needs_review) / count(), 3) AS review_rate,
    quantile(0.5)(confidence) AS median_confidence
FROM extracted.document_fields FINAL
WHERE loaded_at >= now() - INTERVAL 30 DAY
GROUP BY document_type
ORDER BY documents DESC

Sicherheit

  • Die Dokumente werden in Europa verarbeitet, auf ISO-27001-zertifizierten OVHcloud-Servern in Frankreich.
  • Holofin schreibt ausschließlich in das Schema, das Sie freigeben. Ihre übrigen Tabellen kann Holofin nicht lesen.
  • Die Aufbewahrung der Quelldateien in Holofin wird pro Organisation festgelegt, von Zero Data Retention bis unbegrenzt. Für die Zeilen in Ihrem Warehouse gelten Ihre eigenen Richtlinien.
  • DSGVO: Holofin handelt als Ihr Auftragsverarbeiter. Kein Dokument verlässt die Europäische Union.

Häufig gestellte Fragen

Warum FINAL in den Abfragen?

Die Tabelle ist eine ReplacingMergeTree: Ein korrigierter Wert ersetzt den alten, wenn Parts zusammengeführt werden. FINAL wendet die Ersetzung zur Abfragezeit an, Sie lesen also immer den neuesten Wert.

Funktioniert das mit selbst gehostetem ClickHouse?

Ja, solange der Server für Holofin per HTTPS erreichbar ist. Legen Sie einen Benutzer mit INSERT und SELECT auf genau dieser Tabelle an.

Wie schnell erscheinen die Felder in ClickHouse?

Wenige Sekunden, nachdem das Dokument gelesen wurde. Die meisten Dokumente sind in unter einer Minute gelesen, eine per E-Mail gesendete Datei ist in ClickHouse also meist eine Minute später abfragbar.

Was passiert, wenn jemand einen Wert korrigiert?

Holofin schreibt für dieses Feld eine neue Zeile mit dem korrigierten Wert, needs_review auf false und ausgefülltem reviewed_by. Behalten Sie pro Dokument und Feld die jüngste Zeile für den aktuellen Stand, oder alle Zeilen für einen vollständigen Audit-Trail.

Kann ich festlegen, welche Felder geladen werden?

Ja. Jeder Dokumenttyp hat in Holofin ein Extraktionsschema. Fügen Sie dort Felder hinzu, benennen Sie sie um oder entfernen Sie sie, und die nächsten Dokumente werden mit den neuen Namen geladen. An der Tabellenstruktur ändert sich nichts.

Welche Dokumente liest Holofin?

Jedes Geschäftsdokument als PDF, Scan oder Foto: Rechnungen, Gehaltsabrechnungen, Kontoauszüge, Steuerbescheide, Handelsregisterauszüge, Ausweise, Bescheinigungen. Holofin prüft außerdem jede Datei auf Manipulationen und kann ein verdächtiges Dokument markieren, bevor man seinen Feldern vertraut.

Testen Sie Holofin mit Ihren eigenen Dokumenten.

Jeder Wert mit der Seite verknüpft, von der er stammt, jedes PDF auf Manipulation geprüft, Regeln über die gesamte Fallakte geprüft.

Holofin