Konvertieren Sie einen Ordner mit Excel-Arbeitsmappen in SQL-Tabellen Sie können überall Abfragen durchführen.
Richten Sie den Query Streams Agent auf den Ordner aus. Er liest die Dateien auf seinem Rechner, erstellt die Tabellen in einem lokalen Cache und hält sie aktuell, sobald Dateien hinzukommen, geändert werden oder gelöscht werden. Sie können die Tabellen aus Excel, Google Sheets, Nova, Claude oder der REST-API abfragen. Es werden keine Daten hochgeladen, konvertiert oder bearbeitet.
Was am Ende dabei herauskommt
Man erhält beispielsweise eine SQL-Tabelle pro Tabellenblatt. fileset.data_orders, das die Zeilen dieses Tabellenblatts aus jeder Arbeitsmappe im Ordner enthält, mit einem _Quelldatei Die Spalte gibt den Namen der Arbeitsmappe an, aus der jede Zeile stammt. Fügt man die Arbeitsmappe des nächsten Monats hinzu, werden deren Zeilen beim nächsten Scan in die Tabelle eingefügt; korrigiert man eine alte Arbeitsmappe, werden deren Zeilen ersetzt. Der Agent liest die .xlsx Die Dateien werden auf dem Computer gespeichert, auf dem das Programm ausgeführt wird, und die Zeilen werden dort zwischengespeichert, sodass die Arbeitsmappen in Ihrem Netzwerk verbleiben.
Dateien, die im Laufe der Zeit eintreffen
| sales_2026_07.xlsx |
| sales_2026_08.xlsx |
| sales_2026_09.xlsx |
Die Zeilen jeder Datei, eine Tabelle
| _Quelldatei | Zeilenanzahl | erste_Zeilen-ID |
|---|---|---|
| sales_2026_07.xlsx | … | … |
| sales_2026_08.xlsx | … | … |
| sales_2026_09.xlsx | … | … |
Alles befindet sich in einem einzigen DuckDB-Schema namens DateisatzDie Daten werden auf dem Agentencomputer zwischengespeichert. Die Tabellen werden automatisch benannt, da keine anderen Daten vorhanden sind. Tabellenname Feld. Jede Zeile enthält _Quelldatei und _row_id.
| Tisch | Was es enthält |
|---|---|
fileset.data_orders | Mit Ein angeheftetes Layout, eine Tabelle pro Blatt mit dem Namen Daten_<Tabellenblatt>, wobei die Zeilen dieses Tabellenblatts aus jeder Arbeitsmappe enthalten sind. Blätter Begrenzt, welche Blätter zu Tabellen werden. |
fileset.budget | Mit Ein Tisch pro LayoutPro Layout wird eine Tabelle erstellt, deren Name sich aus dem gemeinsamen Teil des Dateinamens (ohne nachfolgende Zahlen) oder, falls kein verwendbarer Teil mehr vorhanden ist, aus dem Blattnamen zusammensetzt. Die Namen bleiben unverändert, solange das Layout fixiert ist. |
Jeder Ordnerverbinder bietet Ihnen außerdem Dateien, Dateien_Ereignisse, Verzeichnisse, Verzeichnis-Snapshots und Bände, welche die Arbeitsmappen selbst, ihre Änderungshistorie und Ordnergrößen auflisten.
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\folder. The Agent runs as a service, so it cannot see drives you mapped at your login (Z: and friends). On Windows it can sign in to a share with a login you store; on Linux or a Mac, mount the share first (Linux under /mnt oder /Medien, a Mac under /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
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 Excel-Arbeitsmappen ö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.
-
Weisen Sie es auf einen Ordner mit Excel-Arbeitsmappen aus.
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 Excel-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
- One path per line, as the Agent’s computer sees it. Each folder shows a status (reachable, denied, missing, unreachable, credentials invalid or not mounted) as soon as you add it. On a Windows Agent a share that needs a login gets one from the folder’s Credential column, stored once per server; on Linux or a Mac, mount the share first.
- 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 Excel-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
**/*.xlsx. Unterordner scannen ist eingeschaltet. - Es gibt kein Tabellenname Feld. Blätter werden zu Tabellen wie z. B.
Datenbestellungen. Verwenden Blätter um einzuschränken, welche Blätter gelesen werden. - Wähle ein Tabellenlayout. Ein fixiertes Layout (Standard) Geeignet für Arbeitsmappen, die alle die gleichen Tabellenblätter und Spalten verwenden. Ein Tisch pro Layout Geeignet für Ordner, die von Hand zusammengestellt werden, bis zu 25 Layouts.
-
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 Arbeitsmappen und listet die zu erstellenden Tabellen auf. Es wird noch nichts erstellt. Fehlt einer Arbeitsmappe ein angeheftetes Tabellenblatt, wird dies im gelben Banner „{n} von {m} Dateien werden beiseitegelegt“ angezeigt. Zeigen Sie, welche Dateien und warum Um jede einzelne Datei anzuzeigen. Eine Datei, die keine echte Arbeitsmappe ist, wie z. B. eine umbenannte CSV-Datei, wird dort ebenfalls mit einem Grund wie „Nicht lesbar als Excel: Nicht als XLSX-Arbeitsmappe lesbar“ aufgeführt. Wenn die Arbeitsmappen unterschiedliche Layouts aufweisen, während Tabellenlayout ist noch immer befestigt, ein himmelblaues Bedienfeld bietet Wechseln Sie zu einer Tabelle pro LayoutWenn keine Arbeitsmappe den vollständigen Tabellensatz enthält, wird die Überprüfung verweigert und es wird keine Tabelle erstellt, bis Sie eine Datei korrigieren oder ausschließen.
-
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.
-
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
DateisatzSchema. Drei Abfragen, die vom ersten Tag an funktionieren:Wie viele Zeilen trägt jede Arbeitsmappe zum Bestellblatt bei?SELECT _source_file, COUNT(*) AS row_count, MIN(_row_id) AS first_row_id FROM fileset.data_orders GROUP BY _source_file ORDER BY row_count DESC LIMIT 100
Bestätigt, dass alle regionalen oder monatlichen Arbeitsmappen in die zusammengeführte Tabelle aufgenommen wurden und wie viel jede einzelne beigetragen hat.
Welche Arbeitshefte sind diese Woche angekommen, geändert oder verschwunden?SELECT relative_path, event_type, size_bytes, prev_size_bytes, event_at FROM fileset.files_events WHERE event_type IN ('appeared', 'modified', 'vanished') AND event_at >= now() - INTERVAL 7 DAY ORDER BY event_at DESC LIMIT 100Zeigt Ihnen den Änderungsverlauf des Ordners an, sodass Sie sehen können, wer eine neue Arbeitsmappe gesendet hat und wann eine alte bearbeitet wurde.
Jede Arbeitsmappe im Ordner, mit ihrem Windows-BesitzerSELECT relative_path, owner, size_bytes, modified_utc FROM fileset.files ORDER BY modified_utc DESC LIMIT 100
Listet die Arbeitsmappen auf, die der Agent sehen kann, und wer die jeweilige Arbeitsmappe zuletzt gespeichert hat; das Feld „Besitzer“ wird nur unter Windows ausgefüllt.
Jeder Ordnerverbinder dient auch denselben Buchhaltungstabellen, alle im
DateisatzSchema:Tisch Was 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, Warmodifiziert,verschwandwurde beiseite gelegt (Driftoder warabgelehnt, mit der Zeit inevent_at, wie es bemerkt wurde inerkannt vonund der Grund dafürDetail.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 _Quelldateium 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.
Reaching a file on a network share
The Agent opens files as a background service, not as you, so a file on another computer needs one extra step. Which step depends on the computer the Agent runs on.
If the test cannot get to the share, look for these words in its result: unreachable means the Agent’s computer got no answer from the server. On Linux or a Mac, not mounted means the share still has to be mounted, and that message includes the exact mount command for your server.
Folders on a share? On Windows, one login covers every folder you add from the same server. Ordner auf Änderungen überwachen works on a share too, on a best-effort basis; the scheduled scan is what guarantees every change is picked up.
When a folder is not reachable
Every folder on the Ordner step shows a status as soon as you add it. Hover the status to read the Agent’s own message; its first words say which case it is.
| Status or message | Was es bedeutet | Was zu tun |
|---|---|---|
| denied | The share did not let the Agent in. With no login stored, a Windows Agent reads as its service account, which a company domain sees as the computer itself. | Windows: click Service identity in the folder’s Credential column and store a login that can read the share, or ask whoever runs the server to give the stored one read access. Linux or Mac: the share is mounted, but its permissions keep the Agent out; check how it is mounted (Linux, Mac). |
| credentials invalid, oder The stored credentials for \\server were refused | The server rejected the stored login: a typo, the wrong domain or a changed password. The Agent waits a minute before it tries that login again, so the account is not locked out. | Click the account name in the Credential column and type the login again. For an account made on the server itself, leave Domain blank. |
| fehlen | No folder at that path. On Windows, a server name that cannot be found, or a share the server does not have, also shows as missing. | Check the names, or pick the folder with Add folder from the agent instead of typing it. |
| unreachable, oder \\server did not answer | No answer from the server: it is off, the name is wrong, or a firewall blocks file sharing. | Open the same \\server\share path on the Agent’s computer. If that fails too, it is a network problem. |
| not mounted (Linux or Mac) | The share is not mounted on the Agent’s computer. Hover the status, or the Not mounted chip in the Credential column, for the exact mount command. | Mount the share (Linux, Mac), then test the folder again. |
| Another connector on this agent already signs in to \\server as … | Windows allows one account per file server on each computer, and another connector on this Agent uses a different one. | Use the same login as that connector, or change it on every connector that reads this server. |
| Windows already holds a sign-in to \\server for … | Something else on the Agent’s computer is signed in to that server with another account, and the Agent never closes a sign-in it did not make. | Follow the message: it names the Windows account the Agent runs as and says whether Use service identity would read the share through the existing sign-in. |
| This agent build cannot sign in to \\server with stored credentials. | An older Agent that cannot use a stored share login. | Update the Agent, then test again. |
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. Excel-Ordner mit Claude über MCP.
REST-API
Jede gespeicherte Abfrage wird in jedem Tarif zu einem schreibgeschützten Endpunkt mit eigenem Schlüssel. Excel-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 Excel-Arbeitsmappen in Verbindung mit 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_EreignisseAufzeichnungenDriftReihe, derenDetailDie 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_Ereignissebekommt einabgelehntZeile mit dem Grund inDetailDer 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 Excel-Arbeitsmappen sieht üblicherweise so aus: Eine Datei namens Q3-summary.xlsx, die eigentlich eine umbenannte CSV-Datei ist, wird separat abgelegt und erscheint unter "Welche Dateien und warum anzeigen" und später als Drift-Zeile in files_events mit dem Detail "Als Excel nicht lesbar: Als XLSX-Arbeitsmappe nicht lesbar (Eintrag "Ende des zentralen Verzeichnisses" konnte nicht gefunden werden.)".
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:
| Einstellung | Standard | Was es tut |
|---|---|---|
| Maximale Tiefe | 8 | Wie viele Ordnerebenen unterhalb jedes Stammverzeichnisses durchsucht werden (1–64). |
| Maximale Anzahl an Dateien pro Scan | 100,000 | Alle Dateien werden in einem Durchgang geprüft. |
| Maximale Dateigröße für den Hash | 32 MiB | Nur bei wichtigen Dingen Inhalt der Hash-Datei An. |
| Aufbewahrung von Ereignisprotokollen | 30 Tage | Wie lange Dateien_Ereignisse Die Zeilen werden beibehalten. |
| Scan-Parallelität pro Wurzel | 2 | Ordner 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
Meine Arbeitshefte haben unterschiedliche Blätter. Was ist da los?
Mit Ein angeheftetes LayoutEine Arbeitsmappe, der ein angeheftetes Tabellenblatt fehlt, wird beiseitegelegt und keine ihrer Zeilen wird geladen. Der Schritt „Prüfen“ bietet folgende Möglichkeit: Wechseln Sie zu einer Tabelle pro LayoutDadurch erhält jedes Layout seine eigene Tabelle, bis zu 25. Die Tabellennamen ändern sich nie, solange das Layout fixiert bleibt.
Wird eine neue Arbeitsmappe mit neuem Layout automatisch angezeigt?
Nein. Es ist beiseitegelegt und mit dem Hinweis versehen, dass es sich um ein neues Layout handelt. Ändern und speichern Sie beliebige Verbindungsoptionen, wie z. B. BlätterDer Agent durchsucht den Ordner erneut und fügt die neue Tabelle hinzu. Vorhandene Tabellennamen bleiben erhalten.
Kann es .xls- oder .xlsm-Dateien lesen?
Der Fahrer liest .xlsx, und Muster einbeziehen beginnt als **/*.xlsxÄltere speichern .xls Arbeitshefte als .xlsx Erstens. Eine Datei, die keine echte Datei ist. .xlsx Die Arbeitsmappe wurde als unlesbar beiseitegelegt und unter folgendem Namen geführt: Zeigen Sie, welche Dateien und warum.
Was passiert, wenn jemand beim Scannen eine Arbeitsmappe in Excel geöffnet hat?
Eine von einem anderen Programm gesperrte Datei ist unlesbar, daher wird diese Arbeitsmappe separat beiseitegelegt, während der Rest des Ordners weiterhin geladen wird. Dateien_Ereignisse Aufzeichnungen Drift Die Zeile wird benannt. Sobald die Arbeitsmappe gespeichert und geschlossen ist, wird sie beim nächsten Scan erneut eingelesen.
Werden beim Bearbeiten einer Arbeitsmappe doppelte Zeilen erzeugt?
Nein. Die alten Zeilen einer geänderten Arbeitsmappe werden gelöscht und die gesamte Arbeitsmappe in einem Schritt neu eingelesen, sodass die Tabelle niemals zwei Versionen einer Datei enthält. Änderungen werden anhand der Größe und des Änderungsdatums erkannt; aktivieren Sie diese Option. Inhalt der Hash-Datei um Bearbeitungen zu erfassen, die den Zeitstempel beibehalten.
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?
Yes. Type a share as \\server\share\folder, because the Agent runs as a service and cannot see drives mapped at your login. On Windows, store a login for the server if the share lets in only named people; without one the Agent reads as its own service account. On Linux or a Mac, mount the share first. A synced OneDrive or Dropbox folder works when its files are stored on the computer: set the folder to 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.
Jeder Leitfaden für Excel Folder
Nicht ganz Ihre Konfiguration?
- 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
Setup trouble?
- Agent says the file or folder does not exist, or access is denied? Mapped drives, network shares, OneDrive and Linux home folders each need one fix → Where the Agent can read files from
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

