View Categories

Menggabungkan Beberapa File Excel Menjadi Satu Tabel

Konektor folder · Folder Excel

Ubah folder berisi buku kerja Excel menjadi Tabel SQL Anda dapat melakukan kueri di mana saja.

Arahkan Query Streams Agent ke folder tersebut. Agen ini membaca file di komputernya sendiri, membangun tabel di cache lokal di sana, dan memperbaruinya secara berkala saat file datang, berubah, atau hilang. Anda dapat melakukan query dari Excel, Google Sheets, Nova, Claude, atau REST API. Tidak ada yang diunggah dan tidak ada file yang dikonversi atau diedit.

Sekitar 15 menit Tidak perlu coding. File tetap berada di jaringan Anda. Paket gratis mencakup hal tersebut.
Mengalami kesulitan di suatu titik? Tanyakan saja pada kami. Membuka Dukungan Di Query Streams (menu kanan atas → Dukungan) dan kirimkan pesan kepada kami. Ada orang sungguhan yang membacanya, dan "Saya tidak tahu apa yang diminta layar ini" adalah pertanyaan yang sangat wajar.

Inilah hasil akhirnya

Ikon Folder ExcelPada akhirnya, Anda akan memiliki satu tabel SQL per lembar kerja, misalnya. kumpulan file.pesanan_data, menyimpan baris lembar tersebut dari setiap buku kerja di dalam folder, dengan berkas sumber Kolom tersebut menyebutkan buku kerja asal setiap baris. Masukkan buku kerja bulan depan dan baris-barisnya akan bergabung dengan tabel pada pemindaian berikutnya; perbaiki yang lama dan baris-barisnya akan diganti. Agen membaca .xlsx File-file tersebut tersimpan di komputer tempat program dijalankan dan menyimpan baris-baris data di sana, sehingga buku kerja tetap berada di jaringan Anda.

Semuanya berada dalam satu skema DuckDB yang disebut kumpulan file, disimpan dalam cache di komputer Agen. Tabel-tabel tersebut diberi nama untuk Anda, karena tidak ada Nama tabel bidang. Setiap baris berisi berkas sumber dan _id_baris.

MejaApa yang terkandung di dalamnya
kumpulan file.pesanan_dataDengan Satu tata letak yang disematkan, satu tabel per lembar bernama data_<lembar>, menyimpan baris-baris lembar tersebut dari setiap buku kerja. Lembar membatasi lembar mana yang menjadi tabel.
kumpulan file.anggaranDengan Satu meja per tata letak, satu tabel per tata letak, diberi nama berdasarkan bagian nama file yang sama dengan angka di belakangnya dihilangkan, atau nama lembar jika tidak ada yang dapat digunakan lagi. Nama tidak pernah berubah selama tata letak tetap disematkan.

Setiap konektor folder juga memberi Anda berkas, file_kejadian, direktori, cuplikan direktori dan volumeyang mencantumkan buku kerja itu sendiri, riwayat perubahannya, dan ukuran foldernya.

DI MANA BERKAS-BERKAS ITU TERSIMPANkomputer atau berbagi file yang dapat dibuka oleh Agen.Folder Andadari fileberkas tetap berada di tempatnyaAgen Aliran KueriMemindai folder, membuat tabeldi dalam cache lokal, menjalankan SQL.Hanya PILIH, diberlakukan di siniAliran Kuerisatu tautan keluarMemeriksa siapa yang boleh melihat apa · Mencatat setiap kueriDI MANA ANDA MENGGUNAKANNYAkomputer apa pun, peramban apa punExcel · Google Sheets · NovaClaude · REST API · OtomatisasiLihat barisnya, jangan pernah melihat berkasnya.
Agen membaca folder di komputernya sendiri, menyimpan baris-baris tersebut dalam cache lokal terenkripsi di sana, dan menjalankan setiap kueri terhadap cache tersebut. Hanya baris-baris yang dikembalikan oleh kueri yang dikirim keluar, melalui satu koneksi keluar. Tidak perlu membuka port, tidak perlu VPN, tidak perlu unggah.

Di sinilah letak keberhasilannya:

Yang Anda butuhkan

Akun Query Streams

Konektor folder tersedia di semua paket, termasuk paket Gratis. Paket Gratis adalah paket permanen, bukan uji coba yang akan berakhir. Tidak ada batasan jumlah file yang dapat ditampung oleh sebuah folder.

Agen, versi 2.6.0 atau lebih baru

Diinstal pada komputer yang dapat membuka folder: server file itu sendiri, komputer kantor, atau mesin tempat file tersebut berada. Agen versi lama menampilkan kartu folder berwarna abu-abu dengan tanda centang. Agen 2.6.0+ Lencana. Windows, Mac, atau Linux.

Jalur folder, seperti yang dilihat oleh Agen.

Jalur lokal, atau berbagi jaringan yang ditulis sebagai \\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 atau /media, a Mac under /Volumes).

Di mana pekerjaan itu dilakukan? Pada komputer yang menjalankan Agen. Komputer tersebut memindai folder, menyalin baris ke dalam cache lokal terenkripsi di sana (satu skema, bernama kumpulan file) dan menjalankan setiap kueri terhadap cache tersebut. File Anda hanya dibaca, tidak pernah dimodifikasi, dipindahkan, atau diunggah.

Siapkan dalam lima langkah

  1. Instal Agen pada komputer yang dapat membuka folder tersebut.

    Masuk, buka UnduhKemudian instal Agen untuk sistem Anda di komputer yang dapat membuka folder buku kerja Excel: server file, atau komputer mana pun yang selalu aktif dan dapat mengakses folder bersama tersebut. Proses ini hanya membutuhkan waktu satu menit dan akan berjalan secara otomatis setelah itu. Anda memerlukan versi 2.6.0 atau yang lebih baru; halaman Unduhan selalu menyediakan versi terbaru.

    Mengapa menggunakan program kecil alih-alih driver? Agent ini merupakan instalasi tunggal untuk Windows, Mac, atau Linux (sekitar 85 MB di Windows, sedikit lebih dari 100 MB di Mac dan Linux). Agent ini membuka satu koneksi terenkripsi keluar ke Query Streams dan hanya itu jalur jaringan yang dibutuhkannya: tidak ada port masuk yang perlu dibuka, tidak ada VPN. Agent ini membaca folder tempatnya berada, sehingga file tetap di tempatnya dan hanya baris yang dikembalikan oleh kueri yang dikirim melalui internet ke add-in, browser, atau klien AI di sisi Anda.

    Halaman Unduhan menampilkan Kunci Akses AndaTempelkan ke dalam Agent saat diminta, dan tunggu hingga badge terbaca. Terhubung ke Aliran KueriItulah satu-satunya hal yang Anda lakukan di komputer Agen; semua hal lainnya terjadi di browser Anda.

    Panduan lengkap jika Anda menginginkannya: Windows, Mac, Linux.

  2. Arahkan ke folder berisi buku kerja Excel.

    Kembali ke browser Anda, buka Data → Agen Data, temukan Agen yang baru saja Anda instal dan klik Agen tersebut. Tambahkan konektor tombol. Buka Berkas & Folder pil dan pilih Folder Excel kartu. Tidak yakin kartu mana yang cocok? Pilih Berkas dalam sebuah folder Sebagai gantinya: Agen akan mengambil sampel folder, menyebutkan isinya di halaman "Apa yang kami temukan" dan membuka kartu yang tepat untuk Anda, yang sudah terisi sebelumnya.

    Penyihir itu berlari Folder → Periksa → Pengaturan → Realm → Tinjau. Pada Folder:

    Folder akar
    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.
    Pindai subfolder, Kedalaman maksimum
    Aktif, dan 8 level, secara default.
    Sertakan pola, Kecualikan pola
    File mana yang dihitung. Pola penyertaan dimulai dengan glob yang tepat untuk kartu ini. Satu konektor membaca satu jenis file: folder dengan CSV. dan File Parquet memiliki dua konektor pada folder yang sama, satu untuk setiap tipe.
    Ikuti symlink dan junction
    Secara default, fitur ini dinonaktifkan. Agen tidak mengikuti pintasan atau placeholder cloud kecuali Anda mengaktifkannya.

    Mulailah dari Tambahkan konektor Tombol pada Agen yang dapat membuka folder. Buka Berkas & Folder lalu klik Folder Excel kartu.

    • Folder akar: satu folder per baris, sebagai jalur pada komputer Agen. Ketikkan nama folder bersama jaringan sebagai \\server\share\folder, bukan sebagai huruf drive yang dipetakan.
    • Sertakan pola dimulai sebagai **/*.xlsx. Pindai subfolder sedang aktif.
    • Tidak ada Nama tabel bidang. Lembar kerja menjadi tabel seperti pesanan_data. Menggunakan Lembar untuk membatasi lembar mana yang dibaca.
    • Pilih Tata letak tabel. Satu tata letak yang disematkan (default) Cocok untuk buku kerja yang semuanya menggunakan lembar dan kolom yang sama. Satu meja per tata letak Map dokumen yang dirakit secara manual, dapat memuat hingga 25 tata letak.
  3. Periksa apa yang akan dibangunnya.

    Pada Memeriksa Agen membaca sampel hingga 64 file dan menunjukkan apa yang akan dibangun. Belum ada yang dibuat. Tombol bertuliskan Uji koneksi sampai ada putusan, maka Berikutnya; Coba lagi Program ini akan menjalankan ulang sampel setelah Anda mengubah sesuatu. Anda akan melihat salah satu dari empat judul berita berikut:

    Siap untuk membuat
    Setiap berkas yang diambil sampelnya akan muat. Chip di bawahnya menunjukkan berapa banyak folder yang dapat diakses, berapa banyak berkas dan baris, serta tabel mana yang akan ada.
    Siap, dengan catatan
    Beberapa berkas akan disisihkan, atau pendeteksian tata letak ditolak. Sebuah spanduk berwarna kuning menunjukkan dengan tepat yang mana: “{n} dari {m} berkas akan disisihkan” dengan Tunjukkan file mana dan mengapa. daftar, dan “Anda tetap dapat membuatnya — konektor akan terus memeriksa ulang dan melaporkan alasannya pada tab Manifest-nya.”
    Membutuhkan perhatian
    Agen sedang offline atau ada folder yang hilang. Perbaiki itu sebelum melanjutkan; jika Agen sedang offline, halaman akan menampilkannya dan tetap memungkinkan Anda untuk melanjutkan.

    “Folder ini berisi {n} tata letak file yang berbeda.” Panel berwarna biru langit berarti bahwa berkas yang diambil sampelnya tidak semuanya memiliki kumpulan kolom yang sama. Tata letak tabel defaultnya adalah Satu tata letak yang disematkan, yang mengharapkan setiap file cocok. Klik Beralih ke satu tabel per tata letak. dan setiap tata letak menjadi tabel tersendiri (hingga 25).

    Penolakan atau berkas yang disisihkan tidak akan pernah menghalangi Anda: klik saja. Berikutnya, selesaikan wizard dan perbaiki file yang bermasalah nanti. Hanya Agent yang offline atau folder yang hilang yang menghentikan wizard.

    Pada MemeriksaAgen membaca sampel hingga 64 buku kerja dan mencantumkan tabel yang akan dibuatnya. Belum ada yang dibuat. Buku kerja yang kehilangan lembar yang disematkan dihitung dalam spanduk kuning "{n} dari {m} file akan disisihkan"; buka Tunjukkan file mana dan mengapa. untuk melihat masing-masing. File yang bukan buku kerja sungguhan, seperti CSV yang diganti namanya, juga tercantum di sana dengan alasan seperti "tidak dapat dibaca sebagai excel: tidak dapat dibaca sebagai buku kerja xlsx". Jika buku kerja tersebut mencampur tata letak sementara Tata letak tabel masih terpasang, panel berwarna biru langit menawarkan Beralih ke satu tabel per tata letak.Jika tidak ada buku kerja yang memiliki kumpulan lembar lengkap, proses pendeteksian akan gagal dan tabel tidak akan dibuat sampai Anda memperbaiki atau mengecualikan file tersebut.

  4. Pilih seberapa sering pemindaian dilakukan, lalu buatlah.

    Pengaturan default pada Pengaturan Cocok untuk folder yang hanya menerima beberapa file per hari. Empat hal yang mungkin ingin Anda ubah:

    Interval pemindaian
    Setiap jam Secara default; pilih dari setiap 5 menit hingga harian. Setiap pemindaian membandingkan ukuran dan waktu modifikasi untuk menemukan file baru, yang diubah, dan yang hilang.
    Pantau folder untuk perubahan (hampir secara real-time)
    Secara default nonaktif. Jika diaktifkan, Agent akan bereaksi dalam hitungan detik pada disk lokal; pada berbagi jaringan, prosesnya dilakukan secara bertahap dan pemindaian terjadwal tetap menjadi jaminan. Periode tenang (15 detik) menunggu hingga penulisan berkas selesai.
    Segarkan halaman sebelum menjawab pertanyaan.
    Nonaktif secara default. Jika diaktifkan, kueri akan melakukan pemindaian ulang pertama kali ketika pemindaian terakhir lebih lama dari Jendela basi (60 detik), menunggu paling lama Batas tunggu kueri (5 detik). Ini berlaku untuk orang dan add-in, bukan untuk polling peringatan.
    Ketika sebuah file hilang
    Hilangkan barisnya secara default, atau Pertahankan baris, tandai sebagai terhapus (batu nisan). Itu Rasio penjaga menghilang (0.5) menolak pemindaian yang menghilangkan lebih dari setengah file sekaligus dan mempertahankan inventaris sebelumnya, yang merupakan tampilan berbagi offline.

    Kemudian pilih Ranah Data Jumlah baris dihitung, periksa Tinjauan lalu klik Buat konektorPemindaian pertama dimulai segera. Konektornya Tampak Tab tersebut menunjukkan apa yang telah dibangun dan file apa saja yang telah disisihkan.

  5. Lihatlah tabel Anda

    Buka konektornya: Tampak Tab tersebut mencantumkan tabel yang telah dibuat. Di dalam Pembuat Kueri meja yang sama berada di bawah kumpulan file skema. Tiga kueri yang berfungsi sejak hari pertama:

    Berapa banyak baris yang disumbangkan setiap buku kerja ke lembar pesanan?
    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

    Memastikan setiap buku kerja regional atau bulanan masuk ke dalam tabel gabungan dan berapa banyak yang ditambahkan oleh masing-masing buku kerja.

    Buku kerja apa saja yang tiba, berubah, atau hilang minggu ini?
    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 100

    Menampilkan riwayat perubahan folder, sehingga Anda dapat melihat siapa yang mengirim buku kerja baru dan kapan buku kerja lama diedit.

    Setiap buku kerja di dalam folder, beserta pemilik Windows-nya.
    SELECT relative_path, owner, size_bytes, modified_utc FROM fileset.files ORDER BY modified_utc DESC LIMIT 100

    Menampilkan daftar buku kerja yang dapat dilihat oleh Agen dan siapa yang terakhir menyimpan masing-masing buku kerja; pemilik hanya diisi pada Windows.

    Setiap konektor folder juga melayani tabel pembukuan yang sama, semuanya di dalam kumpulan file skema:

    MejaApa yang terkandung di dalamnya
    berkasSetiap file yang saat ini ada di dalam folder: jalur, nama, ekstensi, ukuran, waktu pembuatan dan modifikasi, waktu pertama dan terakhir dilihat. Tampilan keseluruhan. file_saat ini, yang juga menyimpan file-file yang telah hilang.
    file_kejadianRiwayat perubahan: satu baris per file yang muncul, adalah dimodifikasi, menghilang, disisihkan (melayang) atau adalah ditolak, dengan waktu di acara_pada, bagaimana hal itu diperhatikan di terdeteksi oleh dan alasannya detail.
    direktori, cuplikan direktori, volumeJumlah dan ukuran folder, bagaimana pertumbuhannya, dan cakram atau lembaran tempat akar-akarnya berada.
    berkas sumber, _id_barisDua kolom pada setiap baris data: dari file mana baris tersebut berasal, dan ID baris tetap di dalam file tersebut. Kelompokkan berdasarkan berkas sumber untuk membandingkan file.

Itu saja. Seret file baru ke dalam folder dan, setelah pemindaian berikutnya, file tersebut akan muncul di dalam tabel. File-file tersebut tidak pernah meninggalkan komputer tempat file tersebut berada.

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.

Windows

Type the network path, like \\server\share\folder, never a mapped drive letter such as S:, which the Agent cannot see. If the share only lets in named people, click Service identity (the chip under the path, or a folder’s Credential column) and store a login for that server: a company domain account, or an account made on the server itself with Domain left blank. The Agent then signs in to that server and reads the file there, and every connector on that Agent that reads the same server must use the same login. Without a login, it reads as its own service account, which a company domain sees as the computer itself. Step by step on Windows

Linux

Share logins stored in the Portal are not used on Linux: an administrator mounts the share on the Agent’s computer first, in a folder under /mnt atau /media, because the Agent’s service cannot see /home atau /run/user. In the connector, keep the \\server\share path, which the Agent maps onto the mount, or type the mount path instead, such as /mnt/fileserver-shared/Accounts. How to mount a share on Linux

Mac

Share logins stored in the Portal are not used on a Mac: mount the share first from Terminal with sudo, in a folder under /Volumes, so the Agent’s background service can see it. In the connector, keep the \\server\share path, which the Agent maps onto the mount, or type the mount path instead, such as /Volumes/fileserver-shared/Accounts. How to mount a share on a Mac

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. Pantau folder untuk perubahan. 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 Folder 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 messageApa artinyaApa yang harus dilakukan?
deniedThe 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, atau The stored credentials for \\server were refusedThe 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.
hilangNo 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, atau \\server did not answerNo 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.

Gunakan di mana saja

Konektor ini merupakan sumber data seperti sumber data lainnya di Query Streams. Simpan kueri sekali saja di dalam Pembuat Kueri (dialeknya adalah DuckDB) dan gunakan dari:

Excel

Add-in tersebut Mengalirkan Kueri Menampilkan baris-baris tersebut ke dalam sebuah lembar kerja dan menjalankannya kembali dengan sekali klik. Menjalankan SQL di Excel.

Lembar Kerja Google

Itu Pengalir Kueri Add-on ini mengisi tab yang Anda pilih. Kueri Daya untuk Google Spreadsheet.

Claude, Cursor, dan klien AI lainnya

Melalui server Query Streams MCP; Claude mengetahui model folder, termasuk berkas sumber dan file_kejadian. Folder Excel bersama Claude melalui MCP.

API REST

Setiap kueri yang tersimpan akan menjadi titik akhir hanya baca dengan kunci tersendiri, pada setiap rencana. API REST Folder Excel.

Nova

Tanyakan dengan bahasa yang mudah dipahami pada paket Bisnis; Nova mengetahui setiap folder, tabel, dan kolom dari deskripsi bawaannya.

Otomatisasi

Sinkronkan baris ke Airtable, Smartsheet, Baserow, SeaTable, atau lembar kerja sesuai jadwal. Panduan otomatisasi.

Tabel folder juga terhubung ke konektor Anda yang lain: kueri gabungan dapat mencocokkan berkas sumber nama atau ID pesanan dalam folder buku kerja Excel terhadap basis data pada Agen yang sama.

Bagaimana file baru, yang diubah, dan yang dihapus ditampilkan

Berkas baru dan yang diubah

Pada setiap Interval pemindaian (atau dalam hitungan detik dengan Folder pantauan (pada) sebuah berkas baru yang sesuai dengan tata letak akan ditambahkan barisnya dan mendapatkan muncul Suatu peristiwa. Sebuah berkas yang diubah dibaca ulang dalam satu transaksi: baris-baris lamanya hilang, baris-baris barunya masuk, dan berkas tersebut mendapatkan perubahan. dimodifikasi peristiwa.

File yang dihapus

Berkas yang hilang akan menghapus baris-barisnya secara default, atau tetap menandainya sebagai terhapus jika Anda memilih opsi "batu nisan", dan akan mendapatkan menghilang Jika lebih dari separuh file hilang sekaligus, pemindaian ditolak dan inventaris sebelumnya tetap ada: berbagi offline terlihat persis seperti itu.

File yang disisihkan

Berkas yang tidak sesuai dengan tata letak, tidak dapat dibuka, atau melebihi batas ukuran akan disisihkan secara keseluruhan: tidak ada barisnya yang dimuat, dan file_kejadian mendapat melayang Baris tersebut memberi nama file dan kolomnya. Perbaiki file dan simpan; pemindaian berikutnya akan mencoba lagi.

Seberapa segar yang saya lihat?

Kueri dijawab dari pemindaian terakhir. Tidak ada tombol Pindai Ulang atau Sinkronkan sekarang; interval pemindaian, pengawas folder, dan Segarkan halaman sebelum menjawab pertanyaan. adalah tiga kontrol tersebut. MAX(last_seen_utc) mulai dari file_saat ini memberi tahu Anda kapan terakhir kali Agen tersebut memeriksa.

Berkas yang disisihkan

Tiga kata muncul pada langkah Periksa dan tab Manifest. Ketiga kata tersebut memiliki arti yang berbeda:

Disisihkan (diparkir)
Berkas tersebut tidak sesuai dengan tata letak yang disematkan, atau tidak dapat dibaca, robek, terkunci, atau tertutup oleh huruf kapital. Semuanya atau tidak sama sekali per berkas: berkas yang diparkir tidak memberikan kontribusi baris apa pun. file_kejadian mencatat sebuah melayang baris yang detail menyebutkan nama file dan kolomnya. File dilewati selama ukuran dan waktu modifikasinya tetap sama, dan dicoba lagi segera setelah berubah.
Tidak terbaca
Agen tidak dapat membuka atau menguraikan file tersebut karena tipenya: bukan buku kerja sungguhan, terkunci oleh program lain, placeholder cloud, byte yang tidak dapat diuraikan. File tersebut berhenti sendiri dan sisa folder berlanjut. Hanya folder dengan nol file yang dapat dibaca yang menolak seluruh rangkaian file.
Ditolak
Agen tidak dapat menyematkan tata letak apa pun, misalnya karena file tidak sesuai pada tipe kolom. Belum ada tabel data yang tersedia. file_kejadian mendapat ditolak baris dengan alasan di detail, dan Agen mencoba lagi pada setiap pemindaian hingga tata letak ditemukan. Perbaiki atau kecualikan file yang disebutkan dan pesan akan hilang.

Di mana harus melihat: spanduk kuning di Memeriksa (Tunjukkan file mana dan mengapa.), konektornya Tampak tab setelahnya. Dalam SQL: SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.

Untuk folder berisi buku kerja Excel yang biasanya terlihat seperti ini: Sebuah berkas bernama Q3-summary.xlsx yang sebenarnya adalah CSV yang telah diubah namanya, dipisahkan dan muncul di bawah "Tampilkan berkas mana dan mengapa", dan kemudian sebagai baris pergeseran di files_events, dengan detail "tidak dapat dibaca sebagai excel: tidak dapat dibaca sebagai buku kerja xlsx (Catatan Akhir Direktori Pusat tidak dapat ditemukan.)".

Batasan yang perlu diketahui

Tidak ada batasan paket untuk folder atau jumlah file. Baris tetap dihitung dalam Data Realm Anda seperti konektor lainnya. Pengaturan default yang dapat Anda naikkan atau turunkan pada konektor:

PengaturanBawaanApa fungsinya?
Kedalaman maksimum8Berapa banyak level folder di bawah setiap root yang dipindai (1–64).
Jumlah file maksimum per pemindaian100,000Berkas-berkas dipertimbangkan dalam satu kali pemeriksaan.
Ukuran file maksimum yang akan di-hash32 MiBHanya penting dengan Isi file hash pada.
Retensi log peristiwa30 hariBerapa lama file_kejadian Baris-baris tersebut dipertahankan.
Paralelisme pemindaian per akar2Folder dibaca sekaligus per root.

Batasan konten, yang memarkir file alih-alih memotongnya: 2.000.000 baris atau 512 MiB per file, 10.000.000 baris atau 2 GiB per pemindaian. Sebuah folder dapat menampung paling banyak 25 tata letak berbeda. Satu meja per tata letak mode.

Pertanyaan yang diajukan orang

Buku latihan saya memiliki lembar yang berbeda. Apa yang terjadi?

Dengan Satu tata letak yang disematkan, buku kerja yang kehilangan lembar yang disematkan akan disisihkan dan tidak ada barisnya yang dimuat. Langkah Periksa menawarkan Beralih ke satu tabel per tata letak., yang memberikan setiap tata letak tabelnya sendiri, hingga 25 tabel. Nama tabel tidak pernah berubah selama tata letak tetap disematkan.

Apakah buku kerja baru dengan tata letak baru akan muncul dengan sendirinya?

Tidak. Itu disisihkan dengan catatan yang menyatakan bahwa itu adalah tata letak baru. Ubah dan simpan opsi konektor apa pun, seperti LembarKemudian, Agen mengambil sampel folder tersebut lagi dan menambahkan tabel baru. Nama tabel yang sudah ada tetap dipertahankan.

Apakah program ini membaca file .xls atau .xlsm?

Pengemudi membaca .xlsx, dan Sertakan pola dimulai sebagai **/*.xlsxSimpan yang lebih lama .xls buku kerja sebagai .xlsx Pertama. Sebuah file yang bukan file asli. .xlsx buku kerja disisihkan karena tidak dapat dibaca dan diberi nama di bawah Tunjukkan file mana dan mengapa..

Bagaimana jika seseorang membuka buku kerja di Excel saat pemindaian dijalankan?

Berkas yang dikunci oleh program lain tidak dapat dibaca, sehingga buku kerja tersebut disisihkan secara terpisah dan sisa folder tetap dimuat. file_kejadian mencatat sebuah melayang memberi nama baris tersebut. Setelah buku kerja disimpan dan ditutup, pemindaian berikutnya akan membacanya lagi.

Jika saya mengedit buku kerja, apakah akan muncul baris duplikat?

Tidak. Baris lama pada buku kerja yang diubah akan dihapus dan seluruh buku kerja dibaca ulang dalam satu langkah, sehingga tabel tidak pernah menyimpan dua versi file. Perubahan dideteksi dari ukuran dan waktu modifikasi; aktifkan Isi file hash untuk menangkap suntingan yang mempertahankan cap waktu.

Apakah file saya sudah diunggah di suatu tempat?

Tidak. Agen membaca data tersebut di komputernya sendiri dan menyimpan baris-baris tersebut dalam cache lokal terenkripsi di sana. Sebuah kueri dijalankan terhadap cache tersebut dan hanya baris-baris yang dikembalikan yang meninggalkan mesin, melalui satu koneksi keluar. File tidak pernah dimodifikasi, dipindahkan, atau dikonversi.

Apakah saya perlu membuka port atau menjalankan VPN?

Tidak. Agen membuat satu koneksi keluar pada port 443 dan baik permintaan maupun baris data dikirim melalui koneksi tersebut. Jika HTTPS keluar berfungsi, maka ini juga berfungsi.

Apakah folder tersebut dapat berada di jaringan bersama, atau di OneDrive atau Dropbox?

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 Selalu aktifkan perangkat ini.Agen tersebut tidak mengunduh file yang hanya tersedia di cloud.

Folder tersebut berisi lebih dari satu jenis file. Satu konektor atau dua?

Satu konektor membaca satu tipe file. Sebuah folder dengan file CSV dan Parquet membutuhkan dua konektor pada root yang sama, satu untuk setiap tipe. File yang tidak sesuai dengan pola penyertaan akan diabaikan, bukan disisihkan.

Apakah ada tombol Pindai Ulang?

Tidak. Agen memindai pada Interval pemindaian, bereaksi terhadap perubahan ketika Folder pantauan aktif, dan dapat memindai ulang sebelum menjawab kueri saat Anda mengaktifkannya. Edit konektor untuk mengubah salah satu dari ketiganya.

Apakah paket gratis benar-benar mencakup hal ini?

Ya. Gratis adalah paket yang dapat Anda pertahankan, bukan uji coba yang akan berakhir. Konektor folder tidak memiliki batasan jumlah file sendiri; jumlah baris dihitung terhadap Data Realm Anda seperti konektor lainnya. Lihat apa saja yang termasuk dalam setiap paket di halaman berikut. halaman harga.

Masih bingung? Membuka Dukungan Di Query Streams, beri tahu kami Anda berada di langkah mana dan apa yang Anda lihat. Kami akan menghubungkan Anda.

Setiap panduan untuk Excel Folder

Apakah pengaturan Anda kurang tepat?

  • Hanya butuh daftar file beserta ukuran, tanggal, dan perubahannya? Sistem File dapat melakukannya tanpa membaca file → 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?
Updated on Oktober 12, 2026

Powered by BetterDocs