# 設定とアプリデータ

> DuckLocal がデータを保存する場所、記憶する内容、行う可能性のあるネットワークリクエスト、インターフェースサイズ、テーマと言語、そしてリセット方法について。

Source: https://ducklocal.app/docs/ja/settings-and-data

DuckLocal はディスク上に 1 つのデータベースファイルを保存し、ウィンドウの実行中は小さなファイル、さらにログファイルも保存します。オンラインベースマップを有効にすると地図タイルもキャッシュし、ダウンロードした更新もキャッシュ内で待機します。それ以外はすべて、セッションの間だけメモリに保持されます。例外はダッシュボードのレビューコメントで、アプリデータディレクトリではなくダッシュボードファイルの隣に保存されます（[コメントでレビュー](dashboards.md#review-with-comments) を参照）。

## 保存場所 {#where-things-are-stored}

| プラットフォーム | パス |
| --- | --- |
| 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`](cli.md#show-work-in-the-running-window) がウィンドウに到達するために使います。読み取れるのはあなたのアカウントだけです。終了したウィンドウが残した古い `gui-endpoint.json` は無害です。

隣の `logs` フォルダーにはウィンドウのログ `ducklocal.log`（および前回起動時の `ducklocal.previous.log`）が入っています。DuckLocal がクラッシュすると、まずそこに `crash-….log` レポートが書き込まれ、次回の起動時に何が起きたかが **レポートを表示** とともに表示されます。直近 10 件のレポートが保持されます。[Issue を報告](https://github.com/JetSquirrel/DuckLocal/issues)するときはレポートを添付してください。**ログフォルダーを開く** はそのフォルダーを開きます。macOS では **DuckLocal** メニューに、それ以外のプラットフォームではステータスバー右端のバージョンの右クリックメニューにあります。`ducklocal` コマンドはログファイルを書きません。エラーは呼び出し元に返ります。

[オンラインベースマップ](#online-base-map)の地図タイルは、プラットフォームのキャッシュフォルダー（macOS では `~/Library/Caches/DuckLocal/tiles`、Windows では `%LOCALAPPDATA%\DuckLocal\cache\tiles`、Linux では `~/.cache/ducklocal/tiles`）に、タイルサーバーごとに 1 つのフォルダーとして保存されます。削除しても問題ありません。タイルは単に再ダウンロードされます。ダウンロード済みの[更新](#update-check)は、インストールされるまで同じキャッシュフォルダーの `updates` で待機します。

## 再起動後も残るもの

| 記憶されるもの | 場所 |
| --- | --- |
| 登録済みデータファイル — パス、ビュー名、種類 | アプリデータファイル |
| クエリ履歴（失敗も含む） | アプリデータファイル |
| インターフェースの言語 | アプリデータファイル |
| インターフェースのサイズ | アプリデータファイル |
| 初回ガイドを表示したかどうか | アプリデータファイル |
| サイドバーが非表示かどうか | アプリデータファイル |
| 開いているデータベースの横にアタッチしたデータベース、およびそれぞれが読み取り専用かどうか | アプリデータファイル |
| 最後に開いていたデータベースファイル | アプリデータファイル — ファイルが存在する間は起動時に再度開かれます |
| 開いているクエリタブ（タイトルと SQL を含む） | アプリデータファイル |
| 開いているダッシュボードタブ（タイトルを含む） | アプリデータファイル |
| オンラインベースマップがオンの状態かどうか | アプリデータファイル |
| 起動時に DuckLocal が更新を確認するかどうか | アプリデータファイル |
| 最近開いたダッシュボード（サイドバーの **ダッシュボード**） | アプリデータファイル |

| 記憶されないもの | 補足 |
| --- | --- |
| 結果パネルの内容 | メモリ内のみ — クエリを再実行してください |
| インメモリデータベースで作成したテーブルとビュー | 保存されませんが、終了時や別のデータベースを開くときに保存するか確認されます。**データベースとして保存…** で `.duckdb` ファイルに書き出せます |
| 移動または削除されたデータベースファイル | 次回の起動はインメモリで始まります |
| ウィンドウのサイズと位置 | 1440×900 固定、最小 960×600 |
| サイドバーと結果パネルのサイズ | 起動ごとに固定 |
| 結果のフィルター | メモリ内のみ |
| ダッシュボードのフィルターで選択した内容 | メモリ内のみ。タブの再読み込みをまたいで保持されます |
| **テーマ** | 常にライトで起動 — 後述 |
| S3 の認証情報 | 設計上、セッション限定 |

テーマだけが例外です。言語の切り替えは保持されますが、テーマの切り替えは保持されず、起動のたびにライトモードで始まります。

通常の起動ではインメモリで動作するため、そこで作成したテーブルやビューはウィンドウとともに失われます。DuckLocal はその前に確認します。終了するとき、ウィンドウを閉じるとき、またはそのようなテーブルがある状態で別のデータベースを開くときに、**データベースとして保存…**、**保存せずに終了**、**キャンセル** のいずれかを選べます。**データベースとして保存…**（**⌘⇧S**、または **開く → データベースとして保存…** でも実行できます）は、スキーマ、テーブルとその行、ビュー、マクロ、シーケンスを `.duckdb` ファイルにコピーし、ウィンドウをそのファイルに移します。以降の変更はそのファイルに書き込まれ、次回の起動時にはそのファイルがまた開かれます。登録済みファイルから作られるビューは対象に含まれません。これらは起動のたびにファイルから作り直されるためです。

## ネットワーク {#network}

DuckLocal は、あなたが有効にするまで自分からはネットワークリクエストを行いません。スイッチは 2 つあり、どちらも最初はオフです。加えて、あなたが直接要求するものがあります:

| リクエスト | タイミング | マシンから出るもの |
| --- | --- | --- |
| [オンラインベースマップ](#online-base-map) | 有効にした後、地図を描くたび | どのタイルが必要か。表示中の領域とズームのおおよその情報 |
| [更新チェック](#update-check) | バージョンをクリックしたとき、または有効にした後は起動時 | `dl.ducklocal.app` に最新リリースのバージョンを問い合わせる 1 件のリクエスト。新しいものがあれば、そのパッケージのダウンロード |
| [S3](s3.md) | S3 を設定してクエリするとき | 設定したストアへのあなたのリクエスト |
| 拡張機能 | **インストール** や **更新** をクリックしたとき、または `INSTALL` を実行したとき | DuckDB の拡張機能リポジトリからのダウンロード |
| SQL 内のリモートデータ | SQL が `https://`、`s3://`、またはリモートデータベースを指定したとき（ダッシュボードの SQL が開いたときも含む）。拡張機能がすでにインストールされている必要があります | SQL が要求する内容。アドレスに書き込まれたものも含みます |

テレメトリーはなく、あなたが実行する SQL を除いて、これらがあなたのデータの 1 行を送ることはありません。SQL は書かれたとおりに動作します。アドレスにテーブルの値を載せることができます。そのため `httpfs` がインストールされていれば、信頼できない相手からの `.dash` ファイルは、あなたが開いたときにデータを送信できます。[ネットワークとプライバシー](https://github.com/JetSquirrel/DuckLocal/blob/main/docs/network-and-privacy.md) には、すべての経路と自分で確認する方法が載っています。

## オンラインベースマップ {#online-base-map}

地図グラフ（ダッシュボード内、または結果の **グラフ** タブ）は、点の下に OpenStreetMap のタイルを描けます。**表示 → オンラインベースマップ（OpenStreetMap）** でオン/オフを切り替え、選択は記憶されます（`map_tiles` 設定、`on` または `off`）。初期状態はオフです。マシンから出るのは要求したタイル（表示中の領域とズームのおおよその情報）だけで、データの行は決して出ません。

取得は OpenStreetMap Foundation のタイルポリシーに従います。識別可能な User-Agent、同時リクエストは最大 2 件、タイルは 1 週間キャッシュから再利用、一括プリフェッチなし、地図上に帰属表示。より多く使う場合は、設定テーブルの `map_tile_url` に別サーバーの `{z}/{x}/{y}` URL テンプレートを設定してください。

## 更新チェック {#update-check}

ステータスバーの末尾には 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 リリース](https://github.com/JetSquirrel/DuckLocal/releases/latest)と同じパッケージを、中国本土でも高速なミラーから配信しています。

macOS では **DuckLocal** メニューに同じチェックがあり、**アップデートを確認…** と **起動時にアップデートを確認** として提供されます。後者はアプリの起動ごとに 1 回確認します。オンにするまではオフです（`update_check` 設定、`on` または `off`）。それまでは、クリックしたときにだけ確認します。

## 言語

タイトルバーの `EN` / `中` ボタンはインターフェースの言語を即座に切り替え、選択を記録します。

初回起動時（設定がまだ保存されていないとき）は、言語はシステムロケールから取得されます。`LC_ALL` または `LANG` に `zh` が含まれていれば中国語、それ以外は英語です。認識できない保存値は中国語にフォールバックします。

一部の文字列は意図的に翻訳されていません。`DuckLocal`、`S3` と `EXPLAIN` のボタンラベル、`EN` / `中` の切り替え、認証情報のプレースホルダーです。エンジンとネットワークのエラーメッセージはそのまま表示され、インターフェースの言語にかかわらず常に英語です。

## テーマ

太陽/月のボタンでライトテーマとダークテーマを切り替えます。テーマ選択も編集するテーマファイルもありません。2 つのモードだけです。

## インターフェースサイズ {#interface-size}

テキスト、アイコン、コントロールは 4 段階でまとめて拡大縮小されます:

| サイズ | 基本テキスト | エディタのテキスト |
| --- | --- | --- |
| 小 | 13px | 12px |
| 標準 | 14px | 13px |
| 大 | 16px | 15px |
| 特大 | 18px | 17px |

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

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

## リセット

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

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

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

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

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

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