JSONLフォルダのロゴ

行区切りJSON 新着

クエリ JSONLフォルダ SQL を使用 — Excel、Google スプレッドシート、AI、REST

JSONL/NDJSON形式のイベントログのフォルダをテーブルとしてクエリします。ネストされたフィールドは、パーサーを事前に作成することなく、フィルタリング可能な実際の列にフラット化されます。

一つの接続、あらゆる表面

JSONLフォルダのデータはどこに保存できますか?

Query Streamsは、JSONL/NDJSON形式のイベントログが格納されたフォルダを、Microsoft Excel、Google Sheets、MCP経由のAIアシスタント、REST API、Power BIから読み取り可能なライブSQLテーブルに変換します。ネストされたオブジェクトは、WHERE句に使用できる実際の列にフラット化され、セルフホスト型エージェントはファイルの先頭部分のみをサンプリングするのではなく、ファイル全体を読み込むため、最後の100行にしか表示されないフィールドも検出できます。ログはマシン上に保持され、クエリ結果のみがネットワークから送信されます。

1 つのフォルダー エンジン上の 9 つのファイル セット ドライバーの 1 つ - インベントリ テーブル、変更履歴、および拒否ルール 機能 家族で共有する JSONLフォルダ ファイルシステム CSVフォルダ 寄木細工のフォルダー Excelフォルダ SQLiteフォルダ 複数レコードのCSV マシンログ ウェブサーバーログ

  1. チーム、ベンダー、パートナーの皆様へ
  2. JSONLフォルダをExcelに変換 Microsoft Excel · Excelアドイン

    JSONLフォルダーのリアルタイム結果をワークシートに直接取り込み、必要に応じて更新できます。対応環境は、デスクトップ版Excel、Excel Online、Microsoft 365です。

    Excelの仕組み
  3. JSONLフォルダをGoogleスプレッドシートに変換 Sheetsアドオン

    サイドバーから保存済みのJSONLフォルダクエリを実行し、結果をシートにドラッグ&ドロップします。共有されている共同作業者は、各自でシートを更新できます。

    Googleスプレッドシートの仕組み
  4. JSONLフォルダについてNovaに聞いてみてください Nova AI · テキストからSQLへ

    平易な英語で質問してください。Novaは既にJSONLフォルダのテーブルを認識しており、SQL文を作成して実行し、回答を説明してグラフ化します。クエリを作成する必要も、認証情報を渡す必要もありません。

    Novaの仕組み
  5. JSONLフォルダをデータビューアに変換する 結果共有 · チーム、ベンダー、パートナー · 電話、タブレット、デスクトップ

    JSONL Folderのリアルタイム結果を、同僚、ベンダー、パートナーなど、誰とでも共有できます。共有されたグリッドはブックマーク可能で、スマートフォン、タブレット、デスクトップなど、どのデバイスで開いても常に最新の状態に戻ります。相手には結果のみが表示され、SQL文やファイルは一切表示されません。

    データビューアの仕組み
  6. アプリとシステム向け
  7. JSONLフォルダREST API HTTPエンドポイント

    JSONL Folderクエリを、認証済みのJSONエンドポイントとして公開します。このエンドポイントは、OpenAPI 3.1仕様に準拠し、Postman、Insomnia、Hoppscotch用の既製コレクションも用意されているため、どのアプリケーションでも呼び出すことができます。データベースポートは開放されません。

    REST APIの仕組み
  8. JSONLフォルダをPower BIへ Power Query M

    生成された Power Query M を Power BI アドバンスト エディターに貼り付けると、レポートは HTTPS 経由でライブの JSONL フォルダーの結果を読み取ります。ODBC ドライバーもデータベース ポートも開かれません。

    Power BI の仕組み
  9. JSONLフォルダをAirtableへ 自動化プラットフォーム

    JSONLフォルダの行をスケジュールに基づいてAirtableベースに同期したり、Airtable自動化スクリプト内で取得したりできます。

    Airtableの仕組み
  10. JSONLフォルダをBaserowへ 自動化プラットフォーム

    RESTエンドポイント経由で、JSONLフォルダからBaserowテーブルにデータを供給します(セルフホスト環境またはBaserowクラウド環境)。

    Baserowの仕組み
  11. JSONLフォルダをSeaTableへ 自動化プラットフォーム

    ファイルをエクスポートしたりデータベースを公開したりすることなく、JSONLフォルダデータを使用してSeaTableベースを最新の状態に保ちます。

    SeaTableの仕組み
  12. JSONLフォルダをSmartsheetへ 自動化プラットフォーム

    JSONLフォルダの結果をSmartsheetグリッドにプッシュすることで、計画やレポートが先週のエクスポートではなく、ソースシステムから読み込まれるようにします。

    Smartsheetの仕組み
  13. JSONLフォルダをAnvilへ Anvil Works · アプリプラットフォーム

    Anvil PythonアプリをJSONLフォルダでバックアップするには、アプリ内にデータベース認証情報を埋め込むのではなく、RESTエンドポイント経由でバックアップします。

    Anvilの仕組み
  14. AIツール向け
  15. JSONLフォルダMCPサーバー Claude、Cursor、およびMCPクライアント

    AIアシスタントに、正しいSQLを作成するために必要なスキーマを含むJSONLフォルダへの読み取り専用アクセス権を与えます。チャットに認証情報を含めないでください。

    MCPの仕組み
  16. 人々に届けられる
  17. JSONLフォルダのアラートとレポート Slack · Discord · メール · Webhook

    JSONL Folderクエリをスケジュール設定して、結果をSlack、Discord、メール、または署名付きWebhookに送信するか、行数、しきい値、またはパーセンテージの変化が設定した値を超えるまでメッセージを保留することができます。

    アラートとレポートの仕組み

仕組み

5つのステップ、受信ファイアウォールの変更は不要

01

ネットワークエージェントを、アプリケーションログ、Webhookアーカイブ、イベントエクスポート、1行に1つのJSONオブジェクトが格納されているフォルダにアクセスできる場所にインストールしてください。

02

コネクタをその場所に向けると、すべての.jsonlファイルが一致します。

03

エージェントはファイルの先頭部分だけをサンプリングするのではなく、ファイル全体を読み込むため、最後の100行にしか出現しないフィールドも検出されます。

04

ネストされたオブジェクトは、デフォルトでは最大8階層まで、2階層の列にフラット化されます。fulfillment.site.regionは、WHERE句で使用できる列になります。配列やそれより深い階層のオブジェクトはJSONとして保持され、クエリを実行できます。

05

各行には_source_file列が含まれているため、1日分のファイル、あるいはアーカイブ全体が1回のクエリで取得できます。

機能の詳細解説

JSONLフォルダが提供するもの

乱雑なイベントデータ向けに設計されています

  • ファイル全体が読み込まれ、サンプリングは行われません。 ―珍しい分野は、早く登場しなかったからといって惜しまれるわけではない。
  • より深い構造は削除されるのではなくJSONとして保持されるため、何も知らず知らずのうちに失われることはありません。
  • 後から出現し始めた項目は変更として扱われ、報告されるのであって、静かに無視されることはありません。
  • フォルダに本当に異なるイベント形状が含まれている場合、レイアウトごとのモードでは、各形状に最大 25 個の独自のテーブルが割り当てられます。
-- ログフォルダから直接取得した日ごとのイベント数 SELECT _source_file AS day, status, COUNT(*) AS events FROM data GROUP BY day, status ORDER BY day

厳密に、一行ずつ

たった1行の不正な行が、不完全な情報ではなくファイル全体の読み込みを妨げ、files_events にファイル名が記録されます。この不正な行を修正するか除外すれば、次回の同期で正しく処理されるため、3行が欠落した合計値を誤って照合してしまうといった事態は避けられます。

ファイルセットファミリー全体で共有されています

すべてのフォルダーコネクタには、

  • files_current — リアルタイムのインベントリ:コネクタが現在認識できるすべてのファイルとそのパス、サイズ、更新日時。
  • ファイルイベント —監査証跡:何が出現し、何が変更され、何が消失し、何が保留されたか、ファイル名と理由とともに記録される。
  • ディレクトリとボリューム フォルダごとの合計、日々の増加履歴、およびドライブの空き容量。
  • 同期のたびに再読み込みされるのは実際に変更されたファイルのみであるため、50,000個のファイルを含むフォルダは、新しいエクスポートが1つ追加されたからといって再解析されることはありません。

知っておくと良い

  • 読み取り専用、強制 一度に1つのステートメントのみを実行します。SELECT文とその関連コマンドのみを使用します。ファイルは書き込まれたり、移動されたり、名前が変更されたりすることはありません。
  • 何もアップロードされていません データはエージェントと並行して、お客様自身のマシン上にキャッシュされ、暗号化されます。お客様のネットワークから外部に送信されるのは、クエリの結果のみです。
  • 賢明なデフォルト設定 最大25万ファイル、階層16階層、ファイルサイズ512MBまで対応。すべて調整可能です。ごみ箱、.gitフォルダ、node_modulesフォルダは常にスキップされます。
  • SQL方言はDuckDBです — 他のコネクタに対して記述するのと同じSQL文です。

クロスソースSQL

JSONLフォルダを他のデータと結合する

ファイルフォルダは他のSQLテーブルと同様にSQLテーブルの集合体であるため、1つのステートメントでデータベースとAPIに同時に結合できます。各ソースは実行可能な部分のみを実行し、結果をストリームで返送します。結合は中央で行われるため、ソース同士が直接通信したり、データがどこかにコピーされたりすることはありません。

接続数3件・エージェント数3名

JSONLフォルダ 行区切りJSON
PostgreSQL 関係エンジン
ストライプ 支払いと請求

一つの声明

-- コピーなし、マージなし、スケジュールなし
セレクト   c.region、COUNT(*) AS orders、SUM(i.amount_due) AS invoiced
フロム     イベントログ.fileset.data1 f
ジョイン     pg_crm.一般顧客2 c ON c.id = f.customer_id
ジョイン     請求する.stripe.invoices3 i ON i.customer = c.stripe_id
GROUP BY c.領域
ORDER BY 請求書記載のDESC;

接続、スキーマ、テーブルの3つの部分から構成され、接続名はユーザーが自由に設定できます。これは例示用の列であり、テーブルはユーザー自身が設定します。読み取り専用はすべての要素に適用され、SELECT、WITH、EXPLAINのみが使用可能で、1つのクエリで1つのソースが渡せるデータ量には上限があります。 フェデレーションクエリの仕組み

接続の詳細

JSONLフォルダに必要なもの

フォルダ
.jsonl ファイルを格納するルートが 1 つ以上あり、サブフォルダも含まれます。アプリケーションログ、Webhook アーカイブ、イベントエクスポートなど、1 行に 1 つの JSON オブジェクトが含まれます。
スキーマ
サンプルではなくファイル全体を読み込むことで、大きなログの後半にしか現れないフィールドも検出できます。
巣作り
オブジェクトはデフォルトでは2階層の列にフラット化され、最大8階層までフラット化されます。fulfillment.site.regionはフィルタリング可能な列になります。
より深い構造
配列やフラット化深度以下のデータは、削除されることなくJSONとしてクエリ可能なままになります。
厳格さ
不正な行が1つあるため、半真実を読み込むのではなくファイル全体が読み込まれず、ファイル名はfiles_eventsに付けられています。
レイアウトごとのモード
フォルダに異なるイベント形状が実際に格納されている場合、各形状に独自のテーブルを作成できます(最大25個)。
制限
最大25万ファイル、16階層のフォルダ、1ファイルあたり512MB ― すべて調整可能
資格証明書
サーバーは存在しないため、エージェントがログをその場で読み取ります。
SQL方言
DuckDB — 標準SQL、ログ固有の学習は不要

この構成にはデータベースサーバーは存在しません。エージェントは、既に存在する.jsonlファイルを読み込み、同じマシン上の暗号化されたDuckDBストアに行をキャッシュし、実際に変更されたファイルのみを再読み込みします。つまり、今日のデータが既に取得されているため、1年分のデイリーログファイルが再解析されることはありません。クエリストリームには何もアップロードされず、ネットワークから送信されるのはクエリの結果のみです。

フラット化深度は固定スキーマの一部であり、クエリごとの設定ではありません。これは意図的なものです。fulfillment.site.region は、月曜日も金曜日も同じ意味を持つ必要があるため、保存されたクエリやスケジュールされた更新のたびに、意図せず意味が変わってしまうからです。後から深度を上げるとスキーマの変更となり、そのように処理され、報告されます。

ベンダー資料: jsonlines.org

よくある質問

JSONLフォルダに関する質問

クエリ ストリームを介して JSONL フォルダー データを読み取ることができるツールはどれですか?

Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、スケジュールされたアラートやレポートなど、すべてを1つの接続で利用できます。フォルダを一度接続するだけで、すべてのツールが同じ読み取り専用接続を読み取ることができます。ツールごとの設定やデータの複製は不要です。

私のファイルはクエリストリームにアップロードされますか?

いいえ。ネットワークエージェントはファイルをその場で読み込み、同じマシン上の暗号化されたストアに行をキャッシュします。ファイル自体はネットワークから外部に送信されることはありません。クエリの結果行のみが、受信ファイアウォールポートのない単一の送信暗号化接続を介してネットワークから送信されます。

クエリ ストリームは、私のファイルを変更、移動、または名前変更できますか?

いいえ。ファイルは厳密に読み取り専用で開かれ、書き込み、移動、名前変更は一切行われません。クエリは実行時に読み取り専用となり、一度に1つのステートメント(SELECT文など)のみが実行されます。

クエリ ストリームが JSONL フォルダーに接続するために必要なものは何ですか?

エージェント マシンが認識できるフォルダー パス - サーバーも認証情報もインストールするドライバーもありません。フォルダー: .jsonl ファイルを保持する 1 つ以上のルート (サブフォルダーを含む) - アプリケーション ログ、ウェブフック アーカイブ、イベント エクスポート、1 行につき 1 つの JSON オブジェクト。スキーマ: サンプルではなくファイル全体から読み込むため、大きなログの後半にのみ出現するフィールドも検出されます。ネスト: オブジェクトはデフォルトで 2 レベルの深さの列にフラット化され、最大 8 レベルまでフラット化されます - fulfillment.site.region はフィルタリング可能な列になります。より深い構造: 配列およびフラット化の深さより下のものは、削除されずに JSON としてクエリ可能なままになります。

同じクエリ内で、ファイルフォルダをデータベースに結合することはできますか?

はい、それはフェデレーションクエリです。1つのステートメントで、JSONL Folderと他の接続を同時に参照でき、connection.schema.table の形式で記述されます。各ソースは実行可能な部分のみを実行し、結果をストリームで返します。結合は中央で行われるため、ソース同士が接続されることはなく、何もコピーまたはスケジュールされません。読み取り専用はすべての部分(SELECT、WITH、EXPLAINのみ)に適用され、1つのソースが単一のクエリで渡せるデータ量には上限があります。フェデレーションクエリはプラン機能であり、フェデレーションクエリページには現在のソースとサイズの制限が表示されます。

JSONLフォルダを作業場所に置く

エージェントをインストールし、フォルダを指定して、保存先を選択してください。

読み取り専用 発信専用 認証情報はエージェントに保持されます