Browser Kitty
data

DuckDB Explorer

DuckDBファイルを端末内で開き、構造・データ・読み取り専用SQL・DB比較まで確認できます。

GitHubで見る
ローカル処理
ファイルについてこのツールで選択したファイルや入力内容は、Browser Kittyのバックエンドへアップロードせずブラウザ内で処理します。
操作デモ 実際の操作の流れを短い動画で確認できます。

このツールについて

DuckDB Explorerは、手元のDuckDBデータベースを読み取り専用で開き、まず全体構造を把握してから必要なデータへ進めるブラウザツールです。schema、table、view、列、推定行数、ファイルサイズ、DuckDBバージョンを確認し、tableやviewの内容を100行ずつ閲覧できます。

検索・列フィルタ・ソート・ネスト値の詳細表示に加え、選んだ列だけの統計、読み取り専用SQL、データ辞書HTML、別のDuckDBとの構造比較にも対応します。選択したDBファイルやSQL、検索内容、結果をアプリが外部サーバーへ送信する処理はありません。

こんなときに便利

  • 受け取ったDuckDBファイルにどんなschema、table、view、列が入っているか手早く確認したい
  • DBを書き換えず、検索・ソート・列分析や読み取り専用SQLで内容を調べたい
  • 2つのDuckDBについてテーブルや列定義、view SQLなど構造上の差を確認したい
  • DB構造や実行済み列分析を、共有しやすいデータ辞書HTMLとして保存したい

できること

このツールで利用できる主な機能です。

使い方

  1. 「ツールを開く」を押し、.duckdb または .db ファイルを選択・ドロップします。
  2. 概要でschema、table、view、列数、推定行数、ファイルサイズなどを確認します。
  3. 一覧からtableまたはviewを選び、検索、フィルタ、ソート、セル詳細、列表示を使って内容を確認します。
  4. 必要な列だけ列分析を実行し、NULL数、ユニーク数推定、数値統計、日付範囲、文字列長、よくある値などを確認します。
  5. SQLではSELECT / WITH / VALUES / SHOW / DESCRIBE / DESC / EXPLAINの読み取り専用文を1文ずつ実行します。
  6. 必要なら概要からデータ辞書HTMLを保存するか、別のDuckDBを選んで構造比較を行います。

対応範囲

  • 入力: .duckdb / .db。選択したDBはDuckDB-Wasmでブラウザ内処理し、読み取り専用で開きます。
  • データ閲覧: 100行ずつページングし、検索、列フィルタ、ソート、LIST / STRUCT / MAPなどの詳細表示に対応します。
  • 列分析: NULL数、ユニーク数推定、数値統計、日付範囲、文字列長、よくある値を、選択した列だけ明示的に実行します。
  • SQL: SELECT / WITH / VALUES / SHOW / DESCRIBE / DESC / EXPLAINを1文ずつ実行。SELECT系の表示・保存は最大1,000行です。
  • 保存: データ閲覧のCSV / JSONは現在表示中のページのみ。データ辞書HTMLにはDB構造、view定義、実行済み列分析を含み、テーブル行データは含めません。
  • 比較: schema / table / view / 列定義 / view SQL / 推定行数を比較します。行単位のデータdiffは行いません。
  • ブラウザ: Chrome / Edgeを主要対象。生成済み単一HTMLはfile://で直接開き、ネットワーク接続なしでも利用できます。

制限・注意点

  • DuckDBファイルの編集や書き込みは行いません。SQLも読み取り専用に制限されています。
  • データ閲覧からのCSV / JSON保存は、現在表示しているページだけが対象です。
  • SELECT系SQLの結果表示・保存は最大1,000行です。
  • DB比較は構造比較であり、行単位の追加・更新・削除差分は確認しません。
  • 列分析は全列を自動スキャンせず、明示的に選んだ列だけ実行します。データ辞書には実行済み分析の「よくある値」が含まれる場合があります。
  • DuckDBのバージョン差やoptional extensionに依存するDBは、ブラウザ版で開けない場合があります。
  • 大きなDB、重いview、検索、列分析、比較では端末のCPUやメモリを多く使う場合があります。Firefox / Safariはbest-effortです。

よくある質問

DuckDBファイルはサーバーへアップロードされますか？

いいえ。選択したDBは埋め込みDuckDB-Wasmでブラウザ内処理します。DBファイル、検索文字列、フィルタ、SQL、SQL履歴、query結果をアプリが外部サーバーへ送信する処理はありません。

SQLでデータを書き換えられますか？

いいえ。DB自体をread-onlyで開き、SQLもSELECT、WITH、VALUES、SHOW、DESCRIBE / DESC、EXPLAINなど読み取り専用の1文だけを許可します。書き込み、DDL、ATTACH、extension読み込みなどは実行前に拒否します。

DuckDB全体をCSVに書き出せますか？

データ閲覧からのCSV / JSON保存は現在表示中の100行ページが対象です。SQLのSELECT系結果も最大1,000行です。巨大データを意図せずブラウザメモリへ展開しないための制限です。

2つのDBでデータの変更行まで比較できますか？

行単位のdiffは行いません。schema、table、view、列定義、view SQL、推定行数など、DB構造の差を確認する機能です。

データ辞書HTMLにはDBの行データも入りますか？

テーブル行データは含めません。ただし、現在のセッションで明示的に実行した列分析の「よくある値」は含まれる場合があるため、外部共有前に内容を確認してください。

オフライン版・ソースコード

GitHub直下のduckdb-explorer.htmlは必要なDuckDB-Wasm runtimeを内包した単一HTMLです。保存後はfile://で直接開き、DB閲覧、読み取り専用SQL、列分析、データ辞書、構造比較を実行時の外部通信なしで利用できます。

GitHubでソースを見る

組み合わせて使う

このツールの前後で使いやすいものを、作業の流れに沿って紹介します。

SQLiteを調べる SQLite Explorer DuckDBではなくSQLiteデータベースを横断検索し、レコード関係やSQLまで確認したい場合はこちらを使えます。 Parquetを確認する Parquet Viewer データベースではなくParquetファイルのスキーマ、メタデータ、row group、プレビューを確認したい場合に向いています。 JSON・YAML・CSVを確認する JSON / YAML / CSV Viewer JSON、YAML、CSV、TSV、JSON Linesを閲覧・検索・解析・変換したい場合はこちらを使えます。