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演算子|?は、キャッチ可能なエラーをキャッチし、代わりにフォールバックを返します。捕捉不能エラーは伝播します。

wel
_.customer.email |? 'unknown'
Integer(_.qty) |? 0

|?と|の比較 ​

|?と|の違いは非常に重要であり、ここで混同するとよく混乱の原因になります。

Operator処理する対象処理しない対象
|null値エラー
|?エラー該当なし

存在しないフィールドを読み取るとE104が発生します。これはnullを生成しないため、|では保護されません。

wel
_.customer.nickname | 'none'      // still raises E104
_.customer.nickname |? 'none'     // returns 'none'

キーが存在し、その値がnullまたは空白になる可能性がある場合は、通常、あらゆる種類の欠如をnullに正規化するpresenceとともに|を使用します。

wel
presence(_.display_name) | 'Unknown'

形状自体が異なる可能性がある場合は|?を使用します。

フォールバックは判断であり、修正ではありません

|? 0を通貨フィールドで使用すると、不正な形式の金額が気づかれずに0になり、ジョブは成功として報告されます。それが正しい場合もあれば、誤った請求書が気づかれずに送信される場合もあります。

欠落が想定され、デフォルト値が本当に正しい場合にのみ、フォールバックを使用してください。そうでない場合は、エラーを伝播させてください。失敗したジョブは目に見えますが、誤った数値は目に見えません。

解析および静的分析エラー ​

WELは評価が開始される前にこれらのエラーを発生させます。これらはすべての入力で発生し、キャッチできません。

コードメッセージ解像度
E001スクリプトには、ランタイムがサポートするより新しいWELバージョンが必要です式で、このエンジンにない機能が使用されています。エンジンバージョンを確認します。
E002予期しないトークンメッセージ内のキャレット(^)は問題のあるトークンを指し示します。その位置の構文エラーを修正します。
E003終了していない文字列リテラル引用符('または")を閉じるか、アポストロフィを\'でエスケープするか、二重引用符に切り替えるか、\n/\rや三重引用符形式('''...'''または"""...""")を使用して改行を直接含めます。
E004無効な数値リテラル余分な区切り文字または不正な形式の指数がないか確認します。
E005無効なバイナリリテラル0x"..." リテラルには16進数の桁だけを使用します。
E006予期しない入力の終わり閉じ忘れがないか確認します。かっこ([)、丸かっこ(()、または本体のないdoなどです。
E007無効な正規表現パターンがECMAScript正規表現構文に従っていることを確認します。このエラーは、式内に直接記述されたパターンに対して発生します。パターンが実行時にデータから構築される場合はE213を参照してください。
E008Binary()に非ASCII文字を含めることはできません代わりに、明示的なエンコーディングを指定してencode_stringを使用します。
E009変数はすでに定義されています内側のバインディングの名前を変更します。 WELではシャドーイングは許可されていません。
E010未定義の変数タイプミスがないか、あるいはそれを束縛するletの外側で名前を使用していないか確認します。
E011未定義の関数関数名については標準ライブラリを確認するか、タイプミスを修正します。
E012引数の数が正しくありません関数のリファレンスエントリにあるシグネチャを確認します。
E013無効なロケール設定アクションのロケール設定を確認します。
E014式のネストが深すぎます式をletバインディングに分割します。
E015識別子が長すぎます名前をNFC正規化後に64個以下のUnicodeスカラ値になるよう短くします。
E016無効な形式指定f-stringまたはformat関数の形式文字列を確認します。
E017無効なhostfx参照ホスト関数参照の構文を確認します。
E018HostFx名前空間は許可されていませんこのコンテキストで許可されている名前空間を確認します。
E019数値リテラルが長すぎます桁数を減らすか、値をStringとして読み取って変換します。
E020コンストラクタの定数が無効ですリテラルをコンストラクタが受け付ける形式に合わせます。たとえば、Duration('P1D')は、DurationがPT24Hのような時計時間の継続時間のみを受け付けるため、このエラーを送出します。また、IntegerまたはDecimalのリテラルや定数が、1024バイトの絶対値上限を超えた場合にも発生します。詳細については、データ型を参照してください。
E021式が大きすぎます式を複数のステップに分割します。
E022リテラル内のキーの衝突重複したキーを削除するか、名前を変更します。
E023Skipは呼び出したりパイプで入力したりできません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ある型を別の型にキャストできません値がコンストラクタが受け付ける形式になっていません。値をクリーンアップするか、|?を使用してデフォルト値を指定します。
E103DecimalとFloatの精度が混在しています両側を同じ型にします。詳細については、データ型を参照してください。
E104この型ではフィールドにアクセスできませんフィールドが欠落しているか、値がMapではありません。デフォルトにはhas_key?または|?を使用します。
E105Lambdaが異なる数の引数を想定していますラムダのパラメータが、高階関数から渡される引数と一致しているか確認します。たとえば、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、または|?を使用します。
E202nullのプロパティにアクセスできません親フィールドがnullです。 |?を使用するか、present?で確認します。
E203ガード条件が失敗しましたガード位置の変数と、メッセージに列挙されている値を確認し、どの値が拒否されたかを特定してから、入力または条件を修正します。
E204one!は要素が正確に1つであることを想定しています0 件または複数件の一致が有効な結果である場合は、first、last、または |? など別の関数を使用します。 one!は設計上厳密です。ルックアップが 0 件または複数件に一致した場合に、単に 1 件を黙って選ぶのではなく、このエラーを送出します。
E205nullとは連結できません値をラップします: presence(x) | ''。
E207空のリストでは計算できませんリストが空でないことを確認します。何もないavgには答えがありません。
E224未定義の名前タイプミスがないか、あるいは束縛される前に名前を使用していないか確認します。
E225無効な値: セット内のいずれかが想定されますエラーメッセージに列挙されている許可されたオプショントークンのいずれかを使用します。

解析と形式 ​

値を想定される形式として解析できない、または想定される形式に変換できない場合、次のエラーが発生します。

コードメッセージ解像度
E206無効またはサポートされていないエンコーディングencodings()に照らして名前を確認します。
E208無効なURL値が正しい形式のURLであることを確認します。
E209JSONの解析エラーメッセージに記載されている行と列を確認します。入力テキストが有効なJSONではありません。構造的に有効なオブジェクトに重複キーがある場合は、代わりにE223が送出されます。
E210JSONシリアライズエラー値をシリアル化する前に、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 つのエントリが見つかった関数名がメッセージに含まれます。
E229JSON Pointer構文が無効ですポインタがRFC 6901の構文に従っているか確認します。ポインタは先頭を/で始め、トークン内でリテラルの/を~1、~を~0としてエンコードし、先頭にゼロのない非負のリストインデックスを使用する必要があります。
E230JSON Pointerの解決に失敗しましたポインタ自体は正しい形式ですが、そのパスが存在しません。キーの欠落、インデックスの範囲外、または非コンテナ値に踏み込むセグメントなどが原因となる可能性があります。任意のパスとして利用する場合は、json_pointerの|?サポートを使用します。

暗号処理およびその他 ​

コードメッセージ解像度
E216暗号化操作が失敗しました多くの場合、アルゴリズムが要求する長さより短いキーが原因です。たとえば、HS256には少なくとも32バイト、HS384には少なくとも48バイト、HS512には少なくとも64バイトが必要です。正確な原因について、メッセージを確認します。
E217一般エラーこれは一般的な失敗コードです。詳細についてはメッセージを確認します。

ホストエラー ​

WELは、明示的なHostFx呼び出しが解決されなかったか失敗した場合に、これらのエラーを送出します。どちらも捕捉可能です。

コードメッセージ解像度
E300未解決のhostfx式が参照した名前空間およびキーに対して、ホスト値が提供されていませんでした。フォールバックを指定するには|?を使用します。
E301HostFx呼び出しに失敗しましたホストは呼び出しを実行しましたが、式側で復旧可能な形で失敗しました。フォールバックを指定するには|?を使用するか、ホスト連携の設定を確認します。

停止 ​

WELは、ホストが式の続行を許可せず全体の処理を停止した場合に、これらのエラーを送出します。これらはいずれも捕捉できません。復旧先となる評価のコンテキスト自体が残っていないためです。

コードメッセージ解像度
E400評価のネスト深度が上限を超えました式を平坦化するか、複数のステップに分けてlet束縛を行います。
E401メモリ制限を超えましたデータをより小さいバッチで処理します。
E450ホスト関数が失敗しましたホスト自体が、E301の復旧可能な呼び出し失敗とは異なり、式では復旧できない形で失敗しました。ホスト連携またはコネクションを確認します。

スキーマエラー ​

ホストは式の結果に対してスキーマを宣言できます。たとえば、Transform dataアクションのOutput schemaなどです。スキーマ検証は式の評価後に実行され、そのスキーマに対して結果をチェックします。評価とは別のステップで行われるため、|?はこれらのエラーを検知しません。これらのエラーが式の内部を伝播することはありません。

コードメッセージ解像度
E500必須フィールドが欠落しているか空白です必須スキーマフィールドが値を受け取っていないか、null、Skip、またはデフォルトのない空文字列を受け取りました。フィールドに値を設定するか、スキーマ側で任意項目としてマークします。
E501値をフィールドの宣言された型に変換できませんでした式の出力が、そのフィールドについてスキーマに宣言された型と一致せず、WELは変換できませんでした。フィールドの実際の型をスキーマと照らし合わせて確認します。
E502スキーマアサーションが失敗したか、評価できませんでしたスキーマ上のwel_assertionsエントリを確認します。
E503スキーマ定義のネストが上限より深くなっていますスキーマ定義を平坦化します。

一般的なエラー ​

入力が式で想定される型または形状と一致しない場合、一般的に次のエラーが発生します。

コード通常の意味
E100フィールドがStringとして受信されているのに数値として使用されている、またはその逆です。
E104このレコードにはオプションフィールドが存在しません。
E102値を変換できません。たとえば、数値が期待される箇所に空文字列がある場合などです。
E103Decimalの金額が、演算のどこかでFloatと一緒に使用されました。

変換の開始時に入力フィールドを想定される型に変換し、任意の値を明示的に処理することで、これらのエラーを減らします。 presence(...) | defaultは、実際に任意のフィールドに使用します。詳細は変換関数および共通関数を参照してください。

  • データ型: これらのエラーに関連するデータ型。
  • 演算子: |および|?の詳細情報。
  • 変換関数: 各データ型を構築する方法。
  • Transform data: 式の失敗が発生するアクションであり、スキーマ検証に使用されるOutput schemaを含みます。

最終更新日: