できないこと
- コンテンツの作成、編集、公開、削除
- 公開時と違うパラメータの値での、チャートやアナリティクスの再計算
- Exploratory Server に公開されていないものの読み取り。Exploratory Desktop の中だけにあるプロジェクトなどです。これらには、別の Desktop MCP を使います。
数値と計算の条件
- 数値は、公開されたときの値です。
- チャート単体で公開したものは、描画に使ったデータの先頭 100 行だけを返すので、合算して合計として扱わないでください。
- ブラウザで閲覧者がパラメータを変えた結果は、MCP からは取得できません。
- チャートとアナリティクスの結果には、集計方法、チャートのフィルタ、context.parameters、context.data_as_of が含まれます。
- query_dataset は、dataset.version と dataset.updated_at を返します。
数や大きさの上限
エラーの一覧と対処
失敗した道具は、isError: true の結果を返します。本文は、error_code と message を持つ JSON で、場合により url と details も持ちます。引数の誤りでは、details.field がその引数を示します。
SERVER_BUSY のとき:
- 数秒おいて再度呼び出します。
- 2 回続いたら、繰り返さずに時間をおきます。
- 書き出しの上限の場合は、最大 1 時間待ちます。
- 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
