Visualizza le categorie

Indicizzare un file system ed interrogarlo con SQL

File systemPiano gratuitoFlussi di querytabelle SQL

File system → tabelle SQL · con Query Streams

Con Query Streams, i file e le cartelle sul tuo computer o nella condivisione di file diventano tabelle SQL di sola lettura contenenti nomi, dimensioni, estensioni e date: l’Agent li indicizza nella posizione originale, mantiene l’indice aggiornato in una cache locale crittografata e non carica né modifica nulla. La prima configurazione richiede circa quindici minuti ed è inclusa nel piano gratuito.

Inizia gratis
Tre fogli di file disposti in pila isometrica, collegati da una linea a un’unica tessera di tabella
Hai bisogno di aiuto? Chiedi pure a noi. Apri Supporto Accedi a Query Streams (menu in alto a destra → Supporto) e inviaci un messaggio. Persone reali lo leggono, e "Non so cosa mi stia chiedendo questa schermata" è una domanda assolutamente legittima.

Quello che otterrai alla fine

Icona del file systemSi ottiene così un inventario in tempo reale di tutti i file presenti nelle cartelle selezionate, sotto forma di tabelle SQL. fileset.files elenca ogni file presente al momento con il relativo percorso, dimensione e date, set di file, file ed eventi registra ogni file che è apparso, cambiato o scomparso e fileset.directory Mostra le dimensioni di ciascuna cartella. Il contenuto dei file non viene mai letto, quindi si tratta di un indicizzatore di file, non di un lettore di file. L'agente crea le tabelle sul computer in cui è in esecuzione e i file rimangono sulla rete locale.

Il file system non ha una tabella dati, perché non legge il contenuto dei file. Tutto si trova in un unico schema DuckDB chiamato set di file, memorizzate nella cache sul computer dell'agente e aggiornate a ogni scansione. Si ottengono cinque tabelle e una vista.

TavoloCosa contiene
fileset.filesEcco una panoramica dei file attualmente presenti: percorso relativo, nome, estensione, dimensione_byte, creato_utc, UTC modificato, hash e proprietario (Solo per Windows). Interroga questo.
set di file.file_correntiIl registro completo dietro la vista, compresi i file scomparsi, con stato, primo_visto_utc, ultimo_visualizzato_utc e conteggio_cambio. Non unirlo mai a file.
set di file, file ed eventiCronologia delle modifiche: tipo_evento (apparso, modificato, scomparso, alla deriva, rifiutato), evento_al, prev_size_bytes, rilevato_da e dettaglio.
fileset.directoryUna riga per cartella: conteggio_file_diretti, subtree_bytes, il file più vecchio e quello più recente, e un salta_motivo ad esempio profondità massima.
fileset_directory_snapshotsÈ consentita al massimo una singola istantanea delle dimensioni per cartella al giorno, per tenere conto della crescita nel tempo.
fileset.volumescapacità_byte e byte_liberi per ogni unità.
DOVE RISIEDE IL FILEun computer o una condivisione di file che l'Agente può aprireLa tua cartellaFileI file restano dove sonoAgente Query Streamsanalizza la cartella, crea tabellein una cache locale, esegue l'SQLSOLO SELECT, obbligatorio quiFlussi di queryun collegamento in uscitacontrolla chi può vedere cosa · registra ogni queryDOVE LO USIqualsiasi computer, qualsiasi browserExcel · Fogli Google · NovaClaude · API REST · Automazioniguarda le righe, mai i file
L'agente legge la cartella sul proprio computer, memorizza le righe in una cache locale crittografata ed esegue ogni query su tale cache. Solo le righe restituite da una query vengono inviate all'esterno, tramite un'unica connessione in uscita. Nessuna porta da aprire, nessuna VPN, nessun caricamento.

Dove si guadagna da vivere:

Cosa ti servirà

Un account Query Streams

I connettori per le cartelle sono disponibili in tutti i piani, incluso quello gratuito. Il piano gratuito è un piano a lungo termine, non una prova che scade. Non c'è limite al numero di file che una cartella può contenere.

L'agente, versione 2.6.0 o successiva

Installato su un computer in grado di aprire la cartella: il file server stesso, un computer dell'ufficio o la macchina su cui finiscono i file. Un agente più vecchio mostra le schede delle cartelle in grigio con un Agente 2.6.0+ Distintivo. Windows, Mac o Linux.

Il percorso della cartella, così come lo vede l'agente.

Un percorso locale o una condivisione di rete scritta come \\server\condiviso\cartellaL'agente viene eseguito come servizio, quindi non può vedere le unità mappate al momento dell'accesso (Z: e simili). Su Windows può accedere a una condivisione con un login memorizzato; su Linux o Mac, montare prima la condivisione (Linux sotto /mnt o /media, un Mac sotto /Volumi).

Dove si svolge il lavoro? Sul computer che esegue l'agente. Scansiona la cartella, copia le righe in una cache locale crittografata lì (uno schema, denominato set di filee esegue ogni query su quella cache. I tuoi file vengono letti, mai modificati, spostati o caricati.

Configuralo in cinque passaggi

  1. Installa l'agente su un computer in grado di aprire la cartella

    Accedi, apri ScaricamentoInstalla l'agente per il tuo sistema sul computer che può aprire i file e le cartelle sul tuo computer o sulla condivisione di file: il server di file o qualsiasi computer sempre acceso in grado di accedere alla condivisione. L'installazione richiede un minuto e da quel momento in poi si avvierà automaticamente. È necessaria la versione 2.6.0 o successiva; la pagina di download contiene sempre la versione più recente.

    Perché un piccolo programma invece di un driver? L'Agent richiede un'unica installazione per Windows, Mac o Linux (circa 85 MB su Windows, poco più di 100 MB su Mac e Linux). Apre una connessione crittografata in uscita verso Query Streams e questo è l'unico percorso di rete necessario: non è necessario aprire alcuna porta in entrata né utilizzare una VPN. Legge i file nella cartella in cui si trova, quindi i file rimangono al loro posto e solo le righe restituite da una query vengono inviate tramite Internet al componente aggiuntivo, al browser o al client AI installato.

    La pagina di download mostra La tua chiave di accesso. Incollalo nell'Agente quando richiesto e attendi che il badge venga letto Connesso ai flussi di queryQuesta è l'unica operazione che devi eseguire sul computer dell'agente; tutto il resto avviene nel tuo browser.

    Se volete, potete trovare le guide complete: Finestre, Mac, Linux.

  2. Puntalo verso i file e le cartelle sul tuo computer o sulla condivisione di file

    Torna al tuo browser aperto Dati → Agenti dati, trova l'agente che hai appena installato e fai clic sul suo Aggiungi connettore pulsante. Apri il File e cartelle pillola e scegli la Sistema di file carta. Non sai quale carta è adatta? Scegli File in una cartella Invece: l'agente analizza la cartella, elenca il contenuto in una pagina "Cosa abbiamo trovato" e apre la scheda corretta, già precompilata.

    Il mago corre Cartelle → Verifica → Impostazioni → Realm → Rivedi. SU Cartelle:

    Cartelle radice
    Un percorso per riga, come lo vede il computer dell'agente. Ogni cartella mostra uno stato (raggiungibile, negato, mancante, irraggiungibile, credenziali non valide o non montata) non appena la aggiungi. Su un agente Windows, una condivisione che necessita di un login ne ottiene uno dalla cartella. Credenziali colonna, memorizzata una sola volta per server; su Linux o Mac, montare prima la condivisione.
    Scansiona le sottocartelle, profondità massima
    Attivato, e 8 livelli, di default.
    Includi modelli, escludi modelli
    Quali file contano. Il modello di inclusione inizia con il glob corretto per questa scheda. Un connettore legge un tipo di file: una cartella con CSV e I file Parquet contengono due connettori nella stessa cartella, uno per tipo.
    Segui i collegamenti simbolici e le giunzioni
    Disattivato per impostazione predefinita. L'agente non segue i collegamenti rapidi o i segnaposto cloud a meno che non si attivi questa opzione.

    Inizia dal Aggiungi connettore pulsante di un agente che può aprire la cartella Apri File e cartelle e clicca sul Sistema di file carta.

    • Cartelle radice: una cartella per riga, come percorsi sul computer dell'agente. Digitare una condivisione di rete come \\server\condiviso\cartella, non come lettera di unità mappata come Z:, perché l'agente viene eseguito come servizio e non può vedere le unità mappate al momento dell'accesso. Su un agente Windows, se la condivisione consente l'accesso solo a utenti nominati, fare clic su Identità del servizio nella cartella Credenziali colonna e memorizza le credenziali di accesso per quel server. Su Linux o Mac, monta prima la condivisione. Accesso a un file su una condivisione di rete contiene le istruzioni per ciascun sistema.
    • Scansiona le sottocartelle è acceso e Profondità massima è 8.
    • Includi modelli inizia come **/*.csvAggiungi un modello per ogni tipo di file che desideri elencare e utilizzalo Escludi modelli per qualsiasi cosa da omettere.
    • Non c'è Nome della tabella campo. Il file system crea solo le tabelle di inventario.
  3. Controlla cosa costruirà

    SU Controllo L'agente legge un campione di massimo 64 file e mostra cosa creerà. Non è ancora stato creato nulla. Il pulsante dice Verifica la connessione fino a quando non ci sarà un verdetto, allora Avanti; Prova di nuovo Il programma riesegue il campione dopo ogni modifica. Verrà visualizzato uno dei quattro titoli seguenti:

    Pronto a creare
    Ogni file campionato rientra nel campione. I chip sottostanti indicano quante cartelle sono accessibili, quanti file e righe sono presenti e quali tabelle saranno presenti.
    Pronto, con appunti
    Alcuni file verranno messi da parte oppure il controllo del layout verrà rifiutato. Un banner ambra indica esattamente quali: "{n} di {m} file(s) verranno messi da parte" con un Mostra quali file e perché elenco e "Puoi comunque crearlo: il connettore continuerà a ricontrollare e a segnalare il motivo nella sua scheda Manifesto."
    Necessita di attenzione
    L'agente è offline oppure manca una cartella. Risolvi il problema prima di continuare; se l'agente è offline, la pagina lo segnala ma ti permette comunque di proseguire.

    Un rifiuto o un file accantonato non ti bloccano mai: clicca AvantiCompleta la procedura guidata e correggi i file anomali in seguito. Solo un agente offline o una cartella mancante interrompono la procedura guidata.

    SU Controllo, l'agente legge un esempio e mostra cosa costruirà. Non è ancora stato creato nulla. Per File System il verdetto riguarda la portata, non il layout: un verde Pronto a creare Titolo con chip per “{n} di {m} cartelle raggiungibili”, il numero di file e la dimensione totale. Un rosso Necessita di attenzione significa che l'agente è offline o che manca una cartella e la pagina visualizza il messaggio "Agente offline: il test richiede un agente in esecuzione". Una cartella specificata come lettera di unità mappata riceve un avviso giallo nella fase Cartelle prima di arrivare a Verifica.

  4. Scegli la frequenza di scansione, quindi creala

    Le impostazioni predefinite su Impostazioni Adatto a una cartella che riceve pochi file al giorno. Quattro che potresti voler modificare:

    Intervallo di scansione
    Ogni ora Per impostazione predefinita, è possibile scegliere tra ogni 5 minuti e ogni giorno. Ogni scansione confronta le dimensioni e l'ora di modifica per trovare file nuovi, modificati o eliminati.
    Monitora la cartella per eventuali modifiche (quasi in tempo reale)
    Disattivato per impostazione predefinita. Attivato, l'agente reagisce in pochi secondi sui dischi locali; sulle condivisioni di rete, il funzionamento è "best-effort" e la scansione pianificata rimane la garanzia. Periodo di quiete (15 secondi) attende che la scrittura di un file sia completata.
    Aggiorna la pagina prima di rispondere a una domanda
    Disattivato per impostazione predefinita. In caso di attivazione, una query esegue nuovamente la scansione quando l'ultima scansione è precedente alla Finestra di invecchiamento (60 secondi), aspettando al massimo il limite di attesa della query (5 secondi). Si applica a persone e componenti aggiuntivi, non al polling degli avvisi.
    Quando un file scompare
    Abbassa le sue righe di default, oppure Mantieni le righe, contrassegna gli elementi eliminati (lapide). IL Rapporto di guardia scomparso (0.5) rifiuta una scansione che perde più della metà dei file in una volta e mantiene l'inventario precedente, che è ciò che appare in una condivisione offline.

    Quindi scegli il Regno dei dati le righe contano contro, controlla Revisione e clicca Crea connettore. La prima scansione inizia subito. Il connettore Manifesto La scheda mostra cosa è stato compilato e tutti i file che sono stati messi da parte.

  5. Guarda le tue tabelle

    Apri il connettore: il Manifesto la scheda elenca le tabelle create. Nella Generatore di query gli stessi tavoli si trovano sotto il set di file schema. Tre query che funzionano fin dal primo giorno:

    Quanto spazio occupa ogni tipo di file
    SELECT extension, COUNT(*) AS files, SUM(size_bytes) AS total_bytes FROM fileset.files GROUP BY extension ORDER BY total_bytes DESC LIMIT 100

    Indica quali tipi di file sono presenti nella condivisione e quanti ne contiene ciascuno.

    Le cartelle più grandi e quelle che sono state saltate
    SELECT path, subtree_file_count, subtree_bytes, skip_reason FROM fileset.directories ORDER BY subtree_bytes DESC LIMIT 100

    Classifica le cartelle in base alla dimensione totale e mostra quelle che la scansione non ha incluso, ad esempio quelle che hanno superato la profondità massima.

    Cosa è scomparso negli ultimi sette giorni?
    SELECT relative_path, prev_size_bytes, detected_by, event_at FROM fileset.files_events WHERE event_type = 'vanished' AND event_at >= now() - INTERVAL 7 DAY ORDER BY event_at DESC LIMIT 100

    Elenca ogni file scomparso, le sue dimensioni e quando la scansione lo ha rilevato.

    Ogni connettore di cartella serve anche le stesse tabelle di contabilità, tutte nella set di file schema:

    TavoloCosa contiene
    fileOgni file attualmente presente nella cartella: percorso, nome, estensione, dimensione, data di creazione e di modifica, prima e ultima visualizzazione. Una panoramica file_correntiche conserva anche i file scomparsi.
    file_eventiLa cronologia delle modifiche: una riga per file che apparso, era modificato, scomparso, è stato messo da parte (deriva) o era rifiutato, con il tempo in evento_al, come è stato notato in rilevato_da e il motivo in dettaglio.
    elenchi, istantanee della directory, volumiNumero e dimensioni delle cartelle, come sono cresciute e i dischi o le condivisioni su cui risiedono le directory principali.
    _source_file, _row_idDue colonne su ogni riga di dati: il file da cui proviene la riga e un ID di riga stabile all'interno di quel file. Raggruppa per _source_file per confrontare i file.

Questo è tutto. Basta trascinare un nuovo file nella cartella e, dopo la scansione successiva, questo sarà presente nella tabella. I file non hanno mai lasciato il computer su cui si trovavano.

Accesso a un file su una condivisione di rete

L'agente apre i file come servizio in background, non come utente diretto, quindi per aprire un file su un altro computer è necessario un passaggio aggiuntivo. Il tipo di passaggio dipende dal computer su cui è in esecuzione l'agente.

Finestre

Digita il percorso di rete, ad esempio \\server\condiviso\cartella, mai una lettera di unità mappata come S:che l'agente non può vedere. Se la condivisione consente solo l'accesso a persone nominate, fai clic Identità del servizio (il chip sotto il percorso o la cartella Credenziali colonna) e memorizzare un login per quel server: un account di dominio aziendale o un account creato sul server stesso con Dominio lasciato vuoto. L'agente quindi accede a quel server e legge il file lì, e ogni connettore su quell'agente che legge lo stesso server deve utilizzare lo stesso login. Senza un login, legge come il proprio account di servizio, che un dominio aziendale vede come il computer stesso. Procedura passo passo su Windows

Linux

Le credenziali di accesso condivise memorizzate nel portale non vengono utilizzate su Linux: un amministratore monta prima la condivisione sul computer dell'agente, in una cartella sotto /mnt o /media, perché il servizio dell'agente non può vedere /casa o /run/user. Nel connettore, mantieni il \\server\share percorso, che l'agente mappa sul mount, oppure digita invece il percorso del mount, ad esempio /mnt/fileserver-shared/Accounts. Come montare una condivisione su Linux

Mac

Le credenziali di accesso condivise memorizzate nel Portale non vengono utilizzate su un Mac: monta prima la condivisione dal Terminale con sudo, in una cartella sotto /Volumi, in modo che il servizio in background dell'agente possa vederlo. Nel connettore, mantieni il \\server\share percorso, che l'agente mappa sul mount, oppure digita invece il percorso del mount, ad esempio /Volumi/server di file condiviso/Account. Come montare una condivisione su un Mac

Se il test non riesce ad accedere alla condivisione, cerca queste parole nel risultato: irraggiungibile significa che il computer dell'agente non ha ricevuto risposta dal server. Su Linux o Mac, non montato significa che la condivisione deve ancora essere montata e il messaggio include il comando di montaggio esatto per il tuo server.

Cartelle su una condivisione? Su Windows, un singolo account di accesso è valido per tutte le cartelle aggiunte dallo stesso server. Controlla la cartella per eventuali modifiche Funziona anche in modalità condivisa, senza impegno; la scansione programmata è ciò che garantisce il rilevamento di ogni modifica.

Quando una cartella non è raggiungibile

Ogni cartella sulla Cartelle Il passaggio mostra uno stato non appena lo aggiungi. Passa il mouse sopra lo stato per leggere il messaggio dell'agente; le sue prime parole indicano di quale caso si tratta.

Stato o messaggioCosa significaCosa fare
negatoLa condivisione non ha consentito l'accesso all'agente. Senza credenziali di accesso memorizzate, un agente Windows legge come il proprio account di servizio, che un dominio aziendale vede come il computer stesso.Windows: clicca Identità del servizio nella cartella Credenziali colonna e memorizza un login che può leggere la condivisione oppure chiedi a chi gestisce il server di concedere l'accesso in lettura a quello memorizzato. Linux o Mac: la condivisione è montata, ma i suoi permessi impediscono all'Agente di entrare; controlla come è montata (Linux, Mac).
credenziali non valide, o Le credenziali memorizzate per \\server sono state rifiutateIl server ha rifiutato le credenziali di accesso memorizzate: errore di battitura, dominio errato o password modificata. L'agente attende un minuto prima di riprovare l'accesso, in modo che l'account non venga bloccato.Fai clic sul nome dell'account in Credenziali colonna e digita nuovamente il login. Per un account creato sul server stesso, lascia Dominio vuoto.
mancanteNessuna cartella a quel percorso. Su Windows, anche un nome server non trovato o una condivisione non presente sul server vengono visualizzati come mancanti.Controlla i nomi oppure scegli la cartella con Aggiungi cartella dall'agente invece di digitarlo.
irraggiungibile, o Il server non ha rispostoNessuna risposta dal server: è spento, il nome è errato oppure un firewall blocca la condivisione dei file.Apri lo stesso \\server\share percorso sul computer dell'agente. Se anche questo non funziona, si tratta di un problema di rete.
non montato (Linux o Mac)La condivisione non è montata sul computer dell'agente. Passa il mouse sopra lo stato o il Non montato Chip in the Credenziali colonna, per il comando di montaggio esatto.Monta la quota (Linux, Mac), quindi testa di nuovo la cartella.
Un altro connettore su questo agente effettua già l'accesso a \\server come...Windows consente un solo account per server di file su ciascun computer, e un altro connettore su questo agente ne utilizza uno diverso.Utilizza le stesse credenziali di accesso di quel connettore oppure modificale per ogni connettore che si connette a questo server.
Windows detiene già un login a \\server per…Sul computer dell'agente è presente un altro programma connesso a quel server con un account diverso, e l'agente non chiude mai un accesso che non ha effettuato.Segui il messaggio: indica l'account Windows con cui viene eseguito l'agente e dice se Utilizzare l'identità del servizio leggerebbe la condivisione tramite l'accesso esistente.
Questa build dell'agente non può accedere a \\server con le credenziali memorizzate.Un agente meno recente che non può utilizzare un login di condivisione memorizzato.Aggiorna l'agente, quindi esegui nuovamente il test.

Usalo ovunque

Il connettore è un'origine dati come qualsiasi altra in Query Streams. Salva una query una volta nel Generatore di query (il dialetto è DuckDB) e utilizzalo da:

Excel

Il componente aggiuntivo Trasmetti una query trascina le righe in un foglio e le riesegue con un clic. Esecuzione di query SQL in Excel.

Fogli di Google

IL Streamer di query Il componente aggiuntivo riempie la scheda che selezioni. Power Query per Google Sheets.

Claude, Cursor e altri client di intelligenza artificiale

Tramite il server Query Streams MCP; Claude conosce il modello di cartella, incluso _source_file e file_eventi. File system con Claude tramite MCP.

API REST

Ogni query salvata diventa un endpoint di sola lettura con una propria chiave, indipendentemente dal piano. API REST del file system.

Nova

Chiedi in modo chiaro e semplice riguardo al piano Business; Nova conosce ogni cartella, tabella e colonna grazie alle sue descrizioni predefinite.

Automazioni

Sincronizza le righe con Airtable, Smartsheet, Baserow, SeaTable o un foglio di calcolo in base a una pianificazione. Guide all'automazione.

Le tabelle delle cartelle si uniscono anche agli altri connettori: una query federata può corrispondere _source_file nomi o ID ordine nei file e nelle cartelle del computer o nella condivisione file rispetto a un database sullo stesso agente.

Come vengono visualizzati i file nuovi, modificati ed eliminati

File nuovi e modificati

Su ogni Intervallo di scansione (o in pochi secondi con Cartella di monitoraggio su) un nuovo file che si adatta al layout ha le sue righe aggiunte e ottiene un apparso evento. Un file modificato viene riletto in una transazione: le sue vecchie righe vanno, le sue nuove righe arrivano e ottiene un modificato evento.

File eliminati

Un file che scompare elimina le sue righe per impostazione predefinita, oppure le mantiene contrassegnate come eliminate se hai scelto l'opzione lapide e ottiene un scomparso evento. Se più della metà dei file scompare contemporaneamente, la scansione viene rifiutata e l'inventario precedente rimane: una condivisione offline si presenta esattamente in questo modo.

File da mettere da parte

Un file che non si adatta al layout, non può essere aperto o supera un limite viene messo da parte per intero: nessuna delle sue righe viene caricata e file_eventi ottiene un deriva riga che denomina il file e la colonna. Correggi il file e salvalo; la scansione successiva riprova.

Quanto è fresco ciò che vedo?

Le query rispondono dall'ultima scansione. Non c'è un pulsante Riscansiona o Sincronizza ora; l'intervallo di scansione, il monitoraggio della cartella e Aggiorna la pagina prima di rispondere a una domanda sono i tre comandi. MAX(ultimo_visto_utc) da file_correnti Ti indica quando l'agente ha effettuato l'ultima verifica.

File che vengono messi da parte

Nella fase di verifica e nella scheda Manifest compaiono tre parole che hanno significati diversi:

Riservato (parcheggiato)
Il file non corrisponde al layout bloccato, oppure è illeggibile, strappato, bloccato o coperto da un cappuccio. Per ogni file, la regola è "tutto o niente": un file parcheggiato non contribuisce con nessuna riga. file_eventi registra un deriva fila la cui dettaglio Il programma specifica il nome del file e della colonna. Il file viene ignorato finché le sue dimensioni e la data di modifica rimangono invariate, e viene riprovato non appena si verificano delle modifiche.
Illeggibile
L'agente non è riuscito ad aprire o analizzare il file a causa del suo tipo: non è una vera cartella di lavoro, è bloccato da un altro programma, è un segnaposto cloud, contiene byte non decodificabili. Il file viene archiviato automaticamente e il resto della cartella continua. Solo una cartella con zero file leggibili rifiuta l'intero set.
Rifiutato
L'agente non è riuscito a fissare alcun layout, ad esempio perché i file non concordano sul tipo di colonna. Non esiste ancora alcuna tabella dati. file_eventi ottiene un rifiutato riga con il motivo in dettaglioe l'agente riprova a ogni scansione finché non viene trovato un layout. Correggi o escludi il file indicato e il messaggio scomparirà.

Dove guardare: lo striscione ambra su Controllo (Mostra quali file e perché), del connettore Manifesto tab successivamente. In SQL: SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.

Per i file e le cartelle presenti sul tuo computer o nella condivisione di file, l'aspetto è solitamente il seguente: Il file system non legge alcun contenuto, quindi i file non vengono riservati per il layout; il caso più simile è una cartella più profonda di Max depth, che appare in fileset.directories con skip_reason 'max_depth', oppure una condivisione che va offline, dove il rapporto di protezione di Vanish rifiuta la scansione e viene mantenuto l'inventario precedente.

Limiti che vale la pena conoscere

Non ci sono limiti di piano per quanto riguarda le cartelle o il numero di file. Le righe vengono conteggiate nel tuo Data Realm come qualsiasi altro connettore. È possibile aumentare o diminuire i valori predefiniti del connettore:

CollocamentoPredefinitoCosa fa
Profondità massima8Quanti livelli di cartella al di sotto di ciascuna radice vengono analizzati (1–64).
Numero massimo di file per scansione100,000I file vengono considerati in un'unica operazione.
Dimensione massima del file da sottoporre ad hashing32 MiBConta solo con Contenuto del file hash SU.
Conservazione dei registri eventi30 giorniPer quanto file_eventi Le righe vengono mantenute.
Parallelismo di scansione per radice2Cartelle lette una sola volta per ogni directory principale.

Limiti di contenuto, che parcheggiano un file anziché troncarlo: 2.000.000 di righe o 512 MiB per file, 10.000.000 di righe o 2 GiB per scansione. Una cartella può contenere al massimo 25 layout distinti in Un tavolo per ogni disposizione modalità.

Domande che le persone si pongono

Il connettore del file system legge il contenuto dei miei file?

No. Registra il percorso, il nome, la dimensione, le date e la cronologia delle modifiche di ciascun file. Il contenuto dei file non viene mai letto. Per interrogare le righe all'interno di file CSV o Excel, aggiungi la scheda corrispondente nella stessa cartella: vedi Unire più file CSV in un'unica tabella o Unire più file Excel in un'unica tabella.

Come fa il sistema a rilevare l'eliminazione di un file?

Ogni scansione confronta la cartella con il registro in base alle dimensioni e all'ora di modifica. Un file mancante viene contrassegnato come scomparso e riceve un scomparso riga in file_eventi. Se una condivisione perde improvvisamente la maggior parte dei suoi file, di solito perché è andata offline, Rapporto di guardia scomparso rifiuta la scansione e l'ultimo inventario valido viene mantenuto invece di eliminare tutto.

È possibile indicizzare una condivisione di rete o una cartella OneDrive sincronizzata?

Sì. Su un agente Windows, digita la condivisione come \\server\condiviso\cartella; se consente l'accesso solo a persone nominate, memorizza un login per quel server dalla cartella Credenziali colonna. Su Linux o Mac, gli accessi memorizzati nel portale non vengono utilizzati: montare prima la condivisione, in /mnt o /media su Linux o in /Volumes su Mac, come Accesso a un file su una condivisione di rete spiega. Una cartella OneDrive o Dropbox sincronizzata funziona quando i suoi file sono archiviati sul computer, quindi imposta la cartella su Tenere sempre acceso questo dispositivoL'agente non scarica i file disponibili solo nel cloud.

Perché manca una cartella dalle tabelle?

Cercalo in fileset.directoryUna cartella più profonda di Profondità massima (8 per impostazione predefinita) è elencato con salta_motivo impostato su profondità massima. I collegamenti simbolici, le giunzioni e i segnaposto delle nuvole non vengono seguiti a meno che Segui i collegamenti simbolici e le giunzioni è attivo. Una cartella che l'agente non può aprire mostra uno stato sulla sua riga non appena la aggiungi.

Quanto è aggiornato l'inventario e come posso aggiornarlo?

L'agente controlla le cartelle sul Intervallo di scansione, ogni ora per impostazione predefinita. Monitora la cartella per eventuali modifiche (quasi in tempo reale) reagisce in pochi secondi sui dischi locali ed è al meglio delle possibilità sulle condivisioni di rete. Non c'è un pulsante di aggiornamento. Per vedere quanto sono aggiornate le tabelle, esegui MAX(ultimo_visto_utc) da set di file.file_correnti o MAX(evento_a) da set di file, file ed eventi.

I miei file sono stati caricati da qualche parte?

No. L'agente legge i file sul proprio computer e memorizza le righe in una cache locale crittografata. Una query viene eseguita su tale cache e solo le righe restituite lasciano la macchina, tramite un'unica connessione in uscita. I file non vengono mai modificati, spostati o convertiti.

Devo aprire una porta o usare una VPN?

No. L'agente effettua una connessione in uscita sulla porta 443 e sia le richieste che le righe transitano attraverso di essa. Se HTTPS in uscita funziona, anche questo funziona.

La cartella può trovarsi su una condivisione di rete, su OneDrive o su Dropbox?

Sì. Digita una condivisione come \\server\condiviso\cartella, perché l'agente viene eseguito come servizio e non può vedere le unità mappate al tuo login. Su Windows, memorizza un login per il server se la condivisione consente solo utenti nominativi; senza di esso, l'agente legge come il proprio account di servizio. Su Linux o Mac, monta prima la condivisione. Una cartella OneDrive o Dropbox sincronizzata funziona quando i suoi file sono archiviati sul computer: imposta la cartella su Tenere sempre acceso questo dispositivoL'agente non scarica i file disponibili solo nel cloud.

La cartella contiene più di un tipo di file. Un connettore o due?

Un connettore legge un solo tipo di file. Una cartella contenente file CSV e Parquet ha due connettori sulla stessa directory principale, uno per tipo. I file che non corrispondono al modello di inclusione vengono ignorati, non messi da parte.

È presente un pulsante per ripetere la scansione?

No. L'agente esegue la scansione su Intervallo di scansione, reagisce ai cambiamenti quando Cartella di monitoraggio è attivo e può eseguire una nuova scansione prima di rispondere a una query quando lo attivi. Modifica il connettore per cambiare una qualsiasi delle tre opzioni.

Il piano gratuito copre davvero tutto questo?

Sì. La versione gratuita è un piano che mantieni, non una versione di prova che scade. I connettori di cartella non hanno un limite di file proprio; le righe vengono conteggiate nel tuo Data Realm come qualsiasi altro connettore. Scopri cosa include ogni piano su pagina dei prezzi.

Altre cartelle Query Streams si trasformano in tabelleCome interrogare una cartella di file con SQLTutte le guide ai set di file
Ancora bloccato? Apri Supporto Accedi a Query Streams e comunicaci a quale passaggio ti trovi e cosa visualizzi. Ti aiuteremo a connetterti.

Ogni guida per File System

Non è proprio la tua configurazione?

  • Hai bisogno dei dati contenuti nei file, non solo dell'elenco? Seleziona la scheda corrispondente al tipo di file, ad esempio Cartella CSV o Cartella Excel → Come interrogare una cartella di file

Problemi di configurazione?

  • L'agente segnala che il file o la cartella non esistono oppure che l'accesso è negato? Unità mappate, condivisioni di rete, OneDrive e cartelle home di Linux necessitano ciascuna di una correzione → Da dove l'agente può leggere i file
  • L'agente risulta offline oppure le opzioni "Verifica connessione" e "Sfoglia" sono disattivate? Verifica che l'agente sia online → L'agente è online?
Updated on Novembre 9, 2026

Powered by BetterDocs