HarborDB

最初の接続を作成する

Getting Started
•最終更新: 2026年2月16日

HarborDB へようこそ！このガイドでは、最初の PostgreSQL 接続を作成する手順を説明します。Mac 上のローカルデータベースに接続する場合でも、リモートサーバーに接続する場合でも、HarborDB はそのプロセスをシンプルで安全にします。

前提条件

開始する前に、以下を確認してください：

  1. HarborDB がインストール済み（インストールガイドを参照）
  2. PostgreSQL サーバーが実行中でアクセス可能
  3. 接続詳細が準備済み：
    • ホスト名または IP アドレス
    • ポート番号（デフォルト：5432）
    • データベース名
    • ユーザー名とパスワード
    • オプション：必要な場合は SSL 証明書

ステップ 1：HarborDB を起動し、接続にアクセスする

  1. HarborDB を開く - アプリケーションフォルダまたは Launchpad から開きます
  2. 接続サイドバーを探す - ウィンドウの左側にあります
  3. "+" ボタンをクリックするか、ファイル → 接続を追加に移動します

ステップ 2：接続詳細を入力する

接続ダイアログにはいくつかの入力項目があります：

基本情報

  • 名前: この接続の分かりやすい名前（例：「ローカル開発」、「本番サーバー」）
  • ホスト: PostgreSQL サーバーのアドレス
    • ローカルデータベース：localhost または 127.0.0.1
    • リモートサーバー：IP アドレスまたはホスト名（例：db.example.com）
  • ポート: PostgreSQL ポート（デフォルト：5432）
  • データベース: 接続する特定のデータベース
  • ユーザー名: PostgreSQL ユーザー名
  • パスワード: PostgreSQL パスワード

詳細オプション（オプション）

  • スキーマ: 優先するスキーマ（デフォルトは public）
  • SSL モード: サーバー構成に基づいて選択：
    • prefer: 利用可能な場合は SSL を使用
    • require: SSL 接続を必須にする
    • verify-full: 証明書検証付き SSL を必須にする
  • タイムアウト: 接続タイムアウト（秒単位）
  • アプリケーション名: この接続のカスタム識別子

ステップ 3：接続をテストする

保存する前に、常に接続をテストしてください：

  1. ダイアログで 「接続テスト」をクリック
  2. 確認を待つ - 「接続成功」と表示されるはずです
  3. 警告があれば確認 - SSL やその他の設定について

一般的なテスト結果

  • ✅ 成功: 保存して接続する準備ができています
  • ❌ 失敗: エラーメッセージを手がかりに確認：
    • 「接続が拒否されました」: サーバーが実行されていないか、ファイアウォールがブロックしています
    • 「認証に失敗しました」: ユーザー名/パスワードが間違っています
    • 「データベースが存在しません」: データベース名が間違っています

ステップ 4：接続を保存して保護する

パスワード保存オプション

HarborDB は安全なパスワード保存を提供します：

  • キーチェーンに保存（推奨）: パスワードは macOS キーチェーンで暗号化されます
  • 接続ファイルに保存: パスワードは接続設定と一緒に保存されます（安全性は低い）
  • 毎回確認: 接続ごとにパスワードを確認します

適切なオプションの選択

| 保存方法 | セキュリティ | 利便性 | 最適な用途 | | ---------------- | -------------- | ------------ | -------------------------------- | | macOS キーチェーン | 🔒 高い | ⚡ 高い | 日常使用、信頼できるコンピュータ | | 接続ファイル | 🔒 中程度 | ⚡ 高い | 迅速なセットアップ、テスト | | 毎回確認 | 🔒 最高 | ⚡ 低い | 共有コンピュータ、高セキュリティ |

接続の保存

  1. パスワード保存方法を選択
  2. 「保存」をクリックして接続を保存
  3. 接続サイドバーで接続を見つける
  4. ダブルクリックして接続

ステップ 5：接続して探索する

接続したら、以下のことができます：

データベースのナビゲート

  • 接続を展開してデータベースを表示
  • サイドバーでスキーマとテーブルを参照
  • テーブルを右クリックしてクイックアクション：
    • テーブル構造を表示
    • 最初の 100 行をプレビュー
    • SELECT クエリを生成

クイックスタートアクション

  1. クエリエディタを開く: SQL アイコンをクリックするか ⌘ + N を押す

  2. テストクエリを実行：

    SELECT version();

  3. インターフェースを探索: タブ、パネル、ツールに慣れる

接続管理

複数の接続の整理

接続を追加する際は、整理を維持してください：

  • お気に入り: 頻繁に使用する接続をスターでマークして迅速にアクセス
  • グループ: プロジェクト、環境、チームごとに整理
  • 色分け: タグや命名規則を使用

既存の接続の編集

  1. サイドバーで接続を右クリック
  2. 「接続を編集」を選択
  3. 必要に応じてフィールドを更新
  4. 変更をテストして保存

接続の複製

類似の接続を複製して時間を節約：

  1. ソース接続を右クリック
  2. 「複製」を選択
  3. 変更されたフィールドのみを修正
  4. 新しい接続として保存

セキュリティのベストプラクティス

パスワードセキュリティ

  • キーチェーンパスワードを決して共有しない
  • PostgreSQL ユーザーに強力なパスワードを使用
  • 定期的にパスワードを変更
  • 異なるサーバー間でパスワードの再利用を避ける

接続セキュリティ

  • リモート接続にはSSL を使用
  • 必要な操作にデータベース権限を制限
  • レポート用に読み取り専用接続を使用
  • 定期的に接続ログを監査

ネットワークセキュリティ

  • ファイアウォール構成: 信頼できる IP のみを許可
  • リモートデータベースにはVPN アクセス
  • 追加のセキュリティ層としてSSH トンネリング

一般的な接続シナリオ

ローカル PostgreSQL（Homebrew 経由でインストール）

名前: ローカル PostgreSQL
ホスト: localhost
ポート: 5432
データベース: postgres
ユーザー名: your_username
パスワード: [Keychain]

Docker PostgreSQL コンテナ

名前: Docker 開発 DB
ホスト: localhost
ポート: 5432  # 別の方法でマップされた場合はカスタムポート
データベース: app_database
ユーザー名: postgres
パスワード: postgres_password

Amazon RDS PostgreSQL

名前: AWS 本番
ホスト: your-db-instance.region.rds.amazonaws.com
ポート: 5432
データベース: production_db
ユーザー名: app_user
SSL モード: verify-full

Google Cloud SQL

名前: GCP Cloud SQL
ホスト: /cloudsql/project:region:instance
ポート: 5432
データベース: cloud_db
SSL モード: require

接続問題のトラブルシューティング

「サーバーに接続できません」

  1. PostgreSQL が実行中であることを確認：

    # ターミナルで
pg_isready -h localhost -p 5432

  2. ファイアウォール設定を確認：

    • macOS ファイアウォール（システム環境設定 → セキュリティとプライバシー）
    • ネットワークファイアウォールルール

  3. ネットワーク接続をテスト：

    # ターミナルで
ping your-server-address
telnet your-server-address 5432

「パスワード認証に失敗しました」

  1. PostgreSQL 認証方法を確認：

    • pg_hba.conf ファイルを表示
    • md5 または scram-sha-256 認証であることを確認

  2. 必要に応じてパスワードをリセット：

    ALTER USER username WITH PASSWORD 'new_password';

  3. ユーザーがデータベースアクセス権を持っていることを確認：

    -- スーパーユーザーとして接続
\du  -- ユーザーをリスト
\l   -- データベースをリスト

SSL/TLS 接続エラー

  1. SSL 要件を確認：

    • サーバーが特定の SSL モードを要求している可能性があります
    • 証明書をインポートする必要がある可能性があります

  2. 接続設定でSSL モードを調整

  3. verify-full モードを使用する場合は証明書をインポート

パフォーマンスのヒント

接続プーリング

  • 頻繁に使用する場合は接続を開いたままにする
  • リソースを解放するために未使用の接続を閉じる
  • アプリケーションには接続プーリングを使用

ネットワーク最適化

  • ローカル接続: 最高のパフォーマンスのために localhost を使用
  • リモート接続: 十分な帯域幅を確保
  • 圧縮: 大規模な結果セットを扱う場合は有効にする

次のステップ

接続したら：

  1. クエリの基礎を探索する - SQL クエリの作成と実行方法を学ぶ
  2. データベースナビゲーション - スキーマ、テーブル、リレーションシップを探索する
  3. データのエクスポート - 結果を CSV または JSON に保存する

ヘルプの入手

まだ問題がある場合：

  1. 詳細なトラブルシューティングについては サポートガイド を確認
  2. よくある質問については FAQ を参照
  3. 個別の支援については サポートにお問い合わせ
カテゴリに戻るドキュメントに戻る

これは役に立ちましたか？

フィードバックを提供してこのドキュメントの改善にご協力ください。

問題を報告サポートに連絡Edit this page