🦴

pgAdmin で “failed to fetch query history incorrect locale” というエラーが出た

に公開
DBeaver
PostgreSQL
pgAdmin
potgresql
tech

はじめに

pgAdmin 4 はPostgreSQLデータベースの管理や開発を行うためのGUIツールです。
会社ではDBeaver推しな感じですが、私はpgAdminのスッキリとしたUIが気に入ってずっと愛用しています。

エラー内容

いつも通りView/Edit Data をクリックすると画面が真っ白な状態に・・！
右下には failed to fetch query history incorrect locale というエラーが。。
突然起こったことで、対処に困った（すぐには復旧できなかった）のでやったことを残します。

あまりためにはならないかもですが。。笑

よくある原因

  1. OSまたは pgAdmin のロケール設定が壊れている
  2. PostgreSQL データのロケールと pgAdmin の表示ロケールに不整合がある
  3. ローカル SQLite DB（pgAdmin が履歴などに使用）の破損

試した対処法

  1. pgAdmin の Query History DB をリセットする

pgAdmin はクエリ履歴などを ローカル SQLite DB に保存しています。これが破損している可能性があるそう。
Mac/Linux の場合：

cd ~/.pgadmin
mv storage storage_backup

Windows の場合：

C:\Users\<YourUsername>\AppData\Roaming\pgadmin\storage

※この操作でクエリ履歴は削除されます（復旧不可）

  1. pgAdmin を完全に再インストール

例: Mac の場合

rm -rf ~/.pgadmin
brew uninstall --cask pgadmin4
brew install --cask pgadmin4

解決した方法

私の場合は、1を試しても治らず、2で解決しました🎉
再度Serverの設定が必要になったりするので、事前にバックアップをとっておくことをお勧めします。

おわりに

pgAdmin は使いやすくてとても気に入っているのですが、今回のようなローカルDB関連のトラブルは突然起きるので焦りました。
このエラーに遭遇する人は多くないかもしれませんが、誰かの助けになればうれしいです！
以上！

Discussion