設定とアプリデータ
DuckLocal はディスク上に 1 つのデータベースファイルを保存し、ウィンドウの実行中は小さなファイル、さらにログファイルも保存します。オンラインベースマップを有効にすると地図タイルもキャッシュし、ダウンロードした更新もキャッシュ内で待機します。それ以外はすべて、セッションの間だけメモリに保持されます。例外はダッシュボードのレビューコメントで、アプリデータディレクトリではなくダッシュボードファイルの隣に保存されます(コメントでレビュー を参照)。
保存場所
| プラットフォーム | パス |
|---|---|
| macOS | ~/Library/Application Support/DuckLocal/history.duckdb |
| Windows | %APPDATA%\DuckLocal\data\history.duckdb |
| Linux | ~/.local/share/ducklocal/history.duckdb |
DuckDB ファイルには 4 つのテーブルがあります。クエリ履歴、登録済みデータファイル、開いているデータベースの横にアタッチしたデータベース、そして小さなキー/バリュー形式の設定テーブルです。設定にはインターフェースの言語とサイズ、開いているクエリタブとダッシュボードタブ、最近のダッシュボードのリスト、ベースマップと更新チェックの有効/無効が含まれます。アプリの実行中は、その隣に併設の .wal ファイル(DuckDB の書き込み前ログ)があります。
データセットがアプリケーションデータベースにコピーされることはありません。登録済みファイルはファイルパスとして保存され、DuckLocal の起動時に自動で再アタッチされます。
その隣には、ウィンドウが開いている間、ループバックポートとランダムなトークンを保持する gui-endpoint.json があり、ducklocal open がウィンドウに到達するために使います。読み取れるのはあなたのアカウントだけです。終了したウィンドウが残した古い gui-endpoint.json は無害です。
隣の logs フォルダーにはウィンドウのログ ducklocal.log(および前回起動時の ducklocal.previous.log)が入っています。DuckLocal がクラッシュすると、まずそこに crash-….log レポートが書き込まれ、次回の起動時に何が起きたかが レポートを表示 とともに表示されます。直近 10 件のレポートが保持されます。Issue を報告するときはレポートを添付してください。ログフォルダーを開く はそのフォルダーを開きます。macOS では DuckLocal メニューに、それ以外のプラットフォームではステータスバー右端のバージョンの右クリックメニューにあります。ducklocal コマンドはログファイルを書きません。エラーは呼び出し元に返ります。
オンラインベースマップの地図タイルは、プラットフォームのキャッシュフォルダー(macOS では ~/Library/Caches/DuckLocal/tiles、Windows では %LOCALAPPDATA%\DuckLocal\cache\tiles、Linux では ~/.cache/ducklocal/tiles)に、タイルサーバーごとに 1 つのフォルダーとして保存されます。削除しても問題ありません。タイルは単に再ダウンロードされます。ダウンロード済みの更新は、インストールされるまで同じキャッシュフォルダーの updates で待機します。
再起動後も残るもの
| 記憶されるもの | 場所 |
|---|---|
| 登録済みデータファイル — パス、ビュー名、種類 | アプリデータファイル |
| クエリ履歴(失敗も含む) | アプリデータファイル |
| インターフェースの言語 | アプリデータファイル |
| インターフェースのサイズ | アプリデータファイル |
| 初回ガイドを表示したかどうか | アプリデータファイル |
| サイドバーが非表示かどうか | アプリデータファイル |
| 開いているデータベースの横にアタッチしたデータベース、およびそれぞれが読み取り専用かどうか | アプリデータファイル |
| 最後に開いていたデータベースファイル | アプリデータファイル — ファイルが存在する間は起動時に再度開かれます |
| 開いているクエリタブ(タイトルと SQL を含む) | アプリデータファイル |
| 開いているダッシュボードタブ(タイトルを含む) | アプリデータファイル |
| オンラインベースマップがオンの状態かどうか | アプリデータファイル |
| 起動時に DuckLocal が更新を確認するかどうか | アプリデータファイル |
| 最近開いたダッシュボード(サイドバーの ダッシュボード) | アプリデータファイル |
| 記憶されないもの | 補足 |
|---|---|
| 結果パネルの内容 | メモリ内のみ — クエリを再実行してください |
| インメモリデータベースで作成したテーブルとビュー | 保存されませんが、終了時や別のデータベースを開くときに保存するか確認されます。データベースとして保存… で .duckdb ファイルに書き出せます |
| 移動または削除されたデータベースファイル | 次回の起動はインメモリで始まります |
| ウィンドウのサイズと位置 | 1440×900 固定、最小 960×600 |
| サイドバーと結果パネルのサイズ | 起動ごとに固定 |
| 結果のフィルター | メモリ内のみ |
| ダッシュボードのフィルターで選択した内容 | メモリ内のみ。タブの再読み込みをまたいで保持されます |
| テーマ | 常にライトで起動 — 後述 |
| S3 の認証情報 | 設計上、セッション限定 |
テーマだけが例外です。言語の切り替えは保持されますが、テーマの切り替えは保持されず、起動のたびにライトモードで始まります。
通常の起動ではインメモリで動作するため、そこで作成したテーブルやビューはウィンドウとともに失われます。DuckLocal はその前に確認します。終了するとき、ウィンドウを閉じるとき、またはそのようなテーブルがある状態で別のデータベースを開くときに、データベースとして保存…、保存せずに終了、キャンセル のいずれかを選べます。データベースとして保存…(⌘⇧S、または 開く → データベースとして保存… でも実行できます)は、スキーマ、テーブルとその行、ビュー、マクロ、シーケンスを .duckdb ファイルにコピーし、ウィンドウをそのファイルに移します。以降の変更はそのファイルに書き込まれ、次回の起動時にはそのファイルがまた開かれます。登録済みファイルから作られるビューは対象に含まれません。これらは起動のたびにファイルから作り直されるためです。
ネットワーク
DuckLocal は、あなたが有効にするまで自分からはネットワークリクエストを行いません。スイッチは 2 つあり、どちらも最初はオフです。加えて、あなたが直接要求するものがあります:
| リクエスト | タイミング | マシンから出るもの |
|---|---|---|
| オンラインベースマップ | 有効にした後、地図を描くたび | どのタイルが必要か。表示中の領域とズームのおおよその情報 |
| 更新チェック | バージョンをクリックしたとき、または有効にした後は起動時 | dl.ducklocal.app に最新リリースのバージョンを問い合わせる 1 件のリクエスト。新しいものがあれば、そのパッケージのダウンロード |
| S3 | S3 を設定してクエリするとき | 設定したストアへのあなたのリクエスト |
| 拡張機能 | インストール や 更新 をクリックしたとき、または INSTALL を実行したとき | DuckDB の拡張機能リポジトリからのダウンロード |
| SQL 内のリモートデータ | SQL が https://、s3://、またはリモートデータベースを指定したとき(ダッシュボードの SQL が開いたときも含む)。拡張機能がすでにインストールされている必要があります | SQL が要求する内容。アドレスに書き込まれたものも含みます |
テレメトリーはなく、あなたが実行する SQL を除いて、これらがあなたのデータの 1 行を送ることはありません。SQL は書かれたとおりに動作します。アドレスにテーブルの値を載せることができます。そのため httpfs がインストールされていれば、信頼できない相手からの .dash ファイルは、あなたが開いたときにデータを送信できます。ネットワークとプライバシー には、すべての経路と自分で確認する方法が載っています。
オンラインベースマップ
地図グラフ(ダッシュボード内、または結果の グラフ タブ)は、点の下に OpenStreetMap のタイルを描けます。表示 → オンラインベースマップ(OpenStreetMap) でオン/オフを切り替え、選択は記憶されます(map_tiles 設定、on または off)。初期状態はオフです。マシンから出るのは要求したタイル(表示中の領域とズームのおおよその情報)だけで、データの行は決して出ません。
取得は OpenStreetMap Foundation のタイルポリシーに従います。識別可能な User-Agent、同時リクエストは最大 2 件、タイルは 1 週間キャッシュから再利用、一括プリフェッチなし、地図上に帰属表示。より多く使う場合は、設定テーブルの map_tile_url に別サーバーの {z}/{x}/{y} URL テンプレートを設定してください。
更新チェック
ステータスバーの末尾には DuckLocal のバージョン(DuckLocal 0.3.0)が表示されます。クリックすると dl.ducklocal.app に最新リリースを問い合わせます:
- 最新です — 実行中のバージョンが最新です。
- v0.3.1 をダウンロード中… — 新しいリリースがあり、DuckLocal がダウンロードしています。パッケージは展開前に、リリースで公開されたサイズと SHA-256 で検証されます(macOS では、実行中のアプリの署名でも検証されます)。
- 再起動して v0.3.1 に更新 — 新しいバージョンの準備ができました。クリックすると終了、インストール、再起動します。そうしなければ、次に DuckLocal を終了したときにインストールされます。
- 更新があります: v0.3.1 — このコピーでは自分でインストールできない新しいリリースです。自分でコンパイルしたビルドや、書き込み権限のないフォルダーにあるアプリなどです。クリックするとパッケージをダウンロードします。インストールは今回インストールした方法で行ってください。
- 更新チェックに失敗しました — カーソルを合わせると理由(オフライン、プロキシ、チェックサムと一致しなかったダウンロードなど)が表示されます。クリックすると再試行します。
更新は dl.ducklocal.app から提供され、GitHub リリースと同じパッケージを、中国本土でも高速なミラーから配信しています。
macOS では DuckLocal メニューに同じチェックがあり、アップデートを確認… と 起動時にアップデートを確認 として提供されます。後者はアプリの起動ごとに 1 回確認します。オンにするまではオフです(update_check 設定、on または off)。それまでは、クリックしたときにだけ確認します。
言語
タイトルバーの EN / 中 ボタンはインターフェースの言語を即座に切り替え、選択を記録します。
初回起動時(設定がまだ保存されていないとき)は、言語はシステムロケールから取得されます。LC_ALL または LANG に zh が含まれていれば中国語、それ以外は英語です。認識できない保存値は中国語にフォールバックします。
一部の文字列は意図的に翻訳されていません。DuckLocal、S3 と EXPLAIN のボタンラベル、EN / 中 の切り替え、認証情報のプレースホルダーです。エンジンとネットワークのエラーメッセージはそのまま表示され、インターフェースの言語にかかわらず常に英語です。
テーマ
太陽/月のボタンでライトテーマとダークテーマを切り替えます。テーマ選択も編集するテーマファイルもありません。2 つのモードだけです。
インターフェースサイズ
テキスト、アイコン、コントロールは 4 段階でまとめて拡大縮小されます:
| サイズ | 基本テキスト | エディタのテキスト |
|---|---|---|
| 小 | 13px | 12px |
| 標準 | 14px | 13px |
| 大 | 16px | 15px |
| 特大 | 18px | 17px |
タイトルバーの Aa ボタンから選ぶか、⌘+(大きく)、⌘−(小さく)、⌘0(標準に戻す)で切り替えます。これらはフォーカスがどこにあっても機能し、SQL エディタ内でも同様です。選択は記憶され、ライトとダークの切り替えをまたいで保持されます。
ドラッグしたパネルのサイズやダッシュボードのプロットの高さはピクセルのままです。これらはインターフェースではなく、あなたが調整するものです。
リセット
やり直すには(履歴、登録済みファイル、アタッチしたデータベース、記憶されたタブ、すべての設定を消去)、DuckLocal を終了してアプリデータディレクトリを削除します:
rm -rf ~/Library/Application\ Support/DuckLocal # macOS
rm -rf ~/.local/share/ducklocal # LinuxWindows では %APPDATA%\DuckLocal を削除します。
次回の起動時に新しく作成されます。あなたのデータファイルがこれで影響を受けることはありません。 影響するのは DuckLocal 自身の記録だけです。
トラブルシューティング
症状、原因、対処は トラブルシューティング ページにまとめています。
