次の方法で共有


データのエラー処理

更新 : 2005 年 12 月 5 日

データ フロー コンポーネントが変換を列データに適用したり、変換元のデータを抽出したり、または変換先にデータを読み込むときに、エラーが発生する場合があります。エラーが発生する原因の主なものは、予期しないデータ値です。たとえば、数字ではなく文字列が列に含まれる場合、データ変換は失敗します。また、データは日付データであるが列のデータ型は数値の場合、データベース列への挿入は失敗します。あるいは、列の値が 0 の場合に数学的演算の結果が無効となり、それが原因で式の評価が失敗します。

エラーは一般的に、次のカテゴリのいずれかに分類されます。

  • データ変換エラー。変換により、有効桁の損失、有効桁以外の桁の損失、および文字列の切り捨てなどの結果が返された場合に発生します。要求された変換がサポートされていない場合にも、データ変換エラーは発生します。
  • 式の評価エラー。実行時に評価される式が無効な演算を実行したり、データ値の不足または無効のため構文的に間違った状態になる場合に発生します。
  • 参照エラー。参照操作が、参照テーブル内で一致を見つけられなかった場合に発生します。

多くのデータ フロー コンポーネントではエラー出力がサポートされています。これを利用すると、コンポーネントが行う、入力データと出力データの両方での行レベルのエラー処理の方法を制御できます。入力または出力の個々の列にオプションを設定することにより、切り捨てまたはエラーが発生したときのコンポーネントの動作方法を指定します。たとえば、顧客名のデータが切り捨てられた時は失敗するが、それよりも重要でないデータが含まれる別の列で切り捨てが発生した場合はエラーを無視するように、コンポーネントを指定できます。

エラー出力は、別の変換の入力に連結したり、エラー出力以外の別の変換先に読み込むことができます。たとえば、エラー出力は、空白列に文字列を提供する派生列変換に連結できます。

次の図は、エラー出力が含まれる簡単なデータ フローを示しています。

エラー出力のあるデータ フロー

データ列の他に、エラー出力には ErrorCode 列と ErrorColumn 列が含まれています。ErrorCode 列はエラーを識別し、ErrorColumn 列にはエラー列の系列 ID が含まれます。これらの列のメタデータを表示するには、エラー出力をデータ フロー内の次のコンポーネントに連結するパスをクリックします。状況によっては、ErrorColumn 列の値が 0 に設定されていることがあります。これは、エラー状態が 1 列ではなく行全体に影響していることを示します。たとえば、参照変換で参照に失敗した場合などです。

詳細については、「データ フロー要素」および「Integration Services のパス」を参照してください。

Integration Services のエラー、警告、および他のメッセージの一覧については、「Integration Services のエラーおよびメッセージのリファレンス」を参照してください。

エラーと切り捨てオプション

エラーは、エラーまたは切り捨ての、2 つのカテゴリのいずれかに分類されます。エラーは決定的な失敗を示し、NULL 値の結果を生成します。このようなエラーには、データ変換エラーまたは式の評価エラーが含まれます。たとえば、英文字が含まれる文字列を数字に変換しようとすると、エラーが発生します。データ変換、式の評価、および変数、プロパティ、データ列への式の結果の割り当ては、不正なキャストおよび互換性のないデータ型のために失敗する場合があります。詳細については、「キャスト (SSIS)」、「式のデータ型変換」、および「Integration Services のデータ型」を参照してください。

切り捨ては、エラーほど重大ではありません。切り捨てによって生成される結果は、使用できる場合も、むしろ望ましい場合もあります。切り捨てをエラーとして扱うか、または許容できる条件として扱うかを選択できます。たとえば、15 文字の文字列を、文字幅が 1 文字のみの列に挿入する場合、文字列の切り捨てを選択できます。

変換元、変換、および変換先によるエラーと切り捨ての処理方法を構成できます。次の表では、このオプションについて説明します。

オプション 説明

エラー コンポーネント

エラーまたは切り捨てが発生すると、データ フロー タスクは失敗します。[失敗] は、エラーおよび切り捨ての既定のオプションです。

エラーを無視する

エラーまたは切り捨ては無視され、データ行は変換または変換元の出力に送られます。

行のリダイレクト

エラーまたは切り捨てのデータ行は、変換元、変換、または変換先のエラー出力に送られます。

エラーの説明の追加

既定では、エラー出力により数値エラー コードが提供され、通常、エラー出力にはエラーが発生した列の ID が含まれています。スクリプト コンポーネントを使用して追加列にエラーの説明を含めることができます。この操作は、1 行のスクリプトを使用して、T:Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSComponentMetaData90 インターフェイスの M:Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSComponentMetaData90.GetErrorDescription(System.Int32) メソッドを呼び出して行います。

このスクリプト コンポーネントは、エラーをキャプチャするデータ フロー コンポーネントよりデータ フローの下流にある任意のエラー セグメントに追加できますが、エラー行を出力先に書き込む直前の位置に配置するのが普通です。これによりスクリプトは、書き込まれたエラー行についてのみ、説明を参照することができます。たとえば、データ フロー内のエラー セグメントでエラーの一部が修正され、出力先にエラー行が書き込まれないこともあり得るからです。詳細については、「スクリプト コンポーネントによるエラー出力の強化」を参照してください。

エラー出力を構成するには

参照

処理手順

Integration Services のトラブルシューティング
データ フロー タスクの追加
データの抽出
データの変換
データの読み込み
コンポーネントの連結

概念

データ フロー タスク
データ フロー要素
パッケージのデータ フローの作成

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース 履歴

2005 年 12 月 5 日

変更内容 :
  • スクリプト コンポーネントを使用してエラーの説明を作成する方法についての説明を追加しました。
  • エラー列の値 0 について説明しました。