バッチ操作の実行 (XMLA)

トランザクションおよび非トランザクション バッチ コマンドの実行

Batch コマンドは、コマンドを以下の 2 つのいずれかの方法で実行します。

• トランザクション
  Batch コマンドの Transaction 属性が true に設定されている場合、Batch コマンドは、Batch コマンドに含まれるすべてのコマンドを単一のトランザクション内で実行します。これがトランザクション バッチです。

  トランザクション バッチ内のいずれかのコマンドが失敗した場合、Analysis Services は Batch コマンド内で失敗したコマンドより前に実行されたコマンドをすべてロールバックし、Batch コマンドはすぐに終了します。Batch コマンド内でまだ実行されていないコマンドはいずれも実行されません。Batch コマンドが終了した後、Batch コマンドは失敗したコマンドについて発生したすべてのエラーを報告します。

• 非トランザクション
  Transaction 属性が false に設定されている場合、Batch コマンドは、Batch コマンドに含まれる個々のコマンドを別個のトランザクションで実行します。これが非トランザクション バッチです。非トランザクション バッチ内のいずれかのコマンドが失敗した場合、Batch コマンドは、失敗したコマンドの後にあるコマンドの実行を続行します。Batch コマンドが、Batch コマンドに含まれるすべてのコマンドの実行を試みた後、Batch コマンドは発生したすべてのエラーを報告します。

Batch コマンドに含まれるコマンドが返す結果はすべて、それらのコマンドが Batch コマンド内に含まれている順序と同じ順序で返されます。Batch コマンドによって返される結果は、Batch コマンドがトランザクション バッチまたは非トランザクション バッチのいずれであるかによって異なります。

注
Lock コマンドなど、出力を返さないコマンドが Batch コマンドに含まれており、そのコマンドが正常に実行された場合、Batch コマンドは結果要素内に空の root 要素を返します。空の root 要素があることにより、Batch コマンドに含まれるそれぞれのコマンドが、そのコマンドの結果の適切な root 要素と確実に対応します。

トランザクション バッチの結果から結果を返す処理

非トランザクション バッチの結果から結果を返す処理

非トランザクション バッチ内のコマンドによる結果は、それらのコマンドが Batch コマンド内に含まれている順序で、各コマンドごとに返されます。Batch コマンド内のいずれのコマンドも正常に起動できなかった場合、Execute メソッドは、その Batch コマンドについてのエラーを含む SOAP エラーを返します。少なくとも 1 つのコマンドが正常に起動された場合、その Batch コマンドに対する Execute メソッドによって返される ExecuteResponse 要素の return 要素には、1 つの results 要素が含まれます。この要素には、Batch コマンドに含まれる各コマンドに対して 1 つの root 要素が含まれています。非トランザクション バッチ内の 1 つ以上のコマンドが起動できない場合、または完了に失敗した場合、その失敗したコマンドに関する root 要素には、エラーについて説明する error 要素が含まれます。

注
非トランザクション バッチ内の少なくとも 1 つのコマンドが起動できれば、その非トランザクション バッチに含まれるすべてのコマンドが Batch コマンドの結果にエラーを返した場合であっても、その非トランザクション バッチは正常に実行されたものと見なされます。

直列および並列実行の使用

Batch コマンドでは、含まれるコマンドを直列または並列で実行することができます。コマンドが直列に実行される場合、Batch コマンド内に含まれる次のコマンドは、Batch コマンド内で現在実行中のコマンドが完了するまで起動できません。コマンドが並列で実行される場合、Batch によって複数のコマンドを同時に実行することができます。

コマンドを並列で実行するには、並列で実行するコマンドを Batch コマンドの Parallel プロパティに追加します。現在、Analysis Services で並列実行が可能なのは、連続する Process コマンドだけです。Create や Alter など、その他の XMLA コマンドは、Parallel プロパティに含まれていても直列に実行されます。

Analysis Services は、Parallel プロパティに含まれるすべての Process コマンドの並列実行を試みますが、すべての Process コマンドが並列で実行されるとは限りません。各 Process コマンドはインスタンスによって分析され、並列で実行できないとインスタンスが判断した Process コマンドは直列に実行されます。

注
コマンドを並行で実行する場合は、Batch コマンドの Transaction 属性を true に設定する必要があります。これは、Analysis Services によってサポートされるアクティブなトランザクションは接続ごとに 1 つだけであるのに対し、非トランザクション バッチは各コマンドを個別のトランザクションで実行するためです。非トランザクション バッチに Parallel プロパティを含めると、エラーが発生します。

並列実行の制限

バッチ コマンドを使用したオブジェクトの処理

Batch コマンドには、複数の Analysis Services オブジェクトの処理をサポートするために特に用意された、以下の省略可能なプロパティおよび属性が含まれています。

• Batch コマンドの ProcessAffectedObjects 属性は、指定したオブジェクトを処理する Batch コマンドに含まれる Process コマンドの結果、再処理が必要になったオブジェクトがある場合に、インスタンスがそれらのオブジェクトも処理するかどうかを示します。

• Bindings プロパティは、Batch コマンド内のすべての Process コマンドによって使用される不一致バインドのコレクションを含みます。

• DataSource プロパティは、Batch コマンド内のすべての Process コマンドによって使用されるデータ ソースに対する不一致バインドを含みます。

• DataSourceView プロパティは、Batch コマンド内のすべての Process コマンドによって使用されるデータ ソース ビューに対する不一致バインドを含みます。

• ErrorConfiguration プロパティは、Batch コマンドが、Batch コマンド内のすべての Process コマンドで発生したエラーを処理する方法を指定します。

  重要
  Process コマンドが Batch コマンドに含まれている場合、その Process コマンドには Bindings、DataSource、DataSourceView、および ErrorConfiguration プロパティを含めることができません。Process コマンドにこれらのプロパティを含める必要がある場合、その Process コマンドを含む Batch の対応するプロパティに、必要な情報を指定してください。

関連項目

参照

概念