コンテンツへスキップ

設定とアプリデータ ​

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 件のリクエスト。新しいものがあれば、そのパッケージのダウンロード
S3S3 を設定してクエリするとき設定したストアへのあなたのリクエスト
拡張機能インストール や 更新 をクリックしたとき、または 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 段階でまとめて拡大縮小されます:

サイズ基本テキストエディタのテキスト
小13px12px
標準14px13px
大16px15px
特大18px17px

タイトルバーの Aa ボタンから選ぶか、⌘+(大きく)、⌘−(小さく)、⌘0(標準に戻す)で切り替えます。これらはフォーカスがどこにあっても機能し、SQL エディタ内でも同様です。選択は記憶され、ライトとダークの切り替えをまたいで保持されます。

ドラッグしたパネルのサイズやダッシュボードのプロットの高さはピクセルのままです。これらはインターフェースではなく、あなたが調整するものです。

リセット ​

やり直すには(履歴、登録済みファイル、アタッチしたデータベース、記憶されたタブ、すべての設定を消去)、DuckLocal を終了してアプリデータディレクトリを削除します:

bash
rm -rf ~/Library/Application\ Support/DuckLocal   # macOS
rm -rf ~/.local/share/ducklocal                  # Linux

Windows では %APPDATA%\DuckLocal を削除します。

次回の起動時に新しく作成されます。あなたのデータファイルがこれで影響を受けることはありません。 影響するのは DuckLocal 自身の記録だけです。

トラブルシューティング ​

症状、原因、対処は トラブルシューティング ページにまとめています。

Apache-2.0 ライセンスで公開されています。