すべてのプロダクト
Search
ドキュメントセンター

Tablestore:SQL クエリの一般的なエラーのトラブルシューティング

最終更新日:Oct 23, 2026

このトピックでは、SQL クエリの実行時に発生する OTSUnsupportOperation、OTSQuotaExhausted、OTSParameterInvalid、OtsRequestTimeout などの一般的なエラーをトラブルシューティングする方法について説明します。

OTSUnsupportOperation エラー

エラーメッセージ

説明

解決策

Operation not supported

Tablestore SQL は SQL 機能のサブセットをサポートしています。サポートされていない SQL 構文を使用すると、エラーが発生します。

Tablestore SQL でサポートされている機能のみを使用してください。

SQL 機能は頻繁に更新されます。最新の機能セットの詳細については、「サポートされているSQL機能」をご参照ください。

text_match is only supported for TEXT field in filter conditions in search index

このエラーは、フルテキストインデックス機能を使用する際に発生します。text_match 関数と text_match_phrase 関数は、検索インデックスの TEXT フィールドに対してのみ使用でき、フィルター条件に含める必要があります。

フルテキストインデックス機能を正しく使用していることを確認してください。

text_match_phrase is only supported for TEXT field in filter conditions in search index

OTSQuotaExhausted エラー

エラーメッセージ

説明

解決策

The sql scanned rows of kv exceeds the quota! Search quota is 100000 rows, table quota is 100000 rows

KV エンジンを使用したクエリで、スキャンされた行数またはデータ量が上限を超えています。

セカンダリインデックスまたは検索インデックスを使用して、データクエリを高速化できます。詳細については、「インデックス選択ポリシー」をご参照ください。

  • 検索インデックスを使用したクエリの高速化

    クエリに count、sum、avg などの集計関数、GROUP BY 句、またはプライマリキー以外の列に基づくフィルター条件が含まれている場合は、検索インデックスを作成してクエリを高速化できます。

    検索インデックスを作成した後もこのエラーが発生する場合は、検索インデックスにクエリで使用されるすべてのフィールドが含まれているかどうかを確認してください。

  • 検索インデックスが作成されていない場合は、フィルター条件にプライマリキー列が含まれており、最左一致の原則に従っていることを確認してください。また、SQL ステートメントに limit パラメーターを追加して、返される行数を制御することもできます。

説明

スキャンできる最大行数は 100,000 行です。スキャンの最大データ量は 128 MB です。スキャンのタイムアウト時間は 30 秒です。

The sql scanned rows of search exceeds the quota! Search quota is 100000 rows, table quota is 100000 rows

検索インデックスエンジンを使用したクエリで、スキャンされた行数またはデータ量が上限を超えています。

  • SQL ステートメントに limit パラメーターを追加して、返される行数を制御してください。

  • SQL ステートメントのフィルター条件を最適化して、一部の SQL 計算タスクを検索インデックスにプッシュダウンしてください。計算プッシュダウンの詳細については、「計算プッシュダウン」をご参照ください。

The sql duration time exceed the quota! Quota is 30 seconds

SQL クエリがタイムアウトしました。

セカンダリインデックスまたは検索インデックスを使用して、データクエリを高速化できます。詳細については、「インデックス選択ポリシー」をご参照ください。

  • 検索インデックスを使用したクエリの高速化

    クエリに count、sum、avg などの集計関数、GROUP BY 句、またはプライマリキー以外の列に基づくフィルター条件が含まれている場合は、検索インデックスを作成してクエリを高速化できます。

    検索インデックスを作成した後もこのエラーが発生する場合は、検索インデックスにクエリで使用されるすべてのフィールドが含まれているかどうかを確認してください。

  • 検索インデックスが作成されていない場合は、フィルター条件にプライマリキー列が含まれており、最左一致の原則に従っていることを確認してください。また、SQL ステートメントに limit パラメーターを追加して、返される行数を制御することもできます。

OTSParameterInvalid エラー

エラーメッセージ

説明

解決策

Field type mismatch, actual: STRING, expect: INTEGER, col: xxx, primary key: {"PrimaryKeys":[{"ColumnName":"xxx","Value":"xxx","PrimaryKeyOption":0}]}

データテーブルの属性列のデータ型が、SQL ステートメントの属性列のデータ型と一致しません。

Tablestore のデータテーブルはスキーマレスであり、同じ属性列に異なる型のデータを書き込むことができます。ただし、SQL は強い型付けを持ち、各フィールドには特定の型が必要です。

SQL を使用する場合、マッピングテーブルで定義されたデータ型と、データテーブルに実際に存在するデータの型が一致している必要があります。エラーメッセージの情報に基づき、マッピングテーブルのスキーマをデータの型に合わせて修正するか、データテーブル内のデータの型をスキーマに合わせて修正してください。

Table 'instancename.tablename' doesn't exist

指定されたデータテーブルまたは検索インデックスが存在しません。

Tablestore は、データテーブルのマッピングテーブルを自動的に作成しません。データテーブルまたは検索インデックスが存在することを確認してから、CREATE TABLE ステートメントを実行してマッピングを作成してください。

Table 'instancename.tablename' already exist

テーブルには、すでにマッピングが存在します。

DESCRIBE ステートメントを使用して、既存のマッピングテーブルのスキーマを表示できます。スキーマがクエリ要件を満たしていない場合は、ALTER TABLE ステートメントを使用して属性列を更新できます。詳細については、「DDL操作」をご参照ください。

Field type 'DECIMAL(11,0)' is not supported

DECIMAL データ型は SQL でサポートされていません。

SQL クエリは特定のデータ型のみをサポートしています。詳細については、「SQL データ型マッピング」をご参照ください。

Search engine: length of field value is longer than 32 for the [WILDCARD_QUERY] query

LIKE 条件の長さが 32 文字を超えています。

クエリ文字列を短くするか、フレーズ一致クエリを使用してください。詳細については、「ワイルドカードクエリを使用すると「length of field value is longer than 32 for the [WILDCARD_QUERY] query」エラーが発生する」をご参照ください。

Expression #2 of SELECT list is not in GROUP BY clause and contains nonaggregated column

GROUP BY 句を使用する場合、SELECT リスト内の列が GROUP BY 句に含まれておらず、集計関数の一部でもありません。

SQL ステートメントに集計条件を追加できます。詳細については、「データのクエリ」をご参照ください。

Offset + limit exceeds the quota! quota is 150000 rows

offset と limit の合計が最大値を超えています。limit a, b 式を使用する場合、a と b の合計は 150,000 を超えることはできません。

offset と limit の合計が 150,000 以下であることを確認してください。

Unknown column 'xxx' in field list

SQL ステートメントに、マッピングテーブルに存在しないフィールド名が含まれています。

このエラーは通常、マッピングテーブルの作成後にデータテーブルに新しいフィールドを追加したが、マッピングテーブルに新しいフィールドを追加しなかった場合に発生します。

マッピングテーブルには、クエリに必要なすべてのフィールドが含まれている必要があります。データテーブルに新しいフィールドを追加する場合は、マッピングテーブルにも新しいフィールドを追加する必要があります。詳細については、「マッピングテーブルの属性列の更新」をご参照ください。

OtsRequestTimeout エラー

エラーメッセージ

説明

解決策

Search engine: search timeout, please retry

クエリが検索インデックスにアクセスして、タイムアウトしました。

使用しているクエリ機能が、検索インデックスに事前定義されたルールを構成する必要があるかどうかを確認してください。

たとえば、ORDER BY 機能を使用するには、検索インデックスの作成時にインデックスの事前ソートを構成できます。既存の検索インデックスの事前ソート方法が要件を満たしていない場合は、スキーマの動的変更機能を使用して事前ソート方法を変更できます。