キューブ、パーティション、およびディメンションの処理についてのエラー構成 (SSAS - 多次元)

[アーティクル]
04/02/2014

処理中にデータ整合性エラーが発生した場合、キューブ、パーティション、またはディメンションオブジェクトのエラー構成プロパティによって、サーバーの応答が決定します。通常、キー列の重複キー、見つからないキー、および NULL 値がこのようなエラーをトリガーします。エラーの原因となるレコードはデータベースに追加されず、次の動作を指定するプロパティを設定することができます。既定では、処理が停止します。ただし、キューブの開発中に、不完全でもインポートされたデータのキューブの動作をテストできるように、エラーが発生した場合に処理を続行する必要がある場合もあります。

このトピックのセクションは次のとおりです。

実行の順序
既定の動作
エラー構成プロパティ
エラー構成プロパティを設定する場所
見つからないキー (KeyNotFound)
ファクトテーブルの NULL 外部キー (KeyNotFound)
ディメンションの NULL キー
一貫性のないリレーションシップをもたらす重複キー (KeyDuplicate)
エラーの上限またはエラーの上限のアクションの変更
エラーログパスの設定
次の手順

実行の順序

サーバーは、各レコードに対して ErrorConfiguration ルールの前に NullProcessing ルールを常に実行します。複数のエラーレコードのキー列にゼロがある場合、NULL をゼロに変換する NULL 処理プロパティによって後で重複キーエラーが生じる可能性があるため、この点を理解することが重要です。

既定の動作

既定では、処理はキー列が関係する最初のエラーで停止します。この動作は、許可されたエラーの数としてゼロを指定するエラーの上限およびそのエラーの上限に達した場合にサーバーに処理の停止を指示する処理の停止ディレクティブによって制御されます。

NULL、または値が見つからないか、重複するために、エラーをトリガーするレコードは、不明なメンバーに変換されるか、破棄されます。 Analysis Services には、データ整合性制約に違反するデータはインポートされません。

KeyErrorAction の ConvertToUnknown 設定によって、既定では不明なメンバーへの変換が発生します。不明なメンバーに割り当てられたレコードは、処理が完了した後で調査する必要がある問題の証拠としてデータベースで検疫されます。

不明なメンバーはクエリワークロードから除外されますが、UnknownMember が表示に設定されている場合は、一部のクライアントアプリケーションで表示されます。

不明なメンバーに変換された NULL の数を追跡する場合、NullKeyConvertedToUnknown プロパティを変更して、ログまたは処理ウィンドウでエラーを報告することができます。
手動で KeyErrorAction プロパティを DiscardRecord に手動で設定すると、破棄が発生します。

エラー構成プロパティによって、エラーが発生した場合にサーバーがどのように応答するかを決定することができます。オプションには、処理を直ちに停止する、処理は続行するがログ記録は停止する、または処理とエラーのログ記録の両方を続行するがあります。既定値はエラーの重大度によって異なります。

エラー数は、エラーが発生した数を記録します。上限を設定すると、この上限に達した場合にサーバーの応答が変更されます。既定では、サーバーは上限に達すると処理を停止します。既定の上限は 0 で、カウントされる最初のエラーで処理が停止します。

キーフィールドでキーが見つからない、または NULL 値のような影響が大きいエラーには、すぐに対処する必要があります。既定では、これらのエラーによって ReportAndContinue サーバー動作が実行され、サーバーがエラーを見つけるとそのエラーをエラー数に追加して、処理を継続します (エラーの上限がゼロである場合を除きます。この場合、処理は直ちに停止されます)。

他のエラーは、必ずしもデータ整合性の問題を引き起こすわけではないため、生成されても既定では数えられないか、ログに記録されません (これが IgnoreError 設定です)。

エラー数は、NULL 処理設定の影響を受けます。ディメンション属性の場合、NULL 処理オプションによって NULL 値が発生した場合のサーバーの応答が決定されます。既定では、文字列型の列の NULL は空の文字列として処理されますが、数値列の NULL はゼロに変換されます。 NullProcessing プロパティをオーバーライドして、KeyNotFound エラーまたは KeyDuplicate エラーになる前に NULL 値を見つけるようにできます。詳細については、「ディメンションの NULL キー」を参照してください。

エラーは [処理] ダイアログボックスで記録されますが、保存されません。テキストファイル内でエラーを収集するキーエラーログファイルの名前を指定できます。

エラー構成プロパティ

エラー構成プロパティは 9 つあります。特定のエラーが発生した場合のサーバーの応答を決定するために 5 つのプロパティが使用されます。他の 4 つは、許可されるエラー数、上限に達した場合の動作、ログファイルでエラーを収集するかどうかなど、エラー構成のワークロードに範囲が設定されます。

特定のエラーに対するサーバーの応答

プロパティ	既定値	その他の値
CalculationError エラー構成を初期化するときに発生します。	IgnoreError は、エラー数が上限より少ない限り、エラーのログ記録やカウントを行わずに処理を続行します。	ReportAndContinue は、エラーをログに記録し、カウントします。 ReportAndStop は、エラーの上限に関係なく、エラーを報告し、直ちに処理を停止します。
KeyNotFound ファクトテーブルの外部キーに関連ディメンションテーブルで一致する主キーがない場合に発生します (たとえば、Sales ファクトテーブルに Product ディメンションテーブルに存在しない製品 ID のレコードがあります)。このエラーは、パーティションの処理中、またはスノーフレークディメンションのディメンション処理中に発生する可能性があります。	ReportAndContinue は、エラーをログに記録し、カウントします。	ReportAndStop は、エラーの上限に関係なく、エラーを報告し、直ちに処理を停止します。 IgnoreError は、エラー数が上限より少ない限り、エラーのログ記録やカウントを行わずに処理を続行します。このエラーをトリガーするレコードは、既定では不明なメンバーに変換されますが、KeyErrorAction プロパティを変更して代わりに破棄することもできます。
KeyDuplicate 重複した属性キーがディメンションに見つかったときに発生します。ほとんどの場合、重複した属性キーは許容されますが、このエラーは重複を通知するため、属性間の一貫性のないリレーションシップにつながる可能性があるデザインの不具合についてディメンションを確認することができます。	IgnoreError は、エラー数が上限より少ない限り、エラーのログ記録やカウントを行わずに処理を続行します。	ReportAndContinue は、エラーをログに記録し、カウントします。 ReportAndStop は、エラーの上限に関係なく、エラーを報告し、直ちに処理を停止します。
NullKeyNotAllowed NullProcessing = Error がディメンション属性で設定されている場合、または NULL 値がメンバーを一意に識別するために使用される属性のキー列に存在するときに発生します。	ReportAndContinue は、エラーをログに記録し、カウントします。	ReportAndStop は、エラーの上限に関係なく、エラーを報告し、直ちに処理を停止します。 IgnoreError は、エラー数が上限より少ない限り、エラーのログ記録やカウントを行わずに処理を続行します。このエラーをトリガーするレコードは、既定では不明なメンバーに変換されますが、KeyErrorAction プロパティを設定して代わりに破棄することもできます。
NullKeyConvertedToUnknown NULL 値がその後、不明なメンバーに変換されたときに発生します。ディメンション属性の設定 NullProcessing = ConvertToUnknown は、このエラーをトリガーします。	IgnoreError は、エラー数が上限より少ない限り、エラーのログ記録やカウントを行わずに処理を続行します。	このエラーが情報であると判断した場合は、既定値のままにします。それ以外の場合は、ReportAndContinue を選択して、エラーを処理ウィンドウに報告し、エラーの上限にエラーを加算することができます。 ReportAndStop は、エラーの上限に関係なく、エラーを報告し、直ちに処理を停止します。

CalculationError

エラー構成を初期化するときに発生します。

IgnoreError は、エラー数が上限より少ない限り、エラーのログ記録やカウントを行わずに処理を続行します。

ReportAndContinue は、エラーをログに記録し、カウントします。