DBeaverを使ったServBayデータベースの管理方法

ServBayは総合的なローカルWeb開発環境であり、開発者のために各種一般的なデータベースサービスを提供しています。ServBayには、phpMyAdmin（MySQL/MariaDB用）、pgAdmin（PostgreSQL用）、Redis Commander（Redis用）などのWebインターフェイス型データベース管理ツールが付属していますが、多くの開発者は、より強力で統一感のあるデスクトップクライアントを好みます。そのようなツールの代表が、クロスプラットフォームで人気の高いデータベース管理ツール「DBeaver」です。

この記事では、DBeaverを使ってServBayに統合されたデータベース（MariaDB/MySQL、PostgreSQL、SQLite、Redis）へ接続・管理する方法を解説します。

DBeaverとは？

DBeaverは、開発者・SQLプログラマー・データベース管理者・アナリスト向けの、無料かつオープンソースの汎用データベース管理ツールです。主な関係型データベース（MySQL、PostgreSQL、Oracle、SQL Server、SQLiteなど）から、NoSQLデータベース（MongoDB、Redis、Cassandraなど）まで、ほぼすべての主要なDBシステムに対応しています。

DBeaverの主な特徴：

• 幅広いデータベース対応: 統一されたUIから多様なデータベース管理が可能。
• 使いやすいインターフェース: 直感的かつ視覚的なグラフィカルUIで、複雑な操作を簡略化。
• 強力な機能: SQLエディター、データエディター、メタデータブラウザ、ER図生成、データインポート／エクスポートなど、多彩な高度機能を搭載。
• クロスプラットフォーム: Windows、macOS、Linuxで利用可能。
• 活発なコミュニティ・継続的なアップデート: 安定性と機能拡張が保証されています。

ServBayユーザーにとって、DBeaverとの組み合わせは、特に複数種類のデータベース管理や高度なクエリ・操作が必要な場面で、より専門的かつ統一感のあるデータベース管理体験を提供します。

DBeaverを使ったServBay付属のMariaDB/MySQLデータベース管理

ServBayではMariaDBが標準搭載されており、MySQLとも高い互換性があります。ここでは、DBeaverからServBayのMariaDB/MySQLデータベースに接続・管理する手順を解説します。

事前準備

• ServBayがインストールされ、起動していること。
• MariaDB/MySQLパッケージがServBay上で稼働中であること。
• DBeaverクライアントのダウンロード・インストールが完了していること。最新版は DBeaver公式サイト から入手できます。

MariaDB/MySQLへの接続手順

1. DBeaverを起動します。
2. 左上の 「新規データベース接続」 ボタン（一般的にプラグアイコン）をクリックします。
3. データベース一覧から 「MariaDB」 または 「MySQL」 を検索・選択し、「次へ」 をクリック。
4. 接続情報を入力します：
   • ホスト (Host): 127.0.0.1 または localhost
   • ポート (Port): 3306
   • ユーザー名 (Username): デフォルトは root
   • パスワード (Password): ServBayアプリの データベース タブでrootパスワードを確認できます。
   • データベース (Database): 空欄でもOK。接続後に選択または新規作成可能。
   • 接続方法（任意）: TCP/IP（ホスト＋ポート）接続以外に、Socket接続も選択可能で、本地接続の場合は効率的です。ドライバー設定 (Driver properties) 内で connectUsing を socket にし、socketの値をServBayのSocketファイルのパス（通常 /Applications/ServBay/tmp/mysql.sock）に設定してください。注意：Socket接続の場合はホスト・ポートの入力不要です。
5. 「接続テスト」 ボタンで情報を確認。失敗する場合は、MariaDBが稼働しているか、ユーザー名またはパスワードが正しいか確認しましょう。パスワードを忘れた場合は、ServBayの データベース タブでreset可能です。
6. テストが成功したら、「完了」 で保存。

基本操作

接続が成功すると、DBeaverのナビゲータでServBayのMariaDB/MySQLインスタンスが表示されます。主な基本操作は以下の通りです。

• データベースの作成: 接続名を右クリック→ 「SQLエディター」 → 「新規SQLスクリプト」。CREATE DATABASE mydatabase_servbay;（mydatabase_servbayを希望名に変更）と記入し、実行ボタンをクリック。
• SQLエディターでクエリ: 接続やデータベース・テーブルを右クリック→ 「SQLエディター」 → 「新規SQLスクリプト」。例：SELECT * FROM your_table_name; を記入して実行。
• データの閲覧・編集: ナビゲータからデータベース／テーブルを展開・ダブルクリックでデータ編集画面を表示。
• テーブルの新規作成・編集・削除: データベース配下の 「テーブル」 を右クリックし 「新規テーブル作成」。既存テーブルの編集・削除も右クリックで可能。
• データのインポート／エクスポート: DBeaverは多様なフォーマットでのインポート・エクスポート機能を提供。

ほとんどの操作はDBeaverのグラフィカルUIやSQLエディターから直感的に行えます。他のデータベースと管理手順は類似しています。

DBeaverを使ったServBay付属のPostgreSQL管理

ServBayはPostgreSQLも標準装備しています。ここでは、DBeaverでServBayのPostgreSQLへ接続・管理する手順を説明します。

事前準備

• ServBayがインストール・起動済みであること。
• PostgreSQLパッケージがServBay上で稼働中であること。
• DBeaverクライアントのインストールが完了していること。

PostgreSQLへの接続手順

1. DBeaverを起動します。
2. 左上の 「新規データベース接続」 ボタンをクリック。
3. データベース一覧から 「PostgreSQL」 を検索・選択し、「次へ」 をクリック。
4. 接続情報を入力します：
   • ホスト (Host): 127.0.0.1 や localhost
   • ポート (Port): 5432（PostgreSQL標準ポート）
   • データベース (Database): デフォルトは postgres。ServBayで作成した他DBにも接続可。
   • ユーザー名 (Username): デフォルトは servbay
   • パスワード (Password): ServBayアプリの データベース タブで確認できます。
   • 接続方法（任意）: MariaDB/MySQL同様、Socket接続可。ドライバー設定 (Driver properties) で socketFactory などの項目にSocketファイルのパス（デフォルト /Applications/ServBay/tmp/.s.PGSQL.5432、失敗時は /Applications/ServBay/tmp も試して下さい）を設定。DBeaverバージョンによって詳細は異なるため、接続詳細の詳細設定を参照。Socket接続時はホスト・ポート入力不要です。
5. 「接続テスト」 をクリック。失敗時はPostgreSQLが稼働中・ユーザー名／パスワードが正しいか確認。パスワードを忘れた場合は、ServBayで再設定できます。
6. 成功したら 「完了」 で保存。

基本操作

PostgreSQLに接続できたら、DBeaverナビゲータでServBayのインスタンスが表示されます。関係型データベースの基本操作（データベースやテーブル作成、クエリ実行、データ編集、インポート／エクスポート）はMariaDB/MySQL同様、グラフィカルUIやSQLエディターから操作できます。

DBeaverを使ったServBayのSQLite 3管理

ServBayは軽量なファイルベースデータベースSQLite 3にも対応しています。SQLiteは独立したDBサーバープロセス不要で、そのまま利用可能です。

事前準備

• ServBayのインストール・起動を確認。
• DBeaverクライアントがインストール済みであること。
• SQLiteのデータベースファイル（.db, .sqlite, .sqlite3など）を用意。ファイルが未作成でも新規作成可能です。

SQLiteへの接続手順

1. DBeaverを起動します。
2. 左上の 「新規データベース接続」 ボタンをクリック。
3. データベース一覧から 「SQLite」 を検索・選択し、「次へ」 をクリック。
4. 接続情報を入力します：
   • データベースファイルパス (Database File): 右側のフォルダアイコンをクリックして、SQLiteのデータベースファイルのフルパスを指定。ServBayでは /Applications/ServBay/db/sqlite/ 配下への保存を推奨。
   • ファイルが未作成の場合、希望のパスとファイル名を入力すれば新規作成されます。
5. 「接続テスト」 ボタンでファイルパスが正しいか確認。うまくいけば成功します。
6. 成功したら 「完了」 で保存。

SQLiteの基本操作

SQLiteファイルに接続した後は、他DB同様にDBeaverで操作可能です。SQLiteはシンプルな機能セットとなります。

• テーブル作成: 接続名を右クリックし 「新規テーブル作成」 を選択。
• SQLエディター利用: 接続名を右クリック→ 「SQLエディター」 → 「新規SQLスクリプト」。SQL文を入力・実行。
• データ閲覧・編集: テーブル名をダブルクリックでデータ表示・編集。
• テーブル削除: テーブル名を右クリックし 「削除」 を選択。
• データベース削除: SQLiteはファイル単体なので、ファイルシステムで .db ファイルを削除すれば良いです。

DBeaverを使ったServBayのRedis管理

Redisはオープンソースのインメモリ型データストアで、DB・キャッシュ・メッセージブローカーとして利用可能です。ServBayにもRedisが統合されています。

事前準備

• ServBayのインストール・起動を確認。
• RedisパッケージがServBayで稼働中であること。
• DBeaverクライアントがインストール済みであること。

Redisへの接続手順

1. DBeaverを起動します。
2. 左上の 「新規データベース接続」 ボタンをクリック。
3. データベース一覧から 「Redis」 を検索・選択し、「次へ」 をクリック。
4. 接続情報を入力します：
   • ホスト (Host): 127.0.0.1 や localhost
   • ポート (Port): 6379（Redis標準ポート）
   • パスワード (Password): ServBay標準のRedisはパスワード未設定なので空欄。パスワード設定済みの場合は入力してください。
5. 「接続テスト」 ボタンで確認。失敗する時は、Redisが稼働しポート・パスワードが正確かを確認しましょう。
6. 成功したら 「完了」 で保存。

Redisの基本管理

Redis接続後はDBeaverのグラフィカルUIでキー・値の管理が行えます。

• キー一覧表示: ナビゲータで接続を展開し、データベース（通常 DB 0）を選択するとキーが表示されます。
• キー追加: データベースノードやキー一覧の空欄で右クリック→ 「新規キー作成」。キー名・値・型（String、List、Set、Hash、ZSet等）を入力。
• キー編集: 既存キーをダブルクリックまたは右クリック→ 「キー編集」 で値・TTLを変更可能。
• キー削除: キー名を右クリック→ 「キー削除」 で削除。
• Redisコンソール利用: 接続やデータベースを右クリック→ 「SQLエディター」 → 「新規Redisコンソール」 で直接コマンド実行可能。

よくある質問・トラブルシューティング（FAQ）

• 接続できず、Connection Refused（接続拒否）と表示される：
  • ServBayが起動中か確認。
  • 対象のDBサービス（MariaDB/MySQL、PostgreSQL、Redis）がServBay上で「稼働中（緑）」になっているか確認。
  • 接続情報（ホスト・ポート）が正しいかチェック。ローカル接続は通常 127.0.0.1＆デフォルトポート（MariaDB/MySQL: 3306、PostgreSQL: 5432、Redis: 6379）。
  • Socket接続の場合、SocketファイルパスやDB設定が正しいかも確認。
  • ファイアウォール設定でDBeaverのローカルポート通信が妨げられていないか確認しましょう。
• 認証失敗（Authentication Failed）が発生する：
  • ユーザー名・パスワードが正しいか確認。ServBayの データベース タブで確認・再設定可能です。
• SQLite接続時にファイルパスエラー：
  • ファイルパスが完全・正確であるか再確認。
  • DBeaverが該当パスに読み書き権限を持っているか確認。
• DBeaverの表示不具合・UIエラー：
  • DBeaverの再起動を試みる。
  • Java環境（DBeaverはJavaを使用）に不具合がないかもチェック。

まとめ

DBeaverは高性能な汎用データベース管理ツールであり、ServBayのローカル開発環境との併用により、様々なデータベース管理効率を大幅に向上できます。本記事の案内で、DBeaverを使ったServBay標準のMariaDB/MySQL、PostgreSQL、SQLite、Redisデータベースへの接続・日常管理が手軽に行えます。データ閲覧・編集、SQLクエリ実行、高度なメンテナンスまで、DBeaverは統一された快適なユーザー体験を提供し、ServBayの便利な環境管理と組み合わせることで、ローカル開発ワークフローがよりスムーズになります。