キューブのコンパイルとビルド

エージェント数の指定

キューブを非同期的に構築するときに、並列処理が使用できる場合、その作業を実行するために DeepSee はエージェントのプールを設定します。このプールは、一連の優先度の高いエージェントと、同じ数の優先度の低いエージェントで構成されます。既定では、優先度の高いエージェント (または優先度の低いエージェント) の総数は、DeepSee が動作しているマシン上で検出されたコアの数の 4 倍です。

別のエージェント数を指定するには、クラス %DeepSee.UtilsOpens in a new tab のクラス・メソッド %SetAgentCount() を呼び出します。引数は以下のいずれかである必要があります。

• 優先度の高いエージェントの必要数 — つまり、必要な総エージェント数の半数。

• NULL — 既定の動作をリストアする場合。

このメソッドは、優先度の高いエージェントの現在の数を返します。つまり、総エージェント数の半数です。または、NULL を返すこともあります。これは、既定の動作が有効であることを意味します。

例えば、以下のコマンドは、総エージェント数を 10 に設定します。

 d ##class(%DeepSee.Utils).%SetAgentCount(5)

エージェントの現在の数を確認するには、同じクラスの %GetAgentCount() メソッドを使用します。このメソッドは、優先度の高いエージェントの現在の数を返します。または、NULL を返すこともあります。これは、既定の動作が有効であることを意味します。

エージェントの実行中は、それらのエージェントを個別のプロセスとして管理ポータルに表示することができます。これらを表示するには、[システム処理] をクリックしてから、[プロセス] をクリックします。%DeepSee.TaskMasterOpens in a new tab ルーチンのインスタンスを探します。これらは、自動的にはシャットダウンされませんが、アイドル時にリソースを消費することはありません。

まれに、これらのエージェントのリセットが必要になることがあります。この操作には、%Reset() の %DeepSee.UtilsOpens in a new tab メソッドを使用します。また、このメソッドは、保留中のタスクを消去して、現在のネームスペースの結果キャッシュを消去します。これらは、すべてのユーザに直ちに影響を与えます。このメソッドは、開発時にのみ使用するように意図されています。

構築エラーの確認

アーキテクトまたはターミナルでキューブを構築する際、構築エラーが存在するかどうかが DeepSee により示されます。以下に例を示します。

このユーザ・インタフェースには、一部の構築エラーが表示されません (ターミナルでキューブを構築する際も同様です)。

記録された構築エラーをすべて確認するには、以下のいずれかを実行します。

• ログ・ファイル install-dir/mgr/DeepSeeUpdate_cube_name_NAMESPACE.log を探します。cube_name はキューブ名で、NAMESPACE はこのキューブが定義されているネームスペースです。

  このファイルのタイム・スタンプでは $NOW を使用してローカルの日時が記録されます。サマータイムは無視されます。

• 以下のように、%DeepSee.UtilsOpens in a new tab の %PrintBuildErrors() メソッドを使用します。

  do ##class(%DeepSee.Utils).%PrintBuildErrors(cubename)
  

  

  cubename はキューブの論理名で、引用符で囲みます。

  このメソッドはすべての構築エラーに関する情報を表示します。以下に例を示します (改行が追加されています)。

  SAMPLES>do ##class(%DeepSee.Utils).%PrintBuildErrors("patients")
      1   Source ID: 13
          ERROR #5001: Error inserting/updating fact: (Source ID:'13') 
  Field 'DeepSee_Model_PatientsCube.Fact.Dx3295243289' (value 'abc') failed validation
   
      2   Source ID: 22
          ERROR #5001: Error inserting/updating fact: (Source ID:'22') 
  Field 'DeepSee_Model_PatientsCube.Fact.Dx3295243289' (value 'abc') failed validation
   
      3   Source ID: 37
          ERROR #5001: Error inserting/updating fact: (Source ID:'37') 
  Field 'DeepSee_Model_PatientsCube.Fact.Dx3295243289' (value 'abc') failed validation
  ...
  81 build error(s) for 'patients'
  

  

ファクト数の確認

キューブの構築の際は、構築されるファクトとインデックスの数が報告されます。例えば、アーキテクトでは以下のようになります。

各ファクトは、ファクト・テーブル内のレコードです。以下の場合を除き、ファクト・テーブルには、ベース・テーブルと同じ数のレコードが存在します。

• ファクト数は、この章で前述した説明のとおりに制限できます。

• キューブ・クラスでは、%OnProcessFact() コールバックも定義します。このコールバックは、キューブからレコードを除外するために使用できます。"DeepSee 上級モデリング・ガイド" の “キューブおよびサブジェクト領域の高度な機能の使用” を参照してください。

また、DeepSee でインデックスが構築されると、インデックス数がファクト・テーブルのレコード数と同じになります。例えば、アーキテクトでは [ファクトの構築中] と [インデックス構築中] に同じ数が示されます。これらの数に不一致がある場合は、ログ・ファイルを確認してください。

考えられる構築エラーの原因

構築エラーやファクト数の原因不明の不一致が存在する場合は、以下の手順を実行します。

1. 範囲式を使用するすべてのレベルを調べ、これらのレベルでレコードが削除されていないことを検証します。このドキュメントで後述の “レベルの検証” を参照してください。

   この種のエラーは、インデックス数に影響しますが、ファクト数には影響しません。

2. 選択したディメンジョンまたはメジャーを無効にします。その後、リコンパイルおよび再構築を行い、問題が発生するディメンジョンまたはメジャーを隔離します。

<STORE> エラー

構築ログに、以下のようなエラーが記載される場合があります。

ERROR #5002: Cache error: <STORE>%ConstructIndices+44^Cube.cube_name.Fact.1

このエラーは、レベルに非常に大量のメンバが存在する場合に発生します。既定では、DeepSee はインデックスを構築する際、ローカル・メモリを使用してインデックスをチャンクで格納し、その後それらをディスクに書き込みます。レベルに非常に大量のメンバが含まれる場合は、ローカル・メモリが不足し、<STORE> エラーが発生することがあります。

このようなエラーを回避するには、以下のいずれかの操作を実行します。

• キューブを単一のプロセスで構築する。そのためには、ターミナルで %BuildCube() を使用し、2 番目の引数に 0 を使用します。

• <cube> 要素で、bitmapChunkInMemory="false" (既定) を指定する。バックグラウンド・プロセスを使用してこのキューブを構築すると、ローカル変数ではなくプロセス・プライベート・グローバルが使用されます (ローカル・メモリによる制限がなくなります)。

参照の欠落エラー

キューブが他のキューブへのリレーションシップを持つ場合、構築ログに、以下のようなエラーが記載される場合があります。

ERROR #5001: Missing relationship reference in RelatedCubes/Patients: source ID 1 missing reference to RxHomeCity 4

このエラーは、キューブが間違った順序で構築されていることを示す可能性があります。"DeepSee 上級モデリング・ガイド" の “リレーションシップを持つキューブの構築” を参照してください。キューブ・マネージャを使用する場合、キューブ・マネージャが適切な構築順序を決定することに注意してください。

missing relationship reference エラーは、キューブの構築プロセス中に新しいソース・データが使用可能になる場合、つまり既にキューブのいくつかが構築された後にも発生する可能性があります。例えば、サンプル・キューブ RelatedCubes/Cities と RelatedCubes/Patients について考えてみましょう (これらは SAMPLES ネームスペースで使用可能です)。キューブ RelatedCubes/Cities を構築した後、RelatedCubes/Patients のソース・テーブルが、新しい都市を使用するレコードを受け取るとします。この場合、キューブ RelatedCubes/Patients を構築すると、missing relationship reference エラーが発生します。

キューブを正しい順序で構築したことが確実である場合、エラーからの回復の詳細について、次のセクションを参照してください。

構築エラーからの回復

DeepSee は、キューブ全体を再構築するよりも、以前に構築エラーを生成したレコードのみ再構築する方法を提供します。以下はその方法です。

1. これらのエラーの原因となる問題を修正します。

2. 以下のように、%DeepSee.UtilsOpens in a new tab の %FixBuildErrors() メソッドを使用します。

   set sc=##class(%DeepSee.Utils).%FixBuildErrors(cubename)
   

   

   cubename はキューブの論理名で、引用符で囲みます。このメソッドは、進捗状況メッセージを表示するかどうかを指定する 2 番目の引数を受け入れます。この引数の既定値は True です。

   例えば以下のように出力されます。

   Fact '100' corrected
   Fact '500' corrected
   Fact '700' corrected
    
    
   3 fact(s) corrected for 'patients'
   0 error(s) remaining for 'patients'
   

   

   または、キューブ全体を再構築します。