> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# データベースコネクタ

> PostgreSQL · MySQL · MS-SQL · Oracle · MongoDB に接続し、クエリ時にライブで読み込みます。

## 概要

データベースコネクタは、PostgreSQL・MySQL・MS-SQL・Oracle・MongoDB に接続します。
データをコピーして保存せず、**クエリ時に DB からライブで読み込みます。**
DB が列情報を提供するため、ファイルコネクタと異なりヘッダー行の選択ステップはありません。

<Info>
  この画面は**管理者（Manager）以上**（owner・manager）のみアクセスできます。メニュー可視性 `manage`。
</Info>

## ステップ

<Steps>
  <Step title="接続・テーブル">
    接続情報を入力し、`接続 & テーブル取得` で接続したうえで、テーブルまたはコレクションを選択します。
  </Step>

  <Step title="データビュー・フィルタ">
    プレビューを確認し、条件に合う行のみを使用するようフィルタを設定します。
  </Step>

  <Step title="データマッピング">
    各列に意味（必須・標準フィールド名）と詳細（任意）を指定します。
  </Step>

  <Step title="登録">
    名前を入力してデータソースを登録します。
  </Step>
</Steps>

## 接続情報（SQL）

| フィールド    | 説明                                                                                       |
| -------- | ---------------------------------------------------------------------------------------- |
| ホスト      | DB サーバーのアドレス                                                                             |
| ポート      | 既定値 — PostgreSQL `5432` · MySQL `3306` · MS-SQL `1433` · Oracle `1521` · MongoDB `27017` |
| データベース   | 対象データベース                                                                                 |
| スキーマ（任意） | スキーマ指定（MongoDB を除く）                                                                      |
| ユーザー     | 接続アカウント                                                                                  |
| パスワード    | 接続パスワード（AES-256-GCM 暗号化で保存）                                                              |

### SSL / TLS

| モード                      | 説明                  |
| ------------------------ | ------------------- |
| 無効                       | 暗号化しない              |
| 暗号化 (require)            | 転送暗号化のみ             |
| CA 検証 (verify-ca)        | サーバー CA 証明書（PEM）を検証 |
| CA + ホスト検証 (verify-full) | CA + ホスト名まで検証       |

<Note>
  verify モード（verify-ca・verify-full）はサーバー CA 証明書（PEM）が必要です。
</Note>

### SSH トンネル（任意）

Bastion ホストを経由して DB に接続します。フィールド: Bastion ホスト・ポート・ユーザー・認証方式（秘密鍵 PEM またはパスワード）。認証情報は暗号化して保存されます。

## データの取得

<Tabs>
  <Tab title="テーブル（SQL）">
    取得するテーブルを選択するか、**カスタムクエリ**を作成します。カスタムクエリは `SELECT` / `WITH`（参照専用）のみ許可され、簡易ビルダーで基本的な `SELECT` 文を生成できます。
  </Tab>

  <Tab title="MongoDB">
    コレクションを選択し、ソース方式を選びます。

    * **コレクションサンプル**: コレクションからサンプルを読み込みます。
    * **Aggregation パイプライン**: JSON 配列でパイプラインを作成します。`$out` · `$merge` は許可されません（参照専用）。
  </Tab>
</Tabs>

## セキュリティ・編集

<Warning>
  パスワードは **AES-256-GCM で暗号化**して保存され、クライアントには返されません。
  編集時にパスワード欄を空のままにすると、保存済みの値が維持されます。
</Warning>

<Note>
  編集画面では接続先（ホスト・ポート・データベース・ユーザー）は読み取り専用で、セキュリティ設定（SSL・SSH トンネル）とパスワードのみ変更できます。
</Note>