次の方法で共有


SQLSTATE エラー コード

適用対象: Databricks SQL Databricks Runtime 12.2 以上

Azure Databricks によって返されるすべてのエラー クラスは、5 文字の SQLSTATE に関連付けられています。 SQLSTATE は、JDBCODBC、およびその他のクライアント API で一般的に使用されるエラー条件の SQL 標準エンコードです。

SQLSTATE は、2 つの文字クラスと 3 つの文字サブクラスの 2 つの部分で構成されます。 各文字は、'0' から '9'、または 'A' から 'Z' の 1 桁である必要があります。

SQL 標準では多くの SQLSTATE 値が規定されていますが、業界では Spark や Azure Databricks に固有のものが一般的です。

必要に応じて、Spark と Azure Databricks はカスタム SQLSTATEs に対して 'KD' クラスと 'K**' サブクラス範囲を使用します。 クラス 'XX' は、バグ報告が必要な内部エラーに使用されます。

エラー クラスの順序指定済みリストについては、「Azure Databricks でのエラー処理」を参照してください。

Azure Databricks では、次の SQLSTATE クラスを使用します。

クラス 07: 動的 SQL エラー

SQLSTATE 説明と発行されるエラー条件
07001 using 句が動的パラメータの仕様と一致しない
07501 PREPARE または EXECUTE で指定されたオプションが無効です。

クラス 08: 接続例外

SQLSTATE 説明と発行されるエラー条件
08000 接続例外
08001 SQL クライアントの SQL 接続が確立できません
08003 接続が存在しません
08004 SQL-server が SQL 接続の確立を拒否しました
08006 接続エラー
08KD1 サーバーがビジー状態です

クラス 0A: 機能がサポートされていません

SQLSTATE 説明と発行されるエラー条件
0A000 機能がサポートされていません
0A001 複数のサーバートランザクション
0AKD0 カタログまたはスキーマをまたがる操作はサポートされていません
0AKD1 セキュリティ機能はサポートされていません
0AKDC Delta ではサポートされていません
0AKDD 機能には Delta が必要です
0AKDE 機能がこの Delta テーブルに対して有効になっていません
0AKLT Delta Live で有効になっていない機能
0AKUC Unity カタログではサポートされていません
0AKUD 機能には Unity Catalog が必要です

クラス 0B: トランザクションの開始は無効です

SQLSTATE 説明と発行されるエラー条件
0B000 トランザクションの開始は無効です

クラス 0K: ハンドラーがアクティブでない場合の再通知

SQLSTATE 説明と発行されるエラー条件
0K000 ハンドラーがアクティブでない場合の再通知

クラス 0N: SQL/XML マッピング エラー

SQLSTATE 説明と発行されるエラー条件
0N000 SQL/XML マッピング エラー

クラス 21: カーディナリティ違反

SQLSTATE 説明と発行されるエラー条件
21000 カーディナリティ違反
21506 テーブルの同じ行を、複数の更新、削除、または挿入操作のターゲットにすることはできません。
21S01 挿入する値の一覧が列の一覧と一致しません

クラス 22: データ例外

SQLSTATE 説明と発行されるエラー条件
22000 データ例外
22001 文字列データの右側が切り捨てられました
22003 数値が範囲を超えています
22004 null 値は使用できません
22005 割り当てのエラー
22006 間隔の形式が無効です
22007 日時の形式が無効です
22008 日時フィールドのオーバーフロー
22009 タイム ゾーンの変位値が無効です
2200E 配列ターゲットに null 値があります
2200G 最も明確な型の不一致
2200P 間隔の値が範囲を超えています
22010 無効なインジケーター パラメーター値
22012 0 で除算
22015 間隔フィールドのオーバーフロー
22018 キャストの文字値が無効です
2201B 正規表現が無効です
2201E 自然対数の引数が無効です
22022 インジケーターオーバーフロー
22023 パラメーターの値が無効です
22024 終了されていない C 文字列
22029 UCS 文字列の非文字
22032 JSON テキストが無効です
2203G SQL JSON 項目をターゲットの種類にキャストできません
22525 パーティション分割キーの値が無効です。
22531 組み込みまたはシステム提供のルーチンの引数でエラーが発生しました。
22546 ルーチン引数の値が無効です。
22KD0 一時的なエラー
22KD1 URI またはパスが無効です
22KD2 ID 要求が未設定です
22KD3 ソースの型をターゲットの型に進化させることはできません。
22P02 無効なテキスト表現
22P03 無効なバイナリ表現

クラス 23: 整合性制約違反

SQLSTATE 説明と発行されるエラー条件
23001 制限違反
23502 挿入または更新の値が null ですが、列に null 値を含めることはできません。
23505 一意のインデックスまたは一意の制約によって課された制約の違反が発生しました。
23512 テーブルに制約定義を満たさない行が含まれているため、チェック制約を追加できません。
23K01 MERGE カーディナリティ違反

クラス 25: トランザクションの状態が無効です

SQLSTATE 説明と発行されるエラー条件
25000 トランザクションの状態が無効です

クラス 28: 承認の指定が無効です

SQLSTATE 説明と発行されるエラー条件
28000 無効な承認仕様

クラス 2B: 依存する特権記述子がまだ存在します

SQLSTATE 説明と発行されるエラー条件
2BP01 依存オブジェクトがまだ存在します

クラス 2D: トランザクションの終了が無効です

SQLSTATE 説明と発行されるエラー条件
2D521 SQL COMMIT または ROLLBACK は、現在の動作環境では無効です。
2DKD0 コミット後フックが失敗しました。

クラス 35: 無効な条件番号

SQLSTATE 説明と発行されるエラー条件
35000 無効な条件番号

クラス 38: 外部ルーチン例外

SQLSTATE 説明と発行されるエラー条件
38000 外部ルーチン例外

クラス 39: 外部ルーチン呼び出し例外

SQLSTATE 説明と発行されるエラー条件
39000 外部ルーチン呼び出し例外

クラス 3D: カタログ名が無効です

SQLSTATE 説明と発行されるエラー条件
3D000 カタログ名が無効です

クラス 3F: スキーマ名が無効です

SQLSTATE 説明と発行されるエラー条件
3F000 無効なスキーマ名

クラス 40: トランザクションのロールバック

SQLSTATE 説明と発行されるエラー条件
40000 トランザクション ロールバック (transaction rollback)

クラス 42: 構文エラーまたはアクセス規則違反

SQLSTATE 説明と発行されるエラー条件
42000 構文エラーまたはアクセス規則違反
42001 無効なエンコーダー エラー
42501 承認 ID に、特定されたオブジェクトに対して指定された操作を実行する特権がありません。
42505 接続承認エラーが発生しました。
42601 文字、トークン、または句が無効であるか、欠落しています。
42602 名前の中で無効な文字が検出されました。
42604 無効な数値または文字列の定数が検出されました。
42605 スカラー関数に指定された引数の数が無効です。
42607 集計関数または CONCAT 演算子のオペランドが無効です。
42608 VALUES または代入ステートメントで NULL または DEFAULT を使用することは無効です。
42611 列、引数、パラメーター、またはグローバル変数の定義が無効です。
42612 ステートメント文字列は、それが表示されるコンテキストでは受け入れられない SQL ステートメントです。
42613 句は相互に排他的です。
42614 キーワードまたは句の重複は無効です。
42616 無効なオプションが指定されました
42617 ステートメント文字列が空白または空です。
42621 CHECK 制約または生成された列の式が無効です。
42623 DEFAULT 句は指定できません。
42701 同じ SQL ステートメント内の割り当てに同じターゲットが複数回指定されています。
42702 名前が重複しているため、列参照があいまいです。
42703 未定義の列またはパラメーター名が検出されました。
42704 定義されていないオブジェクトまたは制約の名前が検出されました。
42710 重複するオブジェクトまたは制約の名前が検出されました。
42711 オブジェクト定義または ALTER TABLE ステートメントで重複する列名が検出されました。
42713 重複するオブジェクトがリストで検出されたか、既存のオブジェクトと同じです。
42723 同じシグネチャを持つルーチンが、定義されているスキーマ、モジュール、または複合ブロックに既に存在します。
42734 重複するパラメーター名、SQL 変数名、ラベル、または条件名が検出されました。
4274K ルーチンを呼び出すときの名前付き引数の使用法が無効です。
42802 ターゲット値の数が、ソース値の数と同じではありません。
42803 SELECT 句または HAVING 句の列参照は、グループ化列ではないため無効です。または、GROUP BY 句の列参照が無効です。
42804 CASE 式の結果式には互換性がありません。
42805 ORDER BY 句の整数は、結果テーブルの列を識別しません。
42806 データ型に互換性がないため、変数に値を割り当てることができません。
42807 このオブジェクトでは、データ変更ステートメントは許可されていません。
42808 INSERT または UPDATE 操作で識別された列は更新できません。
42809 特定されたオブジェクトが、ステートメントが適用される型のオブジェクトではありません。
42815 データ・タイプ、長さ、小数点以下桁数、値、または CCSID が無効です。
42816 式の datetime 値または期間が無効です。
42818 演算子または関数のオペランドに互換性がないか、比較できません。
42822 ORDER BY 句または GROUP BY 句の式が無効です。
42823 1 つの列のみを許可するサブクエリから複数の列が返されます。
42825 UNION、INTERSECT、EXCEPT、または VALUES の行に互換性のある列がありません。
42826 UNION、INTERSECT、EXCEPT、または VALUES の行の列数が同じではありません。
42830 外部キーは、親キーの説明に準拠していません。
42832 この操作は、システム オブジェクトでは許可されません。
42836 再帰型の名前付き派生テーブルの指定が無効です。
42837 列の属性は現在の列属性と互換性がないため、列を変更できません。
42845 NOT DETERMINISTIC または EXTERNAL ACTION 関数の無効な使用が検出されました。
42846 ソース型からターゲット型へのキャストはサポートされていません。
42852 GRANT または REVOKE で指定された特権が無効であるか、一貫性がありません。 (たとえば、ビューの GRANT ALTER)
42883 一致するシグネチャを持つルーチンが見つかりませんでした。
42887 関数またはテーブル参照は、それが発生するコンテキストでは無効です。
42891 重複する制約が既に存在します。
42893 オブジェクトまたは制約は削除、変更、または転送できないか、他のオブジェクトがオブジェクトに依存しているため、オブジェクトから権限を取り消すことはできません。
428B3 無効な SQLSTATE が指定されました。
428C4 述語演算子の両側の要素の数が同じではありません。
428EK スキーマ修飾子が無効です。
428FR 列を指定どおりに変更できません。
428FT CREATE または ALTER で指定されたパーティション分割句が無効です。
428GU テーブルには、暗黙的に非表示ではない列が少なくとも 1 つ含まれている必要があります。
428H2 データ型が、使用されているコンテキストでサポートされていません。
428HD 列マスクを適用できないか、マスクの定義がステートメントと競合するため、ステートメントを処理できません。
42902 FROM 句では、INSERT、UPDATE、または DELETE のオブジェクトも (ビューを介して暗黙的に) 識別されます。
42903 集計関数または OLAP 関数の使用法が無効です。
42908 ステートメントに、必須の列リストが含まれていません。
42939 指定された識別子がシステムで使用するために予約されているため、名前を使用できません。
42996 パーティション キーでは、指定された列を使用できません。
429BB 列、パラメーター、または SQL 変数のデータ型はサポートされていません。
429BQ データ型または属性に対して指定した変更は許可されていません。
42K01 データ型が完全には指定されていません
42K02 データ ソースが見つかりません
42K03 ファイルが見つかりません
42K04 ファイルが重複しています
42K05 名前が有効ではありません
42K06 オプションの型が無効です
42K07 有効なスキーマ リテラルではありません
42K08 定数ではありません
42K09 データ型が一致していません
42K0A 無効な UNPIVOT 句
42K0B レガシ機能がブロックされています
42K0C 制約への参照があいまいです
42K0D 無効なラムダ関数
42K0E 使用されているコンテキストで有効な式ではありません
42K0F 永続化されたオブジェクトでは一時オブジェクトを参照できません。
42K0G protobuf が無効です
42K0H サイクリック呼び出しが検出されました。
42K0I SQL 構成が見つかりません。
42K0K 無効な逆分布関数
42K0L ラベルの使用が無効です。
42K0M 変数宣言が無効です。
42K0N 無効な外部の型。
42K0O ScalarFunction は、カスタム実装でメソッド 'produceResult(InternalRow)' をオーバーライドしません。
42K0P ScalarFunction は、メソッド 'produceResult(InternalRow)' を実装またはオーバーライドしません。
42K0Q ハンドラー宣言が無効です。
42K0R 無効な条件宣言です。
42K10 動的オプションが無効です。
42KD0 あいまいな名前の参照。
42KD1 操作が読み取り専用セッション モードではサポートされていません。
42KD2 SYNC オペレーションのソース テーブル名とターゲット テーブル名は同じである必要があります。
42KD3 列を指定どおりに追加できません。
42KD4 テーブル スキーマが変更されたため、操作はサポートされません。
42KD5 ファイルまたはパスを作成できません。
42KD6 パーティション情報が見つかりません。
42KD7 テーブル シグネチャの不一致。
42KD8 列の位置が範囲外です。
42KD9 テーブル スキーマを推論できません。
42KDA ファイルのテーブル スキーマへのマージに失敗しました。
42KDB 無効な URL
42KDC アーカイブされたファイルの参照。
42KDD ストリーミング ビューでサポートされていない操作。
42KDE ストリーミング データセットでサポートされていない操作。
42KDF 必須のルーチン パラメータに引数がありません。
42KDG ターゲット スキーマは、取り込まれたデータと互換性がありません。
42KDH サービスをフィルター処理するためのソースが無効です。
  • フィルタリングサービス統合コマンドの無効なソース
42P01 未定義のテーブル
42P02 未定義のパラメータ
42P06 重複するスキーマ
42P07 重複するテーブル
42P08 あいまいなパラメーター
42P10 無効な列参照
42P18 不確定なデータ型
42P20 ウィンドウ化エラー
42P21 照合順序の不一致
42P22 不確定な照合順序
42S22 列が見つかりません
42S23 パーティション変換式が 'partitionedBy' にない

クラス 44: WITH CHECK OPTION 違反

SQLSTATE 説明と発行されるエラー条件
44000 WITH CHECK OPTION 違反

クラス 46: Java DDL 1

SQLSTATE 説明と発行されるエラー条件
46103 未解決のクラス名
46110 サポートされない機能
46121 列名が無効です

クラス 51: 無効なアプリケーション状態

SQLSTATE 説明と発行されるエラー条件
51000 無効なアプリケーションの状態
51024 オブジェクトは動作不能としてマークされているため、使用できません。

クラス 53: リソース不足

SQLSTATE 説明と発行されるエラー条件
53000 リソースが不足している
53200 メモリ不足

クラス 54: プログラムの制限を超えました

SQLSTATE 説明と発行されるエラー条件
54000 プログラムの制限を超えました
54001 ステートメントが長すぎるか、複雑すぎます。
54006 結果文字列が長すぎます。
54011 テーブル、ビュー、またはテーブル関数に指定された列が多すぎます。
54023 引数が多すぎます
54K00 入れ子になったビューの最大深度を超えました。
54KD0 クエリ プランの最大 UDF 数を超えました。
54KD1 セッション内のオブジェクトの最大数を超えました。

クラス 55: オブジェクトが前提状態にありません

SQLSTATE 説明と発行されるエラー条件
55000 オブジェクトが前提条件の状態ではない
55019 オブジェクトが操作に対して無効な状態です。

クラス 56: その他の SQL または製品エラー

SQLSTATE 説明と発行されるエラー条件
56000 その他の SQL または製品エラー
56038 要求された機能は、この環境ではサポートされていません。
56098 暗黙的な再バインド、再コンパイル、または再検証中にエラーが発生しました。
56K00 Spark Connect エラー

クラス 57: オペレーターの介入

SQLSTATE 説明と発行されるエラー条件
57000 オペレーターの介入
57012 データベース以外のリソースは使用できません。 これは、後続のステートメントの正常な実行には影響しません。
57KD0 クエリ実行のタイムアウト

クラス 58: システム エラー

SQLSTATE 説明と発行されるエラー条件
58000 システム エラー
58030 I/O エラーです

クラス 82: メモリ不足

SQLSTATE 説明と発行されるエラー条件
82001 集計に十分なメモリがない
82002 ポインター配列を拡張するのに十分なメモリがありません
82003 spill() の呼び出し中にエラーが発生しました
82100 メモリ不足 (割り当てできませんでした)

クラス F0: 構成ファイル エラー

SQLSTATE 説明と発行されるエラー条件
F0000 構成ファイル エラー

クラス HV: FDW 固有の条件

SQLSTATE 説明と発行されるエラー条件
HV000 FDW 固有の条件
HV091 無効な記述子フィールド識別子

クラス HY: CLI 固有の条件

SQLSTATE 説明と発行されるエラー条件
HY000 CLI 固有の条件
HY008 操作が取り消されました
HY109 カーソル位置が無効です

クラス KD: データソース固有のエラー

SQLSTATE 説明と発行されるエラー条件
KD000 データソース固有のエラー
KD001 ファイルのフッターを読み取ることができません
KD002 予期しないバージョン
KD003 データ型へのアクセスが正しくありません
KD004 デルタ プロトコルのバージョン エラー
KD005 テーブルには、少なくとも 1 つの非パーティション列を含める必要があります
KD006 ログ パスにコミットが見つかりません
KD007 テーブル シグネチャの変更
KD008 テーブル シグネチャが設定されていません
KD009 パーティションが一致しません
KD00A 予期しない部分スキャン
KD00B 認識されないファイル
KD00C バージョンが連続していません
KD00D 統計が必要です
KD00E テーブル機能の検証エラー
KD00F クラウド要求エラー
KD010 外部データ ソースのエラー
KDL01 クラスター起動エラー

クラス P0: 手続き型論理エラー

SQLSTATE 説明と発行されるエラー条件
P0001 例外の発生