> ## 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.

# データソース管理

> AI Skill が読み込む外部データを接続・設定する画面です。

## データソースとは

データソースは、[Skill Store](/ja/agent/skill-store) の AI Skill が分析に使用する**外部データへの接続と設定**です。
データを OneS1ght にコピーするのではなく、**接続情報と設定（列・型・フィルタ・マッピング）のみを保存**し、クエリ時にこの設定を適用してデータを派生します。
ファイルコネクタは元データをソースとして保管し、DB・API コネクタはクエリのたびにライブで読み込みます。

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

## 3 つのコネクタ系列

データソースは、元データの形態に応じて 3 つのコネクタ系列のいずれかで接続します。

<CardGroup cols={3}>
  <Card title="ファイル" icon="file-lines" href="/ja/agent/connectors/file">
    CSV・JSON・Excel ファイルをアップロードします。元データは登録時に保管されます。
  </Card>

  <Card title="データベース" icon="database" href="/ja/agent/connectors/database">
    PostgreSQL・MySQL・MS-SQL・Oracle・MongoDB に接続し、クエリ時にライブで読み込みます。
  </Card>

  <Card title="サービス（API・OData）" icon="plug" href="/ja/agent/connectors/api">
    HTTP API または OData サービスをクエリ時にライブで呼び出します。
  </Card>
</CardGroup>

<Note>
  外部サービス連携（SaaS など）は「準備中」で、次の反復で追加されます。
</Note>

## 一覧画面

`+ データソース追加` ボタンでウィザードを開き、行をクリックすると詳細画面に移動します。
一覧は検索、コネクタフィルタ、並び替え（最新順・古い順・タイトル ↑・タイトル ↓）、ページネーション（8 件）に対応します。

| 列    | 説明                 |
| ---- | ------------------ |
| 名前   | データソースのタイトル        |
| コネクタ | 接続系列（ファイル・DB・サービス） |
| 列    | マッピングされた列数         |
| 行    | 行数                 |
| フィルタ | 適用されたフィルタ数         |
| 作成日時 | 登録時刻               |
| 最終更新 | 最終更新時刻             |

## 共通ウィザード 4 ステップ

すべてのコネクタは共通の 4 ステップに従います。ファイル・API コネクタは形式に応じて前段にステップが追加されます（各コネクタページを参照）。

<Steps>
  <Step title="コネクタ選択">
    ファイル・データベース・サービスから、元データに合ったコネクタを選びます。
  </Step>

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

  <Step title="データマッピング">
    各列に\*\*意味（必須・標準フィールド名）**と**詳細（任意）\*\*を指定します。`✨ AI 自動マッピング`を利用できます。
  </Step>

  <Step title="登録">
    名前を入力し、設定内容を確認してデータソースを登録します。
  </Step>
</Steps>

### フィルタ演算子

<CardGroup cols={2}>
  <Card title="等しい (=) · 等しくない (≠)">文字列/数値の一致比較</Card>
  <Card title="含む">部分文字列を含む</Card>
  <Card title="より大きい (>) · より小さい (<)">数値比較</Card>
  <Card title="空でない">値が存在する行のみ</Card>
</CardGroup>

複数の条件はすべて満たす（AND）行のみが使用されます。

### 列の型

文字列・数値・真/偽・日付・オブジェクト(JSON)

## 詳細画面

詳細画面では次を表示します。

* **設定**: コネクタ、元データ、ヘッダー行、フィルタ、行数。ファイルは「元データ保管」、DB・API は「ライブソース」と表示されます。
* **列・マッピング表**: 列名・型・意味・詳細。
* **AI Skill 送信アウトプット**: 実際に AI Skill（LLM）に渡される形式 — メタデータ（スキーマ・意味）とデータ（最大 100 行）。テーブルビュー / JSON タブ。

## 認証情報のセキュリティ

<Warning>
  データベースのパスワードや API キー・ヘッダーなどの認証情報は **AES-256-GCM で暗号化**して保存され、**クライアントには返されません。**
  データソースを編集する際、認証情報欄を空のままにすると既存の値が維持されます。
</Warning>

<Note>
  データソースを編集しても\*\*元データは変更されません。\*\*設定（列・型・フィルタ・マッピング）のみが変わります。
</Note>