---
title: "クエリ集を管理する | COMETA Docs"
slug: "query-collection"
updated: 2026-05-25T00:10:01Z
published: 2026-05-25T00:10:01Z
canonical: "documents.trocco.io/query-collection"
---

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

# クエリ集を管理する

## 概要

**クエリ集**は、組織内で検証済みのSQLクエリを一元管理し、共有するための機能です。 登録されたクエリはAIチャットも参照でき、SQL生成の精度向上に貢献します。

![](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/query-collection-2026-04-08-19-34-04.png)

クエリ集機能は、以下のように活用できます。

### 認証済みクエリを組織の資産として蓄積・共有する

分析で作成したSQLクエリを組織のナレッジとして登録し、チーム全体で活用できます。

### AIチャットが検証済みクエリを参照し、より正確なSQLを生成する

AIチャットでSQL生成を依頼すると、クエリ集に登録された関連クエリを自動で参照します。 参照元のクエリがAI回答内に表示されるため、生成されたSQLの信頼性を向上できます。

### キーワード検索やフィルタリングで必要なクエリを素早く見つける

キーワード検索やフィルタリングにより、必要なクエリを素早く見つけられます。

## 管理できる情報

クエリ集に、クエリとして登録できる情報は以下のとおりです。

| 項目 | 説明 |
| --- | --- |
| クエリ名 | クエリの名称を登録します。 |
| 認証ステータス | クエリの品質を管理するための仕組みです。 - 未認証：編集中や信頼性の低いクエリに利用します。デフォルトでは未認証の状態です。 - 認証済: データアナリストの確認などを経た、信頼性の高いクエリに設定します。 |
| AI検索対象 | クエリ単位で、AIチャットの参照対象にするかどうかを制御できます。AIの回答内に参照したクエリへのリンクが表示されます。 デフォルトはONです。OFFにすると、AIチャットがそのクエリを参照しなくなります。 AIチャット機能の詳細は、[【COMETA AI】対話型AIアシスト機能](/cometa/docs/ai-assist)を参照してください。 |
| 説明 | クエリの説明を登録します。 |
| クエリ | 管理するSQLクエリを登録します。 SQLエディタの`{}`ボタンをクリックすると、カーソル位置に`{{ variable }}`を挿入できます。また、`{{ }}`でクエリ内の文字列を囲むことで、対象の文字列を変数として定義できます。 変数を定義すると、SQLエディタ上部に変数入力フィールドが表示され、値を入力してからクエリを実行できます。 |
| 実行環境 | クエリの実行環境を選択します。実行環境を選択すると、クエリ詳細画面から直接クエリを実行できます。 選択してデータストアが削除された場合、関連付けは自動で解除されます。 |

## 操作手順

              操作権限について

              

クエリの作成・編集・削除には、アカウント特権管理者またはメタデータ編集者のロールが必要です。 詳しくは、[操作権限](/cometa/docs/query-collection#%E6%93%8D%E4%BD%9C%E6%A8%A9%E9%99%90)を参照してください。

### クエリの登録

1. クエリ一覧画面で**クエリを登録**をクリックします。
2. [管理できる情報](/cometa/docs/query-collection)を入力します。 クエリの登録前に、実行環境を選択してクエリの実行も可能です。
3. **保存**をクリックし、クエリを登録します。

### クエリの編集

1. クエリ詳細画面で**編集**をクリックします。
2. 必要な項目を変更します。
3. 保存します。

### クエリの検索

![](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/query-collection-2026-04-08-19-35-12.png)

- クエリ一覧画面で、キーワード検索欄にクエリ名、説明、SQL本文を入力して検索します。
- 以下の条件でフィルタリングも可能です。
  - 承認ステータス
  - 作成者

              
              

過去にクエリエディタで保存した**保存したクエリ**は、クエリ集に統合されました。 認証ステータスは**未認証**、AI検索対象は**OFF**で統合されています。

### クエリの削除

1. クエリ詳細画面で**削除**をクリックします。
2. 確認ダイアログで**削除**をクリックします。

## 操作権限

既存のCOMETAロール体系に基づいて操作権限を制御します。

| 操作 | アカウント特権管理者 | メタデータ編集者 | その他のユーザー |
| --- | --- | --- | --- |
| クエリ一覧・詳細の閲覧 | ✓ | ✓ | ✓ |
| クエリの作成 | ✓ | ✓ | - |
| クエリの編集 | ✓ | ✓ | - |
| クエリの承認 | ✓ | ✓ | - |
| クエリの削除 | ✓ | ✓ | - |

              閲覧権限について

              

クエリの閲覧は全ユーザーが可能です。組織のナレッジ共有を促進するため、ロールに関わらず閲覧できます。