Kategorien anzeigen

Mehrere CSV-Dateien in einer Tabelle zusammenführen

CSVKostenloser PlanAbfrageströmeSQL-Tabellen

CSV-Ordner → SQL-Tabellen · mit Query Streams

Mit Query Streams wird ein Ordner mit CSV-Dateien zu schreibgeschützten SQL-Tabellen: Die Dateien bleiben an ihrem Speicherort, der Agent auf diesem Computer liest sie in einen verschlüsselten lokalen Cache ein und hält die Tabellen aktuell, wenn Dateien hinzukommen, geändert werden oder verschwinden. Es wird nichts hochgeladen und keine Datei verändert. Die erste Einrichtung dauert etwa fünfzehn Minuten und ist im kostenlosen Tarif enthalten.

Kostenlos starten
Isometrischer Stapel aus drei Dateiblättern, die durch eine Linie mit einem einzelnen Tabellenelement verbunden sind
Sie kommen an irgendeiner Stelle nicht weiter? Fragen Sie uns einfach. Öffnen Unterstützung Gehen Sie zu „Abfrageströme“ (Menü oben rechts → Support) und senden Sie uns eine Nachricht. Echte Menschen lesen sie, und „Ich verstehe nicht, was dieser Bildschirm von mir verlangt“ ist eine völlig berechtigte Frage.

Was am Ende dabei herauskommt

CSV-OrdnersymbolMan erhält am Ende beispielsweise eine SQL-Tabelle. fileset.sales, die die Zeilen jeder CSV-Datei im Ordner enthält, mit einem _Quelldatei Jede Zeile enthält eine Spalte mit dem Namen der Quelldatei. Sobald eine neue Exportdatei eingeht oder eine alte Datei korrigiert wird, aktualisiert sich die Tabelle beim nächsten Scan automatisch, ohne dass ein erneuter Import erforderlich ist. Der Agent liest die Dateien auf dem Computer, auf dem er ausgeführt wird, und speichert die Zeilen dort zwischen, sodass die CSV-Dateien in Ihrem Netzwerk verbleiben.

Alles befindet sich in einem einzigen DuckDB-Schema namens DateisatzDie Daten werden auf dem Agentencomputer zwischengespeichert. Die Datentabelle übernimmt den von Ihnen eingegebenen Namen. TabellennameDie Spalten stammen aus dem CSV-Header, plus _Quelldatei und _row_id in jeder Zeile.

TischWas es enthält
fileset.salesMit Ein angeheftetes Layouteine Tabelle, benannt nach Ihrem Tabellenname, wobei die Zeilen jeder übereinstimmenden CSV-Datei gespeichert werden.
Dateiensatz.Bestellungen, fileset.returnsMit Ein Tisch pro Layout, eine Tabelle pro Layout, benannt nach dem gemeinsamen Teil der Dateinamen, wobei nachfolgende Zahlen entfernt werden: orders_2026_01.csv zu orders_2026_03.csv werden BestellungenBei einem Namenskonflikt wird ein kurzer Zusatz hinzugefügt. Namen ändern sich nie, solange das Layout fixiert bleibt, und es gibt keine automatische kombinierte Ansicht über verschiedene Layouts hinweg.

Jeder Ordnerverbinder bietet Ihnen außerdem Dateien, Dateien_Ereignisse, Verzeichnisse, Verzeichnis-Snapshots und Bände, welche die CSV-Dateien selbst, deren Änderungshistorie und Ordnergrößen auflisten.

WO DIE DATEIEN GELEGT WERDENeinen Computer oder eine Dateifreigabe, die der Agent öffnen kannIhr Ordnervon DateienDie Dateien bleiben dort, wo sie sind.Abfrage-Streams-Agentdurchsucht den Ordner und erstellt Tabellen.Im lokalen Cache wird die SQL-Abfrage ausgeführt.Nur SELECT-Anweisungen, hier erzwungenAbfrageströmeein ausgehender Linkprüft, wer was sehen darf · protokolliert jede AnfrageWO SIE ES VERWENDENjeder Computer, jeder BrowserExcel · Google Tabellen · NovaClaude · REST-API · AutomatisierungenSieh dir die Zeilen an, niemals die Dateien.
Der Agent liest den Ordner auf seinem eigenen Computer, speichert die Zeilen dort in einem verschlüsselten lokalen Cache und führt jede Abfrage gegen diesen Cache aus. Nur die von einer Abfrage zurückgegebenen Zeilen werden über eine einzige ausgehende Verbindung übertragen. Kein Port muss geöffnet, kein VPN benötigt und kein Upload ist erforderlich.

Wo es seinen Nutzen hat:

Was Sie benötigen

Ein Query Streams-Konto

Ordnerverknüpfungen sind in allen Tarifen enthalten, auch in der kostenlosen Version. Die kostenlose Version ist ein dauerhafter Tarif und keine befristete Testphase. Es gibt keine Begrenzung für die Anzahl der Dateien, die ein Ordner enthalten kann.

Der Agent, Version 2.6.0 oder später

Die Installation erfolgt auf einem Computer, der den Ordner öffnen kann: dem Dateiserver selbst, einem Bürocomputer oder dem Rechner, auf dem die Dateien gespeichert werden. Bei einem älteren Agenten werden die Ordnerkarten ausgegraut angezeigt. Agent 2.6.0+ Badge. Windows, Mac oder Linux.

Der Pfad des Ordners, wie ihn der Agent sieht

Ein lokaler Pfad oder eine Netzwerkfreigabe, geschrieben als \\server\share\folderDer Agent läuft als Dienst und kann daher nicht auf die bei der Anmeldung verbundenen Laufwerke (Z: und ähnliche) zugreifen. Unter Windows kann er sich mit einem gespeicherten Login bei einer Freigabe anmelden; unter Linux oder macOS muss die Freigabe zuerst eingebunden werden (Linux unter Windows 7.0). /mnt oder /Medien, ein Mac unter /Volumes).

Wo findet die Arbeit statt? Auf dem Computer, auf dem der Agent ausgeführt wird. Dieser scannt den Ordner und kopiert die Zeilen in einen verschlüsselten lokalen Cache (ein Schema, benannt nach …). Dateisatz) und führt jede Abfrage gegen diesen Cache aus. Ihre Dateien werden gelesen, aber niemals verändert, verschoben oder hochgeladen.

Richten Sie es in fünf Schritten ein

  1. Installieren Sie den Agenten auf einem Computer, der den Ordner öffnen kann.

    Anmelden, öffnen HerunterladenInstallieren Sie den Agenten für Ihr System auf dem Computer, der einen Ordner mit CSV-Dateien öffnen kann: dem Dateiserver oder einem beliebigen Computer, der ständig eingeschaltet ist und auf die Freigabe zugreifen kann. Die Installation dauert etwa eine Minute und startet anschließend automatisch. Sie benötigen Version 2.6.0 oder höher; die aktuelle Version finden Sie immer auf der Downloadseite.

    Warum ein kleines Programm anstelle eines Treibers? Der Agent benötigt eine einmalige Installation für Windows, Mac oder Linux (ca. 85 MB unter Windows, etwas über 100 MB unter Mac und Linux). Er öffnet eine einzige verschlüsselte Verbindung zu Query Streams – dies ist der einzige benötigte Netzwerkpfad: Es muss kein eingehender Port geöffnet werden, kein VPN ist erforderlich. Der Agent liest den Ordner, in dem er sich befindet. Die Dateien bleiben also an Ort und Stelle, und nur die von einer Abfrage zurückgegebenen Zeilen werden über das Internet an das Add-in, den Browser oder den KI-Client auf Ihrem System übertragen.

    Die Downloadseite zeigt Ihr ZugangsschlüsselFügen Sie es in das Feld des Agenten ein, wenn Sie dazu aufgefordert werden, und warten Sie, bis das Abzeichen gelesen wurde. Verbunden mit AbfrageströmenDas ist das Einzige, was Sie auf dem Computer des Agenten tun; alles andere geschieht in Ihrem Browser.

    Vollständige Komplettlösungen, falls gewünscht: Fenster, Mac, Linux.

  2. Weisen Sie es auf einen Ordner mit CSV-Dateien zu.

    Zurück in Ihrem Browser öffnen Daten → DatenagentenSuchen Sie den soeben installierten Agenten und klicken Sie darauf. Anschluss hinzufügen Schaltfläche. Öffnen Sie die Dateien und Ordner Pille und wähle die CSV-Ordner Karte. Sie sind sich nicht sicher, welche Karte passt? Wählen Sie eine aus. Dateien in einem Ordner Stattdessen: Der Agent durchsucht den Ordner, benennt dessen Inhalt auf einer Seite mit dem Titel „Was wir gefunden haben“ und öffnet die richtige, vorausgefüllte Karte für Sie.

    Der Zauberer rennt Ordner → Prüfen → Einstellungen → Realm → Überprüfen. An Ordner:

    Stammverzeichnisse
    Ein Pfad pro Zeile, so wie er vom Agentencomputer angezeigt wird. Jeder Ordner zeigt nach dem Hinzufügen sofort seinen Status an (erreichbar, verweigert, fehlt, nicht erreichbar, Anmeldeinformationen ungültig oder nicht eingebunden). Auf einem Windows-Agenten erhält eine Freigabe, die eine Anmeldung benötigt, diese vom Ordner. Berechtigung Spalte, einmal pro Server gespeichert; unter Linux oder Mac muss die Freigabe zuerst eingebunden werden.
    Unterordner scannen, maximale Tiefe
    Ein, und standardmäßig 8 Stufen.
    Muster einschließen, Muster ausschließen
    Welche Dateien zählen? Das Include-Muster beginnt mit dem passenden Glob für diese Karte. Ein Connector liest einen Dateityp: einen Ordner mit CSV-Dateien. und Parquet-Dateien bestehen aus zwei Konnektoren im selben Ordner, einem pro Dateityp.
    Folgen Sie symbolischen Links und Kreuzungen
    Standardmäßig deaktiviert. Der Agent folgt weder Verknüpfungen noch Cloud-Platzhaltern, solange diese Option nicht aktiviert ist.

    Beginnen Sie mit dem Anschluss hinzufügen Schaltfläche eines Agenten, mit der der Ordner geöffnet werden kann. Öffnen Dateien und Ordner und klicken Sie auf CSV-Ordner Karte.

    • Stammverzeichnisse: Ein Ordner pro Zeile, als Pfade auf dem Agentencomputer. Geben Sie eine Netzwerkfreigabe an als \\server\share\folder, nicht als zugeordneter Laufwerksbuchstabe.
    • Muster einbeziehen beginnt als **/*.csv. Unterordner scannen ist eingeschaltet.
    • Typ a Tabellenname, Zum Beispiel VerkäufeEs ist auf dieser Karte erforderlich.
    • Wähle ein Tabellenlayout. Ein fixiertes Layout (Standard) Geeignet für wiederkehrende Exporte, die alle einen gemeinsamen Header haben. Ein Tisch pro Layout Geeignet für Ordner, die von Hand zusammengestellt werden, bis zu 25 Layouts.
    • Ein Ordner, der auch Parquet- oder Excel-Dateien enthält, benötigt einen zweiten Connector für denselben Ordner. Ein Connector kann jeweils nur einen Dateityp lesen.
  3. Prüfen Sie, was es erstellen wird.

    An Überprüfen Der Agent liest eine Stichprobe von bis zu 64 Dateien und zeigt an, was er erstellen wird. Es wird noch nichts erstellt. Die Schaltfläche lautet: Testverbindung bis ein Urteil vorliegt, dann Weiter; Testen Sie erneut Das Beispiel wird nach jeder Änderung erneut ausgeführt. Es wird eine von vier Schlagzeilen angezeigt:

    Bereit zum Erstellen
    Jede Stichprobendatei passt. Die darunterliegenden Chips geben an, wie viele Ordner erreichbar waren, wie viele Dateien und Zeilen es gibt und welche Tabellen vorhanden sein werden.
    Fertig, mit Notizen
    Einige Dateien werden aussortiert oder die Layoutprüfung wurde fehlgeschlagen. Ein gelbes Banner zeigt genau an, welche Dateien betroffen sind: „{n} von {m} Dateien werden aussortiert“. Zeigen Sie, welche Dateien und warum Liste und „Sie können sie trotzdem erstellen – der Konnektor überprüft dies immer wieder und meldet den Grund auf der Registerkarte „Manifest“.
    Aufmerksamkeit erforderlich
    Der Agent ist offline oder ein Ordner fehlt. Beheben Sie das Problem, bevor Sie fortfahren; wenn der Agent offline ist, wird dies zwar angezeigt, Sie können aber trotzdem fortfahren.

    „Dieser Ordner enthält {n} verschiedene Dateiformate.“ Ein hellblaues Feld bedeutet, dass die Stichprobendateien nicht alle denselben Spaltensatz gemeinsam haben. Tabellenlayout Standardwert Ein angeheftetes Layout, was voraussetzt, dass jede Datei übereinstimmt. Klicken Sie Wechseln Sie zu einer Tabelle pro Layout und jedes Layout wird stattdessen zu einer eigenen Tabelle (bis zu 25).

    Eine Ablehnung oder zurückgestellte Akten blockieren Sie nicht: Klicken Sie WeiterSchließen Sie den Assistenten ab und beheben Sie die fehlerhaften Dateien später. Nur ein offline befindlicher Agent oder ein fehlender Ordner verhindert den Abschluss des Assistenten.

    An ÜberprüfenDer Agent liest eine Stichprobe von bis zu 64 Dateien und zeigt die Dateianzahl, die geschätzte Zeilenanzahl und die zu erstellenden Tabellen an. Es werden noch keine Tabellen erstellt. Wenn der Ordner mehrere Header enthält, während Tabellenlayout ist noch angeheftet, ein hellblaues Bedienfeld mit der Überschrift „Dieser Ordner enthält {n} verschiedene Dateilayouts“ bietet Wechseln Sie zu einer Tabelle pro LayoutEin gelber Banner mit der Aufschrift „{n} von {m} Dateien werden zurückgestellt“ listet die Dateien auf, die nicht passen; öffnen Zeigen Sie, welche Dateien und warum Um jeden einzelnen Grund zu sehen. Sie können den Konnektor trotzdem erstellen; er prüft dann ständig erneut und meldet den Grund. Manifest Tab.

  4. Wählen Sie die Scanfrequenz und erstellen Sie den Scanvorgang anschließend.

    Die Standardeinstellungen auf Einstellungen Geeignet für einen Ordner, der nur wenige Dateien pro Tag empfängt. Vier Punkte, die Sie möglicherweise ändern möchten:

    Scanintervall
    Jede Stunde Standardmäßig; wählbar von alle 5 Minuten bis täglich. Bei jedem Durchlauf werden Größe und Änderungsdatum verglichen, um neue, geänderte und verschwundene Dateien zu finden.
    Ordner auf Änderungen überwachen (nahezu in Echtzeit)
    Standardmäßig deaktiviert. Im aktivierten Zustand reagiert der Agent innerhalb von Sekunden auf lokalen Festplatten; bei Netzwerkfreigaben erfolgt die Reaktion nach bestem Bemühen, und der geplante Scan bleibt die Garantie. Ruhezeit (15 Sekunden) wartet, bis das Schreiben einer Datei abgeschlossen ist.
    Bitte aktualisieren Sie die Seite, bevor Sie eine Anfrage beantworten.
    Standardmäßig deaktiviert. Bei Aktivierung wird eine Abfrage zuerst erneut gescannt, wenn der letzte Scan älter als der letzte Scan ist. Fenster für Frische (60 Sekunden), wobei höchstens die Wartezeit beträgt Abfragewartezeitlimit (5 Sekunden). Dies gilt für Personen und Add-Ins, nicht für Benachrichtigungsumfragen.
    Wenn eine Datei verschwindet
    Entferne die Zeilen standardmäßig oder Zeilen beibehalten, gelöschte Zeilen als gelöscht markieren (Grabstein). Der Vanish-Guard-Verhältnis (0.5) lehnt einen Scan ab, bei dem mehr als die Hälfte der Dateien auf einmal verloren gehen, und behält den vorherigen Bestand bei, was einer Offline-Freigabe entspricht.

    Wählen Sie dann die Datenbereich die Zeilen zählen, überprüfen Rezension und klicken Sie Konnektor erstellenDer erste Scan startet sofort. Der Anschluss Manifest Der Tab zeigt an, was erstellt wurde und welche Dateien beiseitegelegt wurden.

  5. Schaut euch eure Tabellen an

    Öffnen Sie den Stecker: Manifest Die Registerkarte listet die erstellten Tabellen auf. Abfrage-Generator Die gleichen Tische stehen unter dem Dateisatz Schema. Drei Abfragen, die vom ersten Tag an funktionieren:

    Wie viele Zeilen trägt jede CSV-Datei bei?
    SELECT _source_file, COUNT(*) AS row_count, MIN(_row_id) AS first_row_id FROM fileset.sales GROUP BY _source_file ORDER BY row_count DESC LIMIT 100

    Bestätigt, dass alle erwarteten Dateien in der zusammengeführten Tabelle enthalten sind, und zeigt an, welche Exporte die größten sind.

    Welche CSV-Dateien befinden sich aktuell im Ordner?
    SELECT relative_path, size_bytes, modified_utc FROM fileset.files ORDER BY modified_utc DESC LIMIT 100

    Es werden alle Dateien aufgelistet, die der Agent sehen kann, wobei die neueste Änderung zuerst angezeigt wird, sodass Sie fehlende oder veraltete Exporte erkennen können.

    Welche Dateien wurden beiseitegelegt und warum?
    SELECT relative_path, event_type, detected_by, detail, event_at FROM fileset.files_events WHERE event_type IN ('refused', 'drift') ORDER BY event_at DESC LIMIT 20

    Nennt alle Dateien, deren Zeilen ausgelassen wurden, und gibt den Grund dafür an, z. B. eine Spalte, die nicht mit dem festgelegten Layout übereinstimmt.

    Jeder Ordnerverbinder dient auch denselben Buchhaltungstabellen, alle im Dateisatz Schema:

    TischWas es enthält
    DateienAlle aktuell im Ordner befindlichen Dateien: Pfad, Name, Dateiendung, Größe, Erstellungs- und Änderungsdatum, zuletzt gesehen und zuletzt aufgerufen. Eine Übersicht über files_current, in dem auch verschwundene Dateien aufbewahrt werden.
    Dateien_EreignisseDie Änderungshistorie: eine Zeile pro Datei erschien, War modifiziert, verschwandwurde beiseite gelegt (Driftoder war abgelehnt, mit der Zeit in event_at, wie es bemerkt wurde in erkannt von und der Grund dafür Detail.
    Verzeichnisse, Verzeichnis-Snapshots, BändeAnzahl und Größe der Ordner, wie sie gewachsen sind und auf welchen Datenträgern oder Freigaben die Stammverzeichnisse liegen.
    _Quelldatei, _row_idJede Datenzeile enthält zwei Spalten: die Datei, aus der die Zeile stammt, und eine eindeutige Zeilen-ID innerhalb dieser Datei. Gruppieren nach _Quelldatei um Dateien zu vergleichen.

Das war’s. Man legt eine neue Datei in den Ordner, und nach dem nächsten Scan ist sie in der Tabelle enthalten. Die Dateien haben den Computer, auf dem sie sich befanden, nie verlassen.

Auf eine Datei in einer Netzwerkfreigabe zugreifen

Der Agent öffnet Dateien als Hintergrunddienst, nicht als Sie. Daher ist für eine Datei auf einem anderen Computer ein zusätzlicher Schritt erforderlich. Welcher Schritt, hängt vom Computer ab, auf dem der Agent ausgeführt wird.

Fenster

Geben Sie den Netzwerkpfad ein, zum Beispiel \\server\share\folderniemals ein zugeordneter Laufwerksbuchstabe wie S:, die der Agent nicht sehen kann. Wenn die Freigabe nur namentlich genannte Personen zulässt, klicken Sie hier. Dienstidentität (der Chip unter dem Pfad oder ein Ordner) Berechtigung Spalte) und speichern Sie einen Login für diesen Server: ein Firmendomänenkonto oder ein Konto, das auf dem Server selbst erstellt wurde mit Domain Das Feld bleibt leer. Der Agent meldet sich dann an diesem Server an und liest die dortige Datei. Jeder Connector auf diesem Agent, der auf denselben Server zugreift, muss dasselbe Login verwenden. Ohne Login liest er mit seinem eigenen Dienstkonto, das von einer Unternehmensdomäne als der Computer selbst erkannt wird. Schritt für Schritt unter Windows

Linux

Die im Portal gespeicherten Freigabeanmeldungen werden unter Linux nicht verwendet: Ein Administrator bindet die Freigabe zunächst auf dem Computer des Agenten in einem Ordner unter ein. /mnt oder /Medienweil der Dienst des Agenten dies nicht sehen kann /heim oder /run/userIm Stecker sollte Folgendes beibehalten werden: \\server\share Pfad, den der Agent dem Mount zuordnet, oder geben Sie stattdessen den Mount-Pfad ein, z. B. /mnt/fileserver-shared/Accounts. Wie man eine Freigabe unter Linux einbindet

Mac

Die im Portal gespeicherten Freigabe-Logins werden auf einem Mac nicht verwendet: Binden Sie die Freigabe zuerst über das Terminal ein. sudo, in einem Ordner unter /VolumesDamit der Hintergrunddienst des Agenten darauf zugreifen kann. Im Connector muss Folgendes beibehalten werden: \\server\share Pfad, den der Agent dem Mount zuordnet, oder geben Sie stattdessen den Mount-Pfad ein, z. B. /Volumes/fileserver-shared/Accounts. So binden Sie eine Freigabe auf einem Mac ein

Falls der Test die Aktie nicht erreichen kann, suchen Sie in seinem Ergebnis nach folgenden Wörtern: nicht erreichbar Das bedeutet, dass der Computer des Agenten keine Antwort vom Server erhalten hat. Unter Linux oder einem Mac, nicht montiert Das bedeutet, dass die Freigabe noch eingebunden werden muss, und diese Meldung enthält den genauen Mount-Befehl für Ihren Server.

Ordner auf einer Netzwerkfreigabe? Unter Windows deckt ein einziger Login alle Ordner ab, die Sie vom selben Server hinzufügen. Ordner auf Änderungen überwachen Funktioniert auch bei geteilten Daten, nach dem besten Bemühen; der geplante Scan stellt sicher, dass jede Änderung erfasst wird.

Wenn ein Ordner nicht erreichbar ist

Jeder Ordner auf dem Ordner Ein Schritt zeigt sofort nach dem Hinzufügen einen Status an. Bewegen Sie den Mauszeiger über den Status, um die zugehörige Meldung des Agenten zu lesen; die ersten Wörter geben den jeweiligen Fall an.

Status oder NachrichtWas es bedeutetWas zu tun
bestrittenDie Freigabe ließ den Agenten nicht zu. Da keine Anmeldeinformationen gespeichert waren, liest ein Windows-Agent sein Dienstkonto, das von einer Unternehmensdomäne als der Computer selbst erkannt wird.Windows: Klicken Dienstidentität im Ordner Berechtigung Spalte und speichern Sie eine Anmeldung, die auf die Freigabe zugreifen kann, oder bitten Sie den Serverbetreiber, der gespeicherten Anmeldung Lesezugriff zu gewähren. Linux oder Mac: Die Freigabe ist zwar eingebunden, aber ihre Berechtigungen verhindern den Zugriff des Agenten; überprüfen Sie, wie sie eingebunden ist (Linux, Mac).
Ungültige Anmeldeinformationen, oder Die gespeicherten Anmeldeinformationen für \\server wurden abgelehntDer Server hat die gespeicherten Anmeldedaten abgelehnt: Tippfehler, falsche Domäne oder geändertes Passwort. Der Agent wartet eine Minute, bevor er die Anmeldung erneut versucht, damit das Konto nicht gesperrt wird.Klicken Sie auf den Kontonamen in der Berechtigung Geben Sie in dieser Spalte erneut Ihre Anmeldedaten ein. Bei einem Konto, das direkt auf dem Server erstellt wurde, lassen Sie die Spalte leer. Domain leer.
fehlenUnter diesem Pfad ist kein Ordner vorhanden. Unter Windows wird auch ein Servername, der nicht gefunden werden kann, oder eine Freigabe, die der Server nicht besitzt, als fehlend angezeigt.Überprüfen Sie die Namen oder wählen Sie den Ordner mit Ordner vom Agenten hinzufügen anstatt es einzutippen.
nicht erreichbar, oder Der Server hat nicht geantwortet.Keine Antwort vom Server: Er ist ausgeschaltet, der Name ist falsch oder eine Firewall blockiert die Dateifreigabe.Öffnen Sie dasselbe \\server\share Der Pfad muss auf dem Computer des Agenten gefunden werden. Falls auch das fehlschlägt, liegt ein Netzwerkproblem vor.
nicht montiert (Linux oder Mac)Die Freigabe ist auf dem Computer des Agenten nicht eingebunden. Bewegen Sie den Mauszeiger über den Status oder die Nicht montiert Chip in den Berechtigung Spalte für den genauen Mount-Befehl.Montieren Sie die Aktie (Linux, MacTesten Sie dann den Ordner erneut.
Ein anderer Connector auf diesem Agenten meldet sich bereits bei \\server an als …Windows erlaubt nur ein Konto pro Dateiserver auf jedem Computer, und ein anderer Connector auf diesem Agenten verwendet ein anderes.Verwenden Sie die gleichen Anmeldedaten wie für diesen Connector oder ändern Sie sie für jeden Connector, der auf diesen Server zugreift.
Windows hält bereits eine Anmeldung bei \\server für …Etwas anderes auf dem Computer des Agenten ist mit einem anderen Konto auf diesem Server angemeldet, und der Agent beendet niemals eine Anmeldung, die er nicht selbst vorgenommen hat.Folgen Sie der Meldung: Sie nennt das Windows-Konto, unter dem der Agent ausgeführt wird, und gibt an, ob Dienstidentität verwenden würde die Aktie über die bestehende Anmeldung lesen.
Dieser Agenten-Build kann sich nicht mit gespeicherten Anmeldeinformationen bei \\server anmelden.Ein älterer Agent, der keine gespeicherte Freigabeanmeldung verwenden kann.Aktualisieren Sie den Agenten und testen Sie dann erneut.

Nutze es überall

Der Konnektor ist eine Datenquelle wie jede andere in Query Streams. Speichern Sie eine Abfrage einmalig im Abfrage-Generator (der Dialekt ist DuckDB) und verwenden Sie es von hier aus:

Excel

Das Add-in Streamen Sie eine Abfrage Die Zeilen werden in ein Tabellenblatt eingefügt und bei einem Klick erneut ausgeführt. SQL in Excel ausführen.

Google Sheets

Der Abfragestreamer Das Add-on füllt einen von Ihnen ausgewählten Tab. Power Query für Google Sheets.

Claude, Cursor und andere KI-Clients

Über den Query Streams MCP-Server kennt Claude das Ordnermodell, einschließlich _Quelldatei und Dateien_Ereignisse. CSV-Ordner mit Claude über MCP.

REST-API

Jede gespeicherte Abfrage wird in jedem Tarif zu einem schreibgeschützten Endpunkt mit eigenem Schlüssel. CSV-Ordner-REST-API.

Nova

Fragen Sie in einfachen Worten nach dem Businessplan; Nova kennt jede Ordnertabelle und Spalte anhand seiner integrierten Beschreibungen.

Automatisierungen

Synchronisieren Sie die Zeilen nach einem Zeitplan mit Airtable, Smartsheet, Baserow, SeaTable oder einem Tabellenblatt. Automatisierungsleitfäden.

Ordnertabellen lassen sich auch mit Ihren anderen Konnektoren verknüpfen: Eine föderierte Abfrage kann übereinstimmen _Quelldatei Namen oder Bestellnummern in einem Ordner mit CSV-Dateien in einer Datenbank auf demselben Agenten.

Wie neue, geänderte und gelöschte Dateien angezeigt werden

Neue und geänderte Dateien

Auf jedem Scanintervall (oder innerhalb von Sekunden mit Ordner überwachen on) einer neuen Datei, die dem Layout entspricht, werden ihre Zeilen hinzugefügt und sie erhält eine erschien Ereignis. Eine geänderte Datei wird in einer Transaktion neu eingelesen: Die alten Zeilen werden gelöscht, die neuen Zeilen geladen und die Datei erhält ein modifiziert Ereignis.

Gelöschte Dateien

Eine Datei, die verschwindet, löscht standardmäßig ihre Zeilen oder behält sie als gelöscht markiert, wenn Sie die Option „Tombstone“ gewählt haben, und erhält eine verschwand Wenn mehr als die Hälfte der Dateien gleichzeitig verschwinden, wird der Scan abgebrochen und der vorherige Bestand bleibt erhalten: Eine Offline-Freigabe sieht genau so aus.

Beiseite gelegte Dateien

Eine Datei, die nicht ins Layout passt, nicht geöffnet werden kann oder eine obere Grenze überschreitet, wird als Ganzes beiseitegelegt: Keine ihrer Zeilen wird geladen, und Dateien_Ereignisse bekommt ein Drift Die Zeile gibt den Dateinamen und die Spalte an. Korrigieren Sie die Datei und speichern Sie sie; der nächste Scan versucht es erneut.

Wie frisch ist das denn, was ich sehe?

Die Abfragen werden anhand des letzten Scans beantwortet. Es gibt keine Schaltfläche „Erneut scannen“ oder „Jetzt synchronisieren“; das Scanintervall, die Ordnerüberwachung und Bitte aktualisieren Sie die Seite, bevor Sie eine Anfrage beantworten. Es gibt drei Bedienelemente. MAX(last_seen_utc) ab files_current zeigt Ihnen an, wann der Agent zuletzt nachgesehen hat.

beiseitegelegte Dateien

Im Schritt „Prüfen“ und auf der Registerkarte „Manifest“ erscheinen drei Wörter. Sie haben unterschiedliche Bedeutungen:

Beiseite stellen (geparkt)
Die Datei entspricht nicht dem festgelegten Layout oder ist unlesbar, beschädigt, gesperrt oder über einer Kappe. Es gilt das Alles-oder-Nichts-Prinzip: Eine geparkte Datei trägt null Zeilen bei. Dateien_Ereignisse Aufzeichnungen Drift Reihe, deren Detail Die Datei und die Spalte werden benannt. Die Datei wird übersprungen, solange ihre Größe und ihr Änderungsdatum gleich bleiben, und erneut versucht, sie zu laden, sobald sie sich ändert.
Unlesbar
Der Agent konnte die Datei aufgrund ihres Typs nicht öffnen oder analysieren: keine echte Arbeitsmappe, von einem anderen Programm gesperrt, ein Cloud-Platzhalter, nicht dekodierbare Bytes. Er bricht den Vorgang ab, und der Rest des Ordners wird weiterhin verarbeitet. Nur ein Ordner ohne lesbare Dateien verweigert die Verarbeitung des gesamten Pakets.
Abgelehnt
Der Agent konnte kein Layout festlegen, beispielsweise weil die Dateien unterschiedliche Spaltentypen verwenden. Es existiert noch keine Datentabelle. Dateien_Ereignisse bekommt ein abgelehnt Zeile mit dem Grund in DetailDer Agent versucht es bei jedem Scan erneut, bis ein Layout gefunden wird. Korrigieren oder schließen Sie die angegebene Datei aus, dann verschwindet die Meldung.

Wo man suchen muss: das bernsteinfarbene Banner auf Überprüfen (Zeigen Sie, welche Dateien und warum), des Steckverbinders Manifest Anschließend die Tabulatortaste. In SQL: SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.

Ein Ordner mit CSV-Dateien sieht üblicherweise so aus: Eine CSV-Datei, die im fixierten Modus eine zusätzliche Spalte enthält, wird vollständig beiseitegelegt, und files_events protokolliert eine Drift-Zeile, deren Details die Datei und die nicht übereinstimmende Spalte nennen; im Layout-pro-Layout-Modus wird eine Datei mit einem nicht sichtbaren Header mit dem Detail „Neues Layout – Bearbeiten Sie die Treiberoptionen des Konnektors oder die Manifestüberschreibungen (jede Änderung daran wird erneut erkannt), um es als neue Tabelle hinzuzufügen“ beiseitegelegt.

Grenzen, die man kennen sollte

Es gibt keine Beschränkung hinsichtlich Ordnern oder Dateianzahl. Die Zeilen werden wie bei jedem anderen Connector auf Ihren Datenbereich angerechnet. Standardeinstellungen, die Sie für den Connector anpassen können:

EinstellungStandardWas es tut
Maximale Tiefe8Wie viele Ordnerebenen unterhalb jedes Stammverzeichnisses durchsucht werden (1–64).
Maximale Anzahl an Dateien pro Scan100,000Alle Dateien werden in einem Durchgang geprüft.
Maximale Dateigröße für den Hash32 MiBNur bei wichtigen Dingen Inhalt der Hash-Datei An.
Aufbewahrung von Ereignisprotokollen30 TageWie lange Dateien_Ereignisse Die Zeilen werden beibehalten.
Scan-Parallelität pro Wurzel2Ordner werden pro Stammverzeichnis gleichzeitig gelesen.

Inhaltsbeschränkungen, die eine Datei speichern, anstatt sie abzuschneiden: 2.000.000 Zeilen oder 512 MiB pro Datei, 10.000.000 Zeilen oder 2 GiB pro Scan. Ein Ordner kann maximal 25 verschiedene Layouts enthalten. Ein Tisch pro Layout Modus.

Fragen, die Menschen stellen

Was passiert mit einer CSV-Datei, die andere Spalten als die übrigen Dateien enthält?

Mit Ein angeheftetes LayoutEs wird beiseitegelegt und keine seiner Zeilen wird geladen. Dateien_Ereignisse bekommt ein Drift Zeile mit Datei- und Spaltennamen. Umschalten Tabellenlayout zu Ein Tisch pro Layout Jedes Layout erhält eine eigene Tabelle, die nach dem gemeinsamen Teil der Dateinamen benannt ist.

Erhalte ich doppelte Zeilen, wenn ich eine CSV-Datei bearbeite?

Nein. Die alten Zeilen einer geänderten Datei werden gelöscht und die Datei wird in einem Schritt komplett neu eingelesen, sodass die Tabelle niemals zwei Versionen einer Datei enthält. Standardmäßig wird eine Änderung anhand der Dateigröße und des Änderungsdatums erkannt. Aktivieren Inhalt der Hash-Datei um Bearbeitungen zu erfassen, die den Zeitstempel beibehalten.

Kann ich CSV-Dateien mit unterschiedlichen Spaltenüberschriften in einer Tabelle zusammenführen?

Nicht automatisch. Ein Tisch pro Layout Jede Überschrift erhält eine eigene Tabelle (maximal 25), und es gibt keine integrierte kombinierte Ansicht. Schreiben Sie eine UNION ALL Führen Sie eine Abfrage über die Tabellen durch, die Sie kombinieren möchten, und wählen Sie die Spalten aus, die sie gemeinsam haben.

Wie schnell wird eine neue CSV-Datei angezeigt und gibt es eine Aktualisierungsschaltfläche?

Es gibt keine Aktualisierungsschaltfläche. Der Agent durchsucht den Ordner auf dem ScanintervallStandardmäßig stündlich, und eine neue Datei erhält eine erschien Reihe in Dateien_Ereignisse mit zusätzlichen Zeilen, falls es zum Layout passt. Ordner auf Änderungen überwachen (nahezu in Echtzeit) Reagiert innerhalb von Sekunden auf lokalen Datenträgern und arbeitet auf Netzwerkfreigaben nach dem Best-Effort-Prinzip.

Gibt es eine Begrenzung für die Anzahl der CSV-Dateien oder Zeilen, die ich kombinieren kann?

Es gibt keine Beschränkung der Dateianzahl pro Ordner und keine Begrenzung der Ordneranzahl pro Tarif. Der Agent verwendet Stichproben von bis zu 64 Dateien, um das Layout festzulegen. Die erweiterten Inhaltsbeschränkungen liegen standardmäßig bei 2.000.000 Zeilen und 512 MiB pro Datei sowie 10.000.000 Zeilen und 2 GiB pro Synchronisierung.

Werden meine Dateien irgendwo hochgeladen?

Nein. Der Agent liest die Daten auf seinem eigenen Rechner und speichert die Zeilen dort in einem verschlüsselten lokalen Cache. Eine Abfrage wird gegen diesen Cache ausgeführt, und nur die zurückgegebenen Zeilen verlassen den Rechner über eine einzige ausgehende Verbindung. Dateien werden niemals verändert, verschoben oder konvertiert.

Muss ich einen Port öffnen oder ein VPN einrichten?

Nein. Der Agent stellt eine ausgehende Verbindung über Port 443 her, über die sowohl Anfragen als auch Datensätze übertragen werden. Wenn ausgehende HTTPS-Verbindungen funktionieren, funktioniert auch dies.

Kann sich der Ordner auf einer Netzwerkfreigabe, in OneDrive oder Dropbox befinden?

Ja. Geben Sie eine Freigabe ein als \\server\share\folderDa der Agent als Dienst ausgeführt wird und die unter Ihrem Benutzerkonto verbundenen Laufwerke nicht sehen kann, speichern Sie unter Windows ein Anmeldekonto für den Server, falls die Freigabe nur bestimmten Benutzern Zugriff gewährt. Andernfalls verwendet der Agent sein eigenes Dienstkonto. Unter Linux oder macOS muss die Freigabe zuerst eingebunden werden. Ein synchronisierter OneDrive- oder Dropbox-Ordner funktioniert, wenn sich die zugehörigen Dateien auf dem Computer befinden: Stellen Sie den Ordner entsprechend ein. Dieses Gerät immer eingeschaltet lassenDer Agent lädt keine Dateien herunter, die ausschließlich in der Cloud gespeichert sind.

Der Ordner enthält mehrere Dateitypen. Ein oder zwei Konnektoren?

Ein Konnektor liest jeweils einen Dateityp. Ein Ordner mit CSV- und Parquet-Dateien benötigt zwei Konnektoren im selben Stammverzeichnis, einen pro Dateityp. Dateien, die nicht dem Einschlussmuster entsprechen, werden ignoriert, nicht beiseitegelegt.

Gibt es eine Schaltfläche zum erneuten Scannen?

Nein. Der Agent scannt auf dem Scanintervallreagiert auf Veränderungen, wenn Ordner überwachen Wenn Sie diese Option aktivieren, kann vor der Beantwortung einer Anfrage ein erneuter Scan durchgeführt werden. Bearbeiten Sie den Konnektor, um eine der drei Einstellungen zu ändern.

Ist das im kostenlosen Tarif wirklich enthalten?

Ja. „Kostenlos“ ist ein dauerhafter Tarif, keine befristete Testphase. Ordnerkonnektoren haben keine eigene Dateigrößenbeschränkung; die Zeilen werden wie bei jedem anderen Konnektor auf Ihren Datenbereich angerechnet. Die Details der einzelnen Tarife finden Sie hier: Preisseite.

Andere Ordner, die Abfrageströme verarbeiten, werden in Tabellen umgewandelt.Wie man einen Ordner mit Dateien mit SQL abfragtAlle Dateisatz-Anleitungen
Immer noch festgefahren? Öffnen Unterstützung Bitte geben Sie in Query Streams an, bei welchem Schritt Sie sich befinden und was Sie sehen. Wir stellen dann die Verbindung her.

Jeder Leitfaden für CSV Folder

Nicht ganz Ihre Konfiguration?

  • Enthalten Ihre Dateien verschiedene Zeilentypen, wobei eine Spalte den jeweiligen Zeilentyp angibt? Bei Multi-Record-CSV erhält jeder Zeilentyp eine eigene Tabelle. Multi-record
  • Sie benötigen lediglich eine Liste der Dateien mit Größen, Datumsangaben und Änderungsdetails? Das Dateisystem erledigt das, ohne die Dateien zu lesen. File System

Einrichtungsprobleme?

  • Der Agent meldet, dass die Datei oder der Ordner nicht existiert oder der Zugriff verweigert wird? Für zugeordnete Laufwerke, Netzwerkfreigaben, OneDrive und Linux-Home-Verzeichnisse ist jeweils eine Lösung erforderlich. Wo der Agent Dateien lesen kann
  • Der Agent wird als offline angezeigt, oder die Optionen „Verbindung testen“ und „Durchsuchen“ sind ausgegraut? Überprüfen Sie, ob der Agent online ist → Ist der Agent online?
Aktualisiert am November 9, 2026

Angetrieben durch BetterDocs