> ## 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 が列情報を提供するため、ファイルコネクタと異なりヘッダー行の選択ステップはありません。

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

## ステップ

**1. 接続・テーブル**

接続情報を入力し、`接続 & テーブル取得` で接続したうえで、テーブルまたはコレクションを選択します。

**2. データビュー・フィルタ**

プレビューを確認し、条件に合う行のみを使用するようフィルタを設定します。

**3. データマッピング**

各列に意味（必須・標準フィールド名）と詳細（任意）を指定します。

**4. 登録**

名前を入力してデータソースを登録します。

## 接続情報（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）が必要です。

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

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

## データの取得

**テーブル（SQL）**

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

**MongoDB**

コレクションを選択し、ソース方式を選びます。

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

## セキュリティ・編集

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.