--- title: "クエリ集を管理する | COMETA Docs" slug: "query-collection" updated: 2026-09-03T01:28:40Z published: 2026-09-03T01:28:40Z 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ロール体系に基づいて操作権限を制御します。 | 操作 | アカウント特権管理者 | メタデータ編集者 | その他のユーザー | | --- | --- | --- | --- | | クエリ一覧・詳細の閲覧 | ✓ | ✓ | ✓ | | クエリの作成 | ✓ | ✓ | - | | クエリの編集 | ✓ | ✓ | - | | クエリの承認 | ✓ | ✓ | - | | クエリの削除 | ✓ | ✓ | - | 閲覧権限について クエリの閲覧は全ユーザーが可能です。組織のナレッジ共有を促進するため、ロールに関わらず閲覧できます。