WELエラーコード
WELエラーには安定したコードが含まれます。エラーメッセージが変更または翻訳されても、コードは同じままです。エラーの検索、アラートの設定、またはサポートリクエストへの記載にコードを使用します。
_ は、これらの例で式が受け取る入力です。詳細については、入力変数を参照してください。
エラーコードは次のカテゴリに分類されます。
| カテゴリ | 範囲 | 説明 |
|---|---|---|
| 解析および静的分析 | E001~E027 | 式自体の形式が不正です。キャッチできません。 |
| 型エラー | E100~E108 | 値が操作に必要な型ではありません。キャッチ可能です。 |
| ランタイムエラー | E200~E230 | データが不正、欠落、または範囲外です。キャッチ可能です。 |
| ホストエラー | E300~E301 | 明示的なHostFx呼び出しが解決されなかったか、失敗しました。キャッチ可能です。 |
| 停止 | E400~E401、E450 | ホストが全体の処理を停止しました。キャッチできません。 |
| スキーマエラー | E500~E503 | 式の出力が、ホストが宣言したスキーマと一致しません。これは式の評価後に実行されるため、|?では捕捉されません。 |
ファミリの識別
エラーファミリはエラーの発生元を示します。
E0xx: 式はすべての入力に対して不正であり、解析できないスクリプトからは何も復旧できないため、キャッチできません。これらはプロダクションではなく、式の記述中に表面化します。E1xxおよびE2xx: 式自体は有効ですが、この特定のレコードの形状が想定どおりではありません。たとえば、フィールドが欠落している、数値であるべき場所に文字列がある、などです。これらはプロダクションで最も表面化しやすいエラーであり、多くの場合、通常は正常に実行されるバッチの途中で発生します。これらはキャッチ可能なため、何を行うかを決定できます。E3xx: 式自体は有効ですが、明示的なHostFx呼び出しが解決されなかったか、失敗しました。どちらも捕捉可能なので、ホスト連携が式の要求どおりの値を返さなかった場合にどうするかを制御できます。E4xx: 制限に達したかホストサービスが失敗したため、ホストが処理を停止しました。これらのエラーはいずれも捕捉できません。E5xx: ホストが宣言したスキーマに、式の結果が従っていません。これらのエラーは式の実行後に結果をスキーマと照合するときに発生するため、|?では捕捉されません。スキーマエラーを参照してください。
キャッチ可能性
try-fallback演算子|?は、キャッチ可能なエラーをキャッチし、代わりにフォールバックを返します。捕捉不能エラーは伝播します。
_.customer.email |? 'unknown'
Integer(_.qty) |? 0|?と|の比較
|?と|の違いは非常に重要であり、ここで混同するとよく混乱の原因になります。
| Operator | 処理する対象 | 処理しない対象 |
|---|---|---|
| | null値 | エラー |
|? | エラー | 該当なし |
存在しないフィールドを読み取るとE104が発生します。これはnullを生成しないため、|では保護されません。
_.customer.nickname | 'none' // still raises E104
_.customer.nickname |? 'none' // returns 'none'キーが存在し、その値がnullまたは空白になる可能性がある場合は、通常、あらゆる種類の欠如をnullに正規化するpresenceとともに|を使用します。
presence(_.display_name) | 'Unknown'形状自体が異なる可能性がある場合は|?を使用します。
フォールバックは判断であり、修正ではありません
|? 0を通貨フィールドで使用すると、不正な形式の金額が気づかれずに0になり、ジョブは成功として報告されます。それが正しい場合もあれば、誤った請求書が気づかれずに送信される場合もあります。
欠落が想定され、デフォルト値が本当に正しい場合にのみ、フォールバックを使用してください。そうでない場合は、エラーを伝播させてください。失敗したジョブは目に見えますが、誤った数値は目に見えません。
解析および静的分析エラー
WELは評価が開始される前にこれらのエラーを発生させます。これらはすべての入力で発生し、キャッチできません。
| コード | メッセージ | 解像度 |
|---|---|---|
E001 | スクリプトには、ランタイムがサポートするより新しいWELバージョンが必要です | 式で、このエンジンにない機能が使用されています。エンジンバージョンを確認します。 |
E002 | 予期しないトークン | メッセージ内のキャレット(^)は問題のあるトークンを指し示します。その位置の構文エラーを修正します。 |
E003 | 終了していない文字列リテラル | 引用符('または")を閉じるか、アポストロフィを\'でエスケープするか、二重引用符に切り替えるか、\n/\rや三重引用符形式('''...'''または"""...""")を使用して改行を直接含めます。 |
E004 | 無効な数値リテラル | 余分な区切り文字または不正な形式の指数がないか確認します。 |
E005 | 無効なバイナリリテラル | 0x"..." リテラルには16進数の桁だけを使用します。 |
E006 | 予期しない入力の終わり | 閉じ忘れがないか確認します。かっこ([)、丸かっこ(()、または本体のないdoなどです。 |
E007 | 無効な正規表現 | パターンがECMAScript正規表現構文に従っていることを確認します。このエラーは、式内に直接記述されたパターンに対して発生します。パターンが実行時にデータから構築される場合はE213を参照してください。 |
E008 | Binary()に非ASCII文字を含めることはできません | 代わりに、明示的なエンコーディングを指定してencode_stringを使用します。 |
E009 | 変数はすでに定義されています | 内側のバインディングの名前を変更します。 WELではシャドーイングは許可されていません。 |
E010 | 未定義の変数 | タイプミスがないか、あるいはそれを束縛するletの外側で名前を使用していないか確認します。 |
E011 | 未定義の関数 | 関数名については標準ライブラリを確認するか、タイプミスを修正します。 |
E012 | 引数の数が正しくありません | 関数のリファレンスエントリにあるシグネチャを確認します。 |
E013 | 無効なロケール設定 | アクションのロケール設定を確認します。 |
E014 | 式のネストが深すぎます | 式をletバインディングに分割します。 |
E015 | 識別子が長すぎます | 名前をNFC正規化後に64個以下のUnicodeスカラ値になるよう短くします。 |
E016 | 無効な形式指定 | f-stringまたはformat関数の形式文字列を確認します。 |
E017 | 無効なhostfx参照 | ホスト関数参照の構文を確認します。 |
E018 | HostFx名前空間は許可されていません | このコンテキストで許可されている名前空間を確認します。 |
E019 | 数値リテラルが長すぎます | 桁数を減らすか、値をStringとして読み取って変換します。 |
E020 | コンストラクタの定数が無効です | リテラルをコンストラクタが受け付ける形式に合わせます。たとえば、Duration('P1D')は、DurationがPT24Hのような時計時間の継続時間のみを受け付けるため、このエラーを送出します。また、IntegerまたはDecimalのリテラルや定数が、1024バイトの絶対値上限を超えた場合にも発生します。詳細については、データ型を参照してください。 |
E021 | 式が大きすぎます | 式を複数のステップに分割します。 |
E022 | リテラル内のキーの衝突 | 重複したキーを削除するか、名前を変更します。 |
E023 | Skipは呼び出したりパイプで入力したりできません | Skip()ではなくSkipを書き、|、|?、>>の左側としては使用しないでください。 |
E024 | この識別子位置では使用できない文字です | 不要な記号や、エディタの外からコピーされた文字が含まれていないか確認します。 |
E025、E026、E027は警告です。これらは式を停止せず、結果と一緒に報告されます。
| コード | メッセージ | 解像度 |
|---|---|---|
E025 | 識別子に一般的でない文字が含まれている | 名前にゼロ幅文字 (ZWNJ/ZWJ など) または、NFKC 正規化によって変化する互換文字 (全角文字や数学用太字文字など) が含まれています。警告を抑制するには、英数字およびアンダースコアのみを使用して名前を付け直します。 |
E026 | 識別子に混在スクリプトの紛らわしい文字が含まれている | 名前に、ラテン文字とキリル文字のような見た目の似た文字体系が混在しており、キュレートされた紛らわしい文字(たとえばаdmin内のキリル文字のа)が使われています。識別子ごとに単一の文字体系のみを使用します。 |
E027 | 識別子同士が見た目で紛らわしい | 同じスコープ内で有効な名前が、ラテン文字のaとキリル文字のаのように、キュレートされた同一の視覚スケルトンを共有しています。見た目で区別しやすいように名前を付け直します。 |
型エラー
WELは、値が操作に必要な型でない場合にこれらのエラーを発生させます。すべての型エラーはキャッチ可能です。
WELは、関数または演算子を満たすために引数を自動的に強制変換しません。入力型が必要な型と一致しない場合は、値を明示的に変換します。詳細は変換関数を参照してください。
| コード | メッセージ | 解像度 |
|---|---|---|
E100 | 型の不一致: 1つの型が想定されましたが、別の型が渡されました | 型を明示的に変換するか、and、or、not、およびif条件にはBool(またはNull/Skip)のみが渡されるようにします。 |
E101 | これらの型では演算子がサポートされていません | 両方のオペランドを確認し、どちらか一方を変換します。 |
E102 | ある型を別の型にキャストできません | 値がコンストラクタが受け付ける形式になっていません。値をクリーンアップするか、|?を使用してデフォルト値を指定します。 |
E103 | DecimalとFloatの精度が混在しています | 両側を同じ型にします。詳細については、データ型を参照してください。 |
E104 | この型ではフィールドにアクセスできません | フィールドが欠落しているか、値がMapではありません。デフォルトにはhas_key?または|?を使用します。 |
E105 | Lambdaが異なる数の引数を想定しています | ラムダのパラメータが、高階関数から渡される引数と一致しているか確認します。たとえば、Map に対する filter_by は、1 つではなくキーと値の 2 つの引数を渡します。 |
E106 | 関数が異なる数の引数を想定しています | シグネチャを確認します。 |
E107 | ここではLambdaを値として使用できません | ラムダを、ラムダを受け取る関数に渡します。ラムダは引数としてのみ有効であり、単独の値としては使用できません。 |
E108 | この型ではサポートされていない演算子です | その演算子を削除するか、オペランドをサポート対象の型に変換します。 |
E103は金額に関するものです
DecimalとFloatは混在できません。暗黙の混在は、Decimalを使用する価値である正確性を損ないます。 Floatが計算に入ると結果は近似値になり、下流ではそれを判別できません。
合計でE103が発生した場合の一般的な対処方法は、DecimalをFloatに変換するのではなく、もう一方のオペランドをDecimalにすることです。
レシピではデフォルトで混合精度が有効になります
Transform dataアクションには、DecimalとFloatを混在できるかどうかを設定するMixed precisionフィールドがあります。このフィールドのデフォルトはallowです。つまり、フィールドをdenyに設定しない限り、レシピアクションではE103は発生しません。
ランタイムエラー
WELは、入力値を処理できない場合に評価中にこれらのエラーを発生させます。すべてのランタイムエラーはキャッチ可能です。
データの形状とアクセス
データが操作で想定される形状または値を持たない場合、次のエラーが発生します。
| コード | メッセージ | 解像度 |
|---|---|---|
E200 | 未定義または不確定の算術結果 | ゼロ除算または同様の未定義操作を防ぐために、除数をガードします。 |
E201 | インデックスが範囲外です | リストが想定より短くなっています。 first、last、または|?を使用します。 |
E202 | nullのプロパティにアクセスできません | 親フィールドがnullです。 |?を使用するか、present?で確認します。 |
E203 | ガード条件が失敗しました | ガード位置の変数と、メッセージに列挙されている値を確認し、どの値が拒否されたかを特定してから、入力または条件を修正します。 |
E204 | one!は要素が正確に1つであることを想定しています | 0 件または複数件の一致が有効な結果である場合は、first、last、または |? など別の関数を使用します。 one!は設計上厳密です。ルックアップが 0 件または複数件に一致した場合に、単に 1 件を黙って選ぶのではなく、このエラーを送出します。 |
E205 | nullとは連結できません | 値をラップします: presence(x) | ''。 |
E207 | 空のリストでは計算できません | リストが空でないことを確認します。何もないavgには答えがありません。 |
E224 | 未定義の名前 | タイプミスがないか、あるいは束縛される前に名前を使用していないか確認します。 |
E225 | 無効な値: セット内のいずれかが想定されます | エラーメッセージに列挙されている許可されたオプショントークンのいずれかを使用します。 |
解析と形式
値を想定される形式として解析できない、または想定される形式に変換できない場合、次のエラーが発生します。
| コード | メッセージ | 解像度 |
|---|---|---|
E206 | 無効またはサポートされていないエンコーディング | encodings()に照らして名前を確認します。 |
E208 | 無効なURL | 値が正しい形式のURLであることを確認します。 |
E209 | JSONの解析エラー | メッセージに記載されている行と列を確認します。入力テキストが有効なJSONではありません。構造的に有効なオブジェクトに重複キーがある場合は、代わりにE223が送出されます。 |
E210 | JSONシリアライズエラー | 値をシリアル化する前に、JSONで表現可能な型に変換します。 |
E212 | 時間的制約違反 | 日付、時刻、または継続時間の各要素が、それぞれ単体としては有効ですが、互いに整合していません。たとえば、月の日数が多すぎる、またはオフセットが指定されたタイムゾーンと一致しない、といった場合です。 hour: 200のように、それ自体が無効な要素は、代わりにE211を送出します。 |
E213 | 無効な正規表現 | 補間された値にescape_for_regexを使用します。 E007の静的パターンとは異なり、こちらは実行時にf文字列や連結などで構築されるため、データ内のエスケープされていない特殊文字が、一部のレコードだけパターンを壊す可能性があります。 |
E214 | 無効なタイムゾーン | Europe/LondonなどのIANA名を使用します。 |
E215 | あいまいまたは存在しない日時 | あいまいさを解決するには、on_gapまたはon_foldを設定します。日時が夏時間の境界に該当します。 |
E226 | エンコーディングに対して無効なデータ | バイト列が、メッセージに記載されたエンコーディングとして有効であることを確認します。 |
E227 | 文字をエンコードできません | ターゲットのエンコーディングがその文字を表現できるかどうかを、convertible_to_encoding?で確認します。 |
E228 | 丸めが必要ですが、モードはexactです | 丸めモードを受け入れるか、不正なデータとして扱います。値が要求された小数桁数に収まりません。 |
オプション、パス、および制限
次のエラーは、オプションマップ、パス式、またはサイズ制限が入力を拒否したときに発生します。
| コード | メッセージ | 解像度 |
|---|---|---|
E211 | 値が範囲外です | 許可される範囲について、メッセージを確認します。たとえば、IntegerまたはDecimalの基数に対して負の指数で^を使った場合や、実行時に計算されたInteger/Decimalの絶対値が1024バイトを超えた場合です。 |
E218 | 無効なマップフィールド | オプションマップ内の認識されたキーに、型または形状が不正な値が格納されています。フィールド名と、期待される型についてメッセージを確認します。認識されないキーは、代わりにE225を送出します。 |
E219 | 無効なJSONPath式 | パス構文を確認します。 |
E220 | サポートされていないJSONPath機能 | フィルター、ユニオン、関数拡張はサポートされているサブセットの範囲外です。代わりにdeep_collect_byを使用します。 |
E221 | 結果が大きすぎます | 操作により、制限で許可されている数を超える要素が生成されます。展開する前にフィルターします。 |
E222 | 値のネストが深すぎます | さらに処理する前に値をフラット化します。 |
E223 | キーの競合 | 元のデータ内の重複キーを削除するか、名前を変更します。 Map の構築中やオブジェクトのパース中に、同じキーに対して 2 つのエントリが見つかった関数名がメッセージに含まれます。 |
E229 | JSON Pointer構文が無効です | ポインタがRFC 6901の構文に従っているか確認します。ポインタは先頭を/で始め、トークン内でリテラルの/を~1、~を~0としてエンコードし、先頭にゼロのない非負のリストインデックスを使用する必要があります。 |
E230 | JSON Pointerの解決に失敗しました | ポインタ自体は正しい形式ですが、そのパスが存在しません。キーの欠落、インデックスの範囲外、または非コンテナ値に踏み込むセグメントなどが原因となる可能性があります。任意のパスとして利用する場合は、json_pointerの|?サポートを使用します。 |
暗号処理およびその他
| コード | メッセージ | 解像度 |
|---|---|---|
E216 | 暗号化操作が失敗しました | 多くの場合、アルゴリズムが要求する長さより短いキーが原因です。たとえば、HS256には少なくとも32バイト、HS384には少なくとも48バイト、HS512には少なくとも64バイトが必要です。正確な原因について、メッセージを確認します。 |
E217 | 一般エラー | これは一般的な失敗コードです。詳細についてはメッセージを確認します。 |
ホストエラー
WELは、明示的なHostFx呼び出しが解決されなかったか失敗した場合に、これらのエラーを送出します。どちらも捕捉可能です。
| コード | メッセージ | 解像度 |
|---|---|---|
E300 | 未解決のhostfx | 式が参照した名前空間およびキーに対して、ホスト値が提供されていませんでした。フォールバックを指定するには|?を使用します。 |
E301 | HostFx呼び出しに失敗しました | ホストは呼び出しを実行しましたが、式側で復旧可能な形で失敗しました。フォールバックを指定するには|?を使用するか、ホスト連携の設定を確認します。 |
停止
WELは、ホストが式の続行を許可せず全体の処理を停止した場合に、これらのエラーを送出します。これらはいずれも捕捉できません。復旧先となる評価のコンテキスト自体が残っていないためです。
| コード | メッセージ | 解像度 |
|---|---|---|
E400 | 評価のネスト深度が上限を超えました | 式を平坦化するか、複数のステップに分けてlet束縛を行います。 |
E401 | メモリ制限を超えました | データをより小さいバッチで処理します。 |
E450 | ホスト関数が失敗しました | ホスト自体が、E301の復旧可能な呼び出し失敗とは異なり、式では復旧できない形で失敗しました。ホスト連携またはコネクションを確認します。 |
スキーマエラー
ホストは式の結果に対してスキーマを宣言できます。たとえば、Transform dataアクションのOutput schemaなどです。スキーマ検証は式の評価後に実行され、そのスキーマに対して結果をチェックします。評価とは別のステップで行われるため、|?はこれらのエラーを検知しません。これらのエラーが式の内部を伝播することはありません。
| コード | メッセージ | 解像度 |
|---|---|---|
E500 | 必須フィールドが欠落しているか空白です | 必須スキーマフィールドが値を受け取っていないか、null、Skip、またはデフォルトのない空文字列を受け取りました。フィールドに値を設定するか、スキーマ側で任意項目としてマークします。 |
E501 | 値をフィールドの宣言された型に変換できませんでした | 式の出力が、そのフィールドについてスキーマに宣言された型と一致せず、WELは変換できませんでした。フィールドの実際の型をスキーマと照らし合わせて確認します。 |
E502 | スキーマアサーションが失敗したか、評価できませんでした | スキーマ上のwel_assertionsエントリを確認します。 |
E503 | スキーマ定義のネストが上限より深くなっています | スキーマ定義を平坦化します。 |
一般的なエラー
入力が式で想定される型または形状と一致しない場合、一般的に次のエラーが発生します。
| コード | 通常の意味 |
|---|---|
E100 | フィールドがStringとして受信されているのに数値として使用されている、またはその逆です。 |
E104 | このレコードにはオプションフィールドが存在しません。 |
E102 | 値を変換できません。たとえば、数値が期待される箇所に空文字列がある場合などです。 |
E103 | Decimalの金額が、演算のどこかでFloatと一緒に使用されました。 |
変換の開始時に入力フィールドを想定される型に変換し、任意の値を明示的に処理することで、これらのエラーを減らします。 presence(...) | defaultは、実際に任意のフィールドに使用します。詳細は変換関数および共通関数を参照してください。
関連情報
- データ型: これらのエラーに関連するデータ型。
- 演算子:
|および|?の詳細情報。 - 変換関数: 各データ型を構築する方法。
- Transform data: 式の失敗が発生するアクションであり、スキーマ検証に使用されるOutput schemaを含みます。
最終更新日: