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

# 制限とエラー

できないこと、数値の読み方、数や大きさの上限、エラーの対処をまとめます。

## できないこと

* コンテンツの作成、編集、公開、削除
* 公開時と違うパラメータの値での、チャートやアナリティクスの再計算
* Exploratory Server に公開されていないものの読み取り。Exploratory Desktop の中だけにあるプロジェクトなどです。これらには、別の Desktop MCP を使います。

## 数値と計算の条件

* 数値は、公開されたときの値です。
* チャート単体で公開したものは、描画に使ったデータの先頭 100 行だけを返すので、合算して合計として扱わないでください。
* ブラウザで閲覧者がパラメータを変えた結果は、MCP からは取得できません。
* チャートとアナリティクスの結果には、集計方法、チャートのフィルタ、context.parameters、context.data\_as\_of が含まれます。
* query\_dataset は、dataset.version と dataset.updated\_at を返します。

## 数や大きさの上限

| 項目 | 上限 |
| - | - |
| query\_dataset: rows | 最大 1,000 行（columns の指定が必要） |
| query\_dataset: aggregate | 最大 500 行 |
| dataframe\_preview、chart\_get\_data | 1 回に 100 行まで |
| query\_dataset: queries | 1 回に 5 件まで |
| chart\_query: queries | 1 回に 10 件まで（既定値です。オンプレミス環境では変更できます） |
| 結合するデータ | 2〜5 件 |
| 集計項目の alias | 半角の英字か \_ で始め、半角の英数字と \_ だけ。日本語は不可 |
| 結合で使うデータの alias | 小文字で 16 文字まで |
| dataframe\_export | リンクの有効期間は 15 分。1 ユーザーが同時に実行できる書き出しは 1 つ。1 時間あたりの回数にも上限があります |
| チャート単体で公開したもの | チャート全体の値ではなく、描画に使ったデータの先頭 100 行 |

## エラーの一覧と対処

失敗した道具は、isError: true の結果を返します。本文は、error\_code と message を持つ JSON で、場合により url と details も持ちます。引数の誤りでは、details.field がその引数を示します。

| error\_code | 対処 |
| - | - |
| NOT\_FOUND | コンテンツが存在しないか、閲覧する権限がありません。対象の URL をブラウザで開き、同じアカウントで閲覧できるか確認します。閲覧できないときは、所有者に共有設定の確認を頼みます |
| CHANNEL\_DISABLED | 公開した人がこのコンテンツの MCP アクセスを止めています。公開した人に、コンテンツの MCP アクセスの設定の確認を頼みます |
| DATA\_EGRESS\_LIMIT | 公開した人がこのデータの行を共有していません。チャート・アナリティクス・要約を使います |
| PERSONALIZED\_CONTENT | 閲覧者ごとに違うデータを表示するコンテンツです。URL をブラウザで開いてください |
| CONTENT\_UPDATING | 再公開の途中です。数秒後にもう一度試してください |
| UNSUPPORTED\_OPERATION | この方法では読めないコンテンツです（問い合わせできるデータソースがないデータなど）。そのコンテンツで使える操作を確認し、チャートや要約など、使える形での取得を AI に頼みます |
| INVALID\_PARAMETER | details.field が示す引数を直します |
| RESULT\_TOO\_LARGE | 結果が大きすぎます。絞り込むか、列を減らすか、集計します |
| SERVER\_BUSY | サーバーが混み合っているか、自分の別の書き出しが実行中か、1 時間あたりの書き出しの上限に達しています。下の説明を参照してください |

SERVER\_BUSY のとき:

* 数秒おいて再度呼び出します。
* 2 回続いたら、繰り返さずに時間をおきます。
* 書き出しの上限の場合は、最大 1 時間待ちます。

query\_dataset は、問い合わせの誤りを別の形で返します。error.code、error.message、error.field を持ち、独自のコードを使います。例:

* DATASET\_NOT\_FOUND
* ACCESS\_DENIED
* CHANNEL\_DISABLED
* DATASET\_ACCESS\_DENIED（結合時）
* DATASET\_NOT\_QUERYABLE
* INVALID\_COLUMN
* INVALID\_FILTER
* AMBIGUOUS\_COLUMN
* JOIN\_TYPE\_MISMATCH
* QUERY\_LIMIT\_EXCEEDED
* QUERY\_TIMEOUT

問い合わせが混み合っているときは、RATE\_LIMIT\_EXCEEDED か QUERY\_ENGINE\_UNAVAILABLE が返るので、数秒おいて再度呼び出します。result.has\_more が true なら、絞り込むか、集計するか、dataframe\_export を使います。

dataframe\_export は、ほかの道具と同じ error\_code の形式です。問い合わせの誤りは INVALID\_PARAMETER で返り、元のコードは details.code に含まれます。

## 回数の上限

1 人の利用者が 1 分間に 120 回を超えて要求すると、HTTP 429 と RATE\_LIMITED が返ります。1 分待ってください。

同じアドレスから（IPv4 は同じアドレス、IPv6 は同じ /64 の範囲で数えます）、15 分のうちに 30 回を超えて、拒否された API キーが送られると、「Too many failed API key attempts. Try again later.」というメッセージつきの HTTP 429 になります。有効なキーは数えません。キーを直して、しばらくしてからやり直します。


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