> Source: https://clickhouse.github.io/loom/ja/reference/operations/insights/ (Markdown: https://clickhouse.github.io/loom/ja/reference/operations/insights.md)

<!-- i18n: source=docs/reference/operations/insights.md blob=e9bec66357b14346f32afbb1ad6f0a50b74bb290 model=claude-sonnet-5-5 -->
> このページは[英語の原文](https://clickhouse.github.io/loom/reference/operations/insights/)の機械翻訳です。内容は英語の原文が優先されます。
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/insights/), which is authoritative.

<a id="insights-operations"></a>

# `insights` オペレーション

各 `insights.*` オペレーションが受け取るフィールドと返すフィールドの正確な一覧です。

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

すべてのオペレーションは、HTTP では `POST /v1/<op>`、MCP ツールでは `loom_<op>` として呼び出せます。アイデンティティのフィールド（`org`、`namespace`、`agent`、`user_id`、`session_id`）は、トランスポートが対応している場合、トークンと MCP セッションから補完されます。シングルユーザーサーバーでトークンなしの HTTP 呼び出しを行う場合は、`code.*` と `tracker.*`（それぞれのプレーンの値を保持します）を除くすべてのオペレーションで、インストールの org が使われます。[一部のオペレーション](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)では、名前空間とエージェントも補完されます。詳しくは[アイデンティティと名前空間](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)を参照してください。ロール、種別、MCP の `all` 一覧については、[オペレーション索引](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)で説明しています。未知の入力フィールドは受け付けられ、`ignored_args` に名前が示されます。

<!-- prettier-ignore-start -->

<a id="insightscatalog"></a>

## `insights.catalog`

`insights.query` が読み取れるテーブルを一覧します。各カラムの型と意味、テーブルの正しい読み方（キーごとに有効な行が 1 つか、イベントごとに 1 行か）、およびステートメントの実行時の上限を返します。

`POST /v1/insights.catalog` · MCP `loom_insights_catalog` · ロール `viewer` · 読み取り · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（アイデンティティタプルの最初の要素）。 |
| `namespace` | `str` | 必須 | オペレーションが読み書きする名前空間。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `tables` | `list[CatalogTable]` | insights.query が読み取るテーブル。カラムと読み方を含みます。 |
| `max_result_rows` | `int` | 1 つのステートメントが返す最大行数。超えた分は切り捨てられます。 |
| `max_execution_s` | `float` | 1 つのステートメントが ClickHouse に停止されるまでに実行できる最長時間（このレプリカの上限。ロール中は、保存されている上限プロファイルと異なる場合があります）。 |
| `max_rows_to_read` | `int` | 1 つのステートメントが読み取れる最大行数。超える場合は時間またはキーのフィルターを追加してください。 |

<a id="insightsquery"></a>

## `insights.query`

`insights.catalog` が一覧するテーブルに対して、読み取り専用の SQL SELECT（または WITH）を 1 つ実行します。ほかの読み取りでは答えられない質問、たとえばメモリ、競合、利用状況、ドキュメント、そして…

`POST /v1/insights.query` · MCP `loom_insights_query` · ロール `viewer` · 読み取り · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（アイデンティティタプルの最初の要素）。 |
| `namespace` | `str` | 必須 | オペレーションが読み書きする名前空間。 |
| `sql` | `str` | 必須 | insights.catalog が一覧するテーブルに対する SELECT または WITH ステートメント 1 つ。この名前空間の行だけを読み取ります。 |
| `limit` | `int` | `100` | 返す最大行数（デフォルトは 100）。デプロイメントの上限（LOOM_CH_ANALYSIS_MAX_RESULT_ROWS）がこれより小さい場合は、その上限が優先されます。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `columns` | `list[AnalysisColumn]` | ステートメントの結果カラム。それぞれ ClickHouse の型を持ちます。 |
| `rows` | `list[list[Any]]` | 行ごとに 1 つのリスト。`columns` の順に並びます。日付、UUID、小数は文字列です。 |
| `row_count` | `int` | `rows` に含まれる行数。最大でも `limit` です。 |
| `truncated` | `bool` | `limit` より多くの行が一致しました。ステートメントを絞り込むか、集計してください。 |
| `sql_digest` | `str` | リクエスト台帳が `sql` について記録するダイジェスト（`sha256:<hex>/<length>`）。ステートメントの引用はこの値と照合されます。 |

<!-- prettier-ignore-end -->
