任意のファイルフォルダを SQLテーブル 最新の状態を維持する
13種類のフォルダコネクタ、そして1つのコンセプト：Query Streams Agentをネットワーク上のフォルダに指定するだけで、テーブルが作成され、各行に元のファイルを示すタグが付けられ、ファイルの到着、変更、削除に応じてテーブルが常に最新の状態に保たれます。Excel、Google Sheets、Nova、Claude、またはREST APIからクエリを実行できます。アップロード、変換、編集は一切不要です。
ファイルに合ったガイドを選択してください
以下の各カードは、コネクタとガイドをそれぞれ1つずつ表しています。どのガイドも、エージェントのインストール、フォルダの指定、作成内容の確認、スキャン頻度の選択、テーブルの確認という5つの手順を順を追って説明し、そのファイルタイプに特有のテーブル、クエリ、注意点を示します。どれが適切か分からない場合は、ポータルで選択してください。 フォルダ内のファイルエージェントがフォルダをサンプリングし、適切なカードを開きます。
各フォルダーコネクタの仕組み
データベースコネクタは、既にテーブルが存在するサーバーを指します。フォルダコネクタは、エージェントのコンピュータ上のフォルダを指します。エージェントはファイルを読み込み、最大64個のサンプルからレイアウトを固定し、暗号化されたローカルキャッシュ（1つのDuckDBスキーマ、名前は ファイルセット選択したスケジュールに従ってファイルを更新します。レイアウトに合わないファイルは隔離され、報告されます。決して黙って削除されたり、無理やりレイアウトが変更されたりすることはありません。1つのコネクタは1種類のファイルタイプを読み取ります。CSVファイルとParquetファイルを含むフォルダは、同じフォルダに対して2つのコネクタとして扱われます。
すべてのフォルダー コネクタは、同じ簿記テーブルも提供します。 ファイルセット スキーマ:
| テーブル | 中身 |
|---|---|
ファイル | 現在フォルダ内にあるすべてのファイル：パス、名前、拡張子、サイズ、作成日時と変更日時、最初と最後に閲覧された日時。 files_currentまた、消失したファイルも保存している。 |
ファイルイベント | 変更履歴: ファイルごとに 1 行 現れた、 だった 修正済み, 消えた、は除外された（ドリフト）または 拒否した時間が経つにつれて イベント_atどのように注目されたか 検出された そしてその理由は 詳細. |
ディレクトリ, ディレクトリスナップショット, ボリューム | フォルダの数とサイズ、それらの成長過程、そしてルートフォルダが存在するディスクまたは共有フォルダ。 |
_ソースファイル, _row_id | 各データ行には2つの列があります。1つは行の由来となるファイル、もう1つはそのファイル内の安定した行IDです。グループ化基準 _ソースファイル ファイルを比較する。 |
必要なもの
クエリストリームアカウント
フォルダコネクタは、無料プランを含むすべてのプランで利用できます。無料プランは、期限付きの試用期間ではなく、継続して利用できるプランです。フォルダに保存できるファイル数に制限はありません。
エージェント、バージョン2.6.0以降
フォルダーを開くことができるコンピューター（ファイルサーバー自体、オフィスコンピューター、またはファイルが保存されるマシン）にインストールします。古いエージェントではフォルダーカードがグレー表示され、 エージェント 2.6.0+ バッジ。Windows、Mac、Linuxに対応。
エージェントから見たフォルダのパス
ローカルパス、または次のように記述されるネットワーク共有 \\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 /月 または /メディア, a Mac under /Volumes).
作業はどこで行われますか？ エージェントを実行するコンピュータ上で、フォルダをスキャンし、行を暗号化されたローカルキャッシュにコピーします（1 つのスキーマ、名前は ファイルセットそして、そのキャッシュに対してすべてのクエリを実行します。ファイルは読み取られるだけで、変更、移動、アップロードされることは一切ありません。
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. 変更を監視するフォルダ works on a share too, on a best-effort basis; the scheduled scan is what guarantees every change is picked up.
新規ファイル、変更ファイル、削除ファイルがどのように表示されるか
新規ファイルと変更されたファイル
毎回 スキャン間隔 （または数秒以内に ウォッチフォルダー レイアウトに合う新しいファイルには行が追加され、 現れた イベント。変更されたファイルは 1 つのトランザクションで再読み込みされます。古い行が削除され、新しい行が追加され、 修正済み イベント。
削除されたファイル
ファイルが消えると、デフォルトでは行が削除されるか、墓石オプションを選択した場合は削除済みとしてマークされたままになり、 消えた イベント。ファイルの半分以上が一度に消えた場合、スキャンは拒否され、以前のインベントリが残ります。オフライン共有はまさにそのようになります。
保管ファイル
レイアウトに合わないファイル、開けないファイル、または上限を超えるファイルは、全体が除外されます。その行は読み込まれず、 ファイルイベント 手に入れる ドリフト ファイル名と列名を指定する行を指定します。ファイルを修正して保存すると、次回のスキャンで再度試行されます。
私が見ているものは、どれほど新鮮なのだろうか？
クエリは前回のスキャンから回答します。再スキャンまたは今すぐ同期ボタンはありません。スキャン間隔、フォルダーウォッチャー、 質問に回答する前にページを更新してください これら3つのコントロールです。 MAX(last_seen_utc) から files_current エージェントが最後に確認した日時を教えてくれます。
脇に置かれたファイル
「チェック」ステップと「マニフェスト」タブには3つの単語が表示されます。それぞれ意味が異なります。
- 駐車スペースを確保
- ファイルが固定レイアウトと一致しないか、読み取り不能、破損、ロックされている、またはキャップを超えています。ファイルごとに処理は全行または全行のどちらかになります。つまり、保留中のファイルは行数をゼロとします。
ファイルイベント記録するドリフト行の詳細ファイル名と列名を指定します。ファイルのサイズと更新日時が同じ間はスキップされ、変更があった場合はすぐに再試行されます。 - 判読不能
- エージェントは、ファイルの種類（実際のワークブックではない、別のプログラムによってロックされている、クラウドのプレースホルダー、デコードできないバイトなど）に基づいて、ファイルを開くことも解析することもできませんでした。エージェントは自動的に待機し、残りのフォルダの処理を続行します。読み取り可能なファイルがゼロのフォルダのみが、フォルダ全体の処理を拒否します。
- 拒否した
- エージェントはレイアウトを一切固定できませんでした。例えば、ファイル間で列の型が一致していない、データテーブルがまだ存在しない、といった理由が考えられます。
ファイルイベント手に入れる拒否した理由付き行詳細エージェントはレイアウトが固定されるまで、スキャンごとに再試行します。指定されたファイルを修正または除外すると、メッセージが消えます。
どこを探せばよいか: チェック (どのファイルとその理由を表示する）、コネクタの マニフェスト 後にタブを置きます。SQLでは： SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.
テーブルはあらゆる場所で活用してください。
コネクタは、クエリ ストリーム内の他のデータ ソースと同様です。クエリを一度保存すると、 クエリビルダー （方言はDuckDBです）そして、以下から使用します。
Claude、Cursor、その他のAIクライアント
Query Streams MCPサーバーを介して、Claudeはフォルダーモデルを知っています。 _ソースファイル そして ファイルイベント. Claude の CSV フォルダ (MCP 経由).
ノヴァ
ビジネスプランについて、分かりやすい言葉で質問してください。Novaは、組み込みの説明からすべてのフォルダ、テーブル、列を把握しています。
フォルダー テーブルは他のコネクタにも結合します。フェデレーション クエリは一致させることができます _ソースファイル 同じエージェント上のデータベースに対して、CSVファイルフォルダ内の名前または注文ID。
知っておくべき限界
フォルダ数やファイル数にプラン上の制限はありません。行数は他のコネクタと同様にデータレルムの容量にカウントされます。コネクタで上げ下げできるデフォルト値は以下のとおりです。
| 設定 | デフォルト | その機能 |
|---|---|---|
| 最大深度 | 8 | 各ルートフォルダの下の何階層のフォルダがスキャンされるか（1～64）。 |
| スキャンあたりの最大ファイル数 | 100,000 | ファイルは一括して検討されます。 |
| ハッシュ化する最大ファイルサイズ | 32 MiB | 重要なのは ハッシュファイルの内容 の上。 |
| イベントログの保持 | 30日間 | どのぐらいの間 ファイルイベント 列は維持されます。 |
| ルートごとのスキャン並列処理 | 2 | ルートごとに一度に読み込まれるフォルダ数。 |
コンテンツキャップは、ファイルを切り捨てるのではなく、一時的に保存します。ファイルあたり2,000,000行または512 MiB、スキャンあたり10,000,000行または2 GiBです。フォルダには最大25種類のレイアウトを格納できます。 レイアウトごとにテーブル1つ モード。
人々が尋ねる質問
私のファイルはどこかにアップロードされていますか？
いいえ。エージェントは自身のコンピュータ上でファイルを読み込み、暗号化されたローカルキャッシュに行を保存します。クエリはそのキャッシュに対して実行され、返された行のみが1つのアウトバウンド接続を介してマシンから送信されます。ファイルは変更、移動、変換されることは一切ありません。
ポートを開放したり、VPNを実行したりする必要はありますか？
いいえ。エージェントはポート443で1つの送信接続を確立し、リクエストと行の両方がその接続を介して送信されます。送信HTTPSが正常に動作すれば、この方法も機能します。
そのフォルダはネットワーク共有上、またはOneDriveや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 このデバイスを常にオンにしておくエージェントはクラウド専用ファイルをダウンロードしません。
そのフォルダには複数の種類のファイルが含まれています。コネクタは1つですか、それとも2つですか？
1つのコネクタは1種類のファイルタイプを読み取ります。CSVファイルとParquetファイルを含むフォルダは、同じルート上に2つのコネクタ（ファイルタイプごとに1つ）として扱われます。インクルードパターンに一致しないファイルは無視され、除外されません。
再スキャンボタンはありますか？
いいえ。エージェントはスキャンします スキャン間隔変化に反応する ウォッチフォルダー がオンになっている場合、クエリに応答する前に再スキャンを実行できます。コネクタを編集して、3つの設定のいずれかを変更します。
無料プランで本当にこれがカバーされるのですか？
はい。無料プランは継続してご利用いただけます。期限切れの試用版ではありません。フォルダコネクタ自体にはファイル数の上限はありません。行数は他のコネクタと同様にデータレルムにカウントされます。各プランに含まれる内容については、 価格ページ.
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish