ジャーナリング・ユーティリティ

^JRNSTART を使用したジャーナリングの開始

ジャーナリングを開始するには、以下の例に示すように、^JRNSTART を実行するか、または ^JOURNAL メニューのオプション・プロンプトで「1」を入力します。

^JRNSTART を直接実行する例

%SYS>Do ^JRNSTART

^JOURNAL メニューからジャーナリングを開始する例

%SYS>Do ^JOURNAL
 
 1) Begin Journaling (^JRNSTART)
 ...
Option? 1

このオプションを選択したときにジャーナリングを実行している場合、以下のようなメッセージが表示されます。

Already journaling to C:\MyIRIS\mgr\journal\20231113.001 

^JRNSTOP を使用したジャーナリングの停止

ジャーナリングを停止するには、以下の例に示すように、^JRNSTOP を実行するか、または ^JOURNAL メニューのオプション・プロンプトで「2」を入力します。

^JRNSTOP を直接実行する例

%SYS>Do ^JRNSTOP
 
Stop journaling now? No => Yes

^JOURNAL メニューからジャーナリングを停止する例 ：

%SYS>Do ^JOURNAL
 
 ...
 2) Stop Journaling (^JRNSTOP)
 ...
Option? 2
Stop journaling now? No => Yes

このオプションを選択したときにジャーナリングを実行していない場合、以下のようなメッセージが表示されます。

Not journaling now.

^JRNSWTCH を使用したジャーナル・ファイルの切り替え

ジャーナル・ファイルを切り替えるには、^JRNSWTCH を実行するか、または以下の例に示すように、^JOURNAL メニューのオプション・プロンプトで「3」を入力します。

%SYS>Do ^JOURNAL
 
 ...
 3) Switch Journal File (^JRNSWTCH)
 ...
Option? 3
Switching from: C:\MyIRIS\mgr\journal\20231113.002
To:             C:\MyIRIS\mgr\journal\20231113.003

このユーティリティでは、以前のジャーナル・ファイル名および現在のジャーナル・ファイル名が表示されます。

SWDIR^JOURNAL を使用したジャーナル・ディレクトリの切り替え

"ジャーナル設定の構成" の説明に従ってセカンダリ・ディレクトリが構成されているものとして、ジャーナル・ディレクトリを切り替えるには、SWDIR^JOURNAL を実行するか、または以下の例に示すように ^JOURNAL メニューの [オプション] プロンプトで 13 と入力します。

%SYS>Do ^JOURNAL
 
 ...
13) Switch Journaling to Secondary Directory (SWDIR^JOURNAL)

Option? 3
Option? 13
Journaling to \\remote\MyIRIS\journal_secondary\MIRROR-MIRRORONE-20230720.007

切り替えの後、現在のジャーナル・ディレクトリとジャーナル・ファイルの名前が表示されます。

^JRNRESTO を使用したジャーナル・ファイルからのグローバルのリストア

InterSystems IRIS ^JRNRESTO ルーチンは、バックアップからデータベースをリストアした後で使用して、ジャーナル・ファイルのデータベース更新内容を適用することで、データベースを障害発生の直前の状態に戻します。これは、ジャーナル・リストアと呼ばれています。また、更新の適用プロセスは、デジャーナリングと呼ばれています。ジャーナル・リストアでは、バックアップの作成と障害発生の間に作成されたすべてのジャーナル・レコードをデジャーナルします。例えば、データベースのバックアップを火曜日の早朝に作成し、データベースが水曜日の午後にクラッシュした場合は、火曜日のバックアップをリストアした後で、火曜日と水曜日に作成されたジャーナル・ファイルから更新をリストアできます。

使用可能なシステム・リソースが十分にある場合は、1 つのジャーナル・リストア操作の中で最大 16 のデジャーナリング・ジョブで並列して更新を実行できます ("並列デジャーナリングのシステム要件" を参照)。これにより、操作のパフォーマンスが向上します。これは、並列デジャーナリングと呼ばれます。複数のアップデータで同時に同じデータベースを更新することはできますが、同じグローバルを更新することはできません。これにより、少数のデータベースに更新を適用する場合は、各グローバル内のデータの論理的な整合性を確保しつつ、スループットを向上させられます。

並列デジャーナリングは、ホスト・システムに並列デジャーナリングをサポートするために十分な CPU が搭載されていて、この目的に割り当て可能な共有メモリ・ヒープ (gmheap) を InterSystems IRIS インスタンスが十分に確保している場合にのみ有効になります。実際には、gmheap が増加されている場合を除き、ほとんどの InterSystems IRIS インスタンスでジャーナル・リストアに並列デジャーナリングが使用されることはありません。並列デジャーナリングのジョブ数は、gmheap のサイズを 200 MB で除算した数を超過することはできません。例えば、同時に 4 つのデジャーナリング・ジョブが実行されているとすると、800 MB 以上の gmheap が必要になります(並列デジャーナリングをサポートするにはメモリが不足している場合でも、共有メモリ・ヒープのサイズを既定値よりも増やすと、デジャーナリングのスループットが向上することがあります)。

^JRNRESTO でリストアされるデータベースは、ジャーナルをリストアする時点でジャーナル状態が Yes になっているもののみです。各データベースが初めて検出されたときに、このルーチンによってデータベースのジャーナル状態の検査が行われ、記録されます。リストアのプロセスでは、ジャーナル状態が No であるデータベースのジャーナル・レコードは無視されます。ジャーナル記録対象として指定されているデータベースがない場合、リストアを終了するかどうかを尋ねるメッセージが表示されます。ここで、特定のデータベースについてデータベースのジャーナル状態を Yes に変更し、^JRNRESTO を再起動できます。

^JRNRESTO では、以下のように、ジャーナルのリストアに関するいくつかの決定を行うことができます。

• ルーチンを実行している InterSystems IRIS インスタンスのデータベース、または別の InterSystems IRIS インスタンスのデータベースへのグローバル更新のリストア。現在のインスタンスですべてのデータベースにすべてのグローバルの更新をリストアするように選択したり、現在のインスタンスまたは別のインスタンスで個別データベースを選択できます。また、必要に応じて、それぞれにリストアするグローバルを指定できます。

• ミラーリングされるデータベースへのミラー・ジャーナル・ファイルのリストア (ミラーリングされるデータベースのキャッチアップ) またはミラーリングされないデータベースへのミラー・ジャーナル・ファイルのリストア。以下の手順に示すように、ミラー・メンバでは、ミラーリングされるデータベースをキャッチアップするかどうかを示すように求めるプロンプトが表示されます。これを行う場合、手順は ^JRNRESTO への MirrorCatchup^ エントリ・ポイントにリダイレクトされます ("MirrorCatchup^JRNRESTO を使用したミラーリングされるデータベースへのジャーナルのリストア" を参照)。

• 既存のジャーナル・フィルタ ("^ZJRNFILT を使用したジャーナル・レコードのフィルタ処理" を参照) をリストアに適用します。

• リストア元のジャーナル・ファイルの範囲を選択します。

• リストア中に更新のジャーナリングを無効にし、処理を高速化します。

• 以下に示すエラー発生時の処理を選択します。

  • データベース関連の問題があってもジャーナル・リストアを続行する。例えば、ターゲット・データベースをマウントできない場合や、更新の適用時にエラーが発生した場合です。この設定では、影響を受けたデータベースの更新はスキップされます。これらのデータベースは、操作後に他のデータベースとの整合性がない状態になっていたり、整合性のないグローバルが含まれていたりする場合があり (ただし、各グローバル内のデータの論理的な整合性は保証されています)、個別にリカバリする必要があります。

  • データベース関連の問題のために更新をスキップしなければならない場合は、ジャーナルを中止する。この設定では、データベースと、データベースに含まれるグローバルは、リストアが中止される原因となったレコードまでは、お互いに整合性があります。この設定では、並列デジャーナリングは無効になります。

ジャーナル・ファイルからグローバル更新をリストアするには、以下の手順を実行します。

1. %SYS ネームスペースで ^JRNRESTO ルーチンを実行し、Restore the Journal? プロンプトで <Enter> キーを押して続行します。

2. ミラー・メンバでこのルーチンを実行している場合は、以下のプロンプトが表示されます。

   Catch-up mirrored databases? No =>
   
   

   

   • ミラー・ジャーナル・ファイルが作成されたミラー内のミラーリングされるデータベースにこのミラー・ジャーナル・ファイルをリストアする場合、yes と入力します。このプロシージャは ^JRNRESTO への MirrorCatchup^ エントリ・ポイントにリダイレクトされます ("MirrorCatchup^JRNRESTO を使用したミラーリングされるデータベースへのジャーナルのリストア" を参照)。

   • ミラー・ジャーナル・ファイルをミラーリングされないデータベースにリストアするか、またはミラー・ジャーナル・ファイルをリストアしない場合は、no と入力するかまたは <Enter> キーを押して、ここで説明する手順を引き続き使用します。

3. 既にジャーナル・フィルタが存在する場合 ("^ZJRNFILT を使用したジャーナル・レコードのフィルタ処理" を参照)、これらのフィルタを使用するかどうかを指定します。

   Use current journal filter (ZJRNFILT)? 
   Use journal marker filter (MARKER^ZJRNFILT)? 
   
   

   

4. ジャーナリングされているグローバルのすべてを現在の InterSystems IRIS インスタンスのすべてのデータベースにリストアするか、または 1 つ以上のデータベースを指定し、必要に応じて、それぞれのデータベースにリストアするグローバルを指定するかを選択します。

   Process all journaled globals in all directories? 
   
   

   

   • 現在のインスタンスのすべてのデータベースにすべてのグローバルをリストアする場合、「Yes」と入力します。

   • 現在のインスタンスまたは別のインスタンスの選択したデータベースのみにリストアする場合、「No」と入力するか、<Enter> キーを押します。以下の手順を実行します。

     • 現在のシステムのオペレーティング・システムと異なるオペレーティング・システムでジャーナル・ファイルを作成したかどうかを示します。リストア先のデータベースに指定するディレクトリ・パスはジャーナル・ファイルのパス (キャノニック形式) と正確に一致している必要があるため、これは重要なことです。「No」と応答した場合、^JRNRESTO は、入力したディレクトリ・パスがジャーナル・ファイルのパスと一致するように、ディレクトリ・パスを現在のオペレーティング・システムのキャノニック形式にします。「Yes」と応答した場合、^JRNRESTO は、ジャーナル・ファイルのキャノニック形式と現在のシステムのキャノニック形式が異なるため、入力したパスを正規化しません。後者の場合、注意深くジャーナル・ファイルのオペレーティング・システムに対して適切なキャノニック形式でディレクトリ・パスを入力し、両方が一致するようにする必要があります。

       以下に例を示します。

       • Windows システムで作業をしていて、このプロンプトで「No」を入力し、パス c:\intersystems\iris\mgr\user を入力すると、^JRNRESTO は、これを自動的に c:\intersystems\iris\user\ に正規化し、Windows システムで作成されたジャーナル・ファイルと一致させます。

       • Unix® システムで作業していて、ジャーナル・ファイルを Windows システムで作成したためにこのプロンプトで「Yes」と入力した場合、キャノニック形式のパス c:\intersystems\iris\mgr\user\ を入力し、ジャーナル・ファイルと一致させる必要があります。これは、^JRNRESTO がパスを正規化できないためです。

     • ディレクトリ・パスを入力してリストアする各データベースを指定します。これは、ジャーナル・レコードの取得元のソース・データベースを示します。Redirect to directory プロンプトで <Enter> キーを押し、ソースとターゲットが同じであることを示し、グローバル更新をソース・データベースにリストアします。別のデータベースにリストアしている場合 (例えば、ソース・データベースをバックアップから別のシステムにリストアしたため)、ターゲット・データベースのディレクトリ・パスを入力します。

       ミラー・ジャーナル・ファイルをミラーリングされないデータベースにリストアする場合は、Directory to restore プロンプトで、以下のいずれかを実行します。

       • ソース・データベースのディレクトリ・パスを入力してから、<Enter> キーを押すかまたはターゲットのミラーリングされないデータベースのディレクトリ・パスを入力します (前述の説明を参照)。

       • ミラーリングされるソース・データベースの大文字と小文字を区別した完全なミラー・データベース名を入力します (例えば、:mirror:JLAP:MIRRORDB)。これを見つけるには、^MIRROR ユーティリティの [ミラー・ステータス] メニューにある [ミラーリングされるデータベースを一覧表示] オプションを使用します。その後、ターゲットのミラーリングされないデータベースのディレクトリ・パスを指定します。

       Note:

       ミラー・ジャーナル・ファイルをミラーリングされるデータベースにリストアする場合、この手順ではここまでは説明しません。"MirrorCatchup^JRNRESTO を使用したミラーリングされるデータベースへのジャーナルのリストア" を参照してください。

     • 指定した各データベースについて、すべてのグローバルの更新をリストアするか、またはリストアする 1 つ以上のグローバルを入力するかを確認します。

     • すべてのデータベースを入力した場合、Directory to restore プロンプトで <Enter> キーを押し、指定したデータベースおよびグローバルのリストを確認します。

     以下に例を示します。

     Process all journaled globals in all directories? no
     Are journal files imported from a different operating system? No => No
      
     Directory to restore [? for help]: c:\intersystems\test23\mgr\user\
     Redirect to Directory: c:\intersystems\test23\mgr\user\
      => --> c:\intersystems\test23\mgr\user\
     Process all globals in c:\intersystems\test23\mgr\user\? No => yes
      
     Directory to restore [? for help]: c:\intersystems\test23\mgr\data\
      Redirect to Directory: c:\intersystems\test23\mgr\data\
      => --> c:\intersystems\test23\mgr\data\
     Process all globals in c:\intersystems\test23\mgr\data\? No => no
     
     Global ^Survey.LastName
     Global ^Survey.ID
     Global ^
     
     Directory to restore [? for help]:
     
     Processing globals from the following datasets:
      1. c:\intersystems\test23\mgr\user\   All Globals
      2. c:\intersystems\test23\mgr\data\   Selected Globals:
               ^Survey.LastName
               ^Survey.ID
     
     Specifications correct? Yes =>  Yes
     
     

     
     Note:

     複数のデータベースを同じディレクトリにリダイレクトする場合は、同じグローバル選択を行う必要があります。つまり、対象のデータベースすべてについて、「yes」と入力し、すべてのグローバルを処理するか、「no」と入力し、処理するグローバルの同一リストを指定します。複数のデータベースを 1 つのディレクトリにリストアする場合にグローバル選択がすべて同じでないと、データベースのリダイレクトとグローバル選択を変更するか、処理をキャンセルするよう求められます。

5. 正しいジャーナル履歴ログ ("ジャーナル履歴ログ" を参照) を指定して、リストア元 (リストアしているソース・データベースと同じ InterSystems IRIS インスタンス) のジャーナル・ファイルを指定します。

   • プロンプトで「yes」と入力するかまたは <Enter> キーを押し、現在の InterSystems IRIS インスタンスのジャーナル履歴ログを使用して、処理するジャーナル・ファイルを特定します。例えば、プロセスの最初に Process all journaled globals in all directories? プロンプトで「yes」と入力した場合、ここで「yes」と入力し、現在のインスタンスのジャーナル・ファイルから現在のインスタンスのすべてのデータベースをリストアします。

   • Process all journaled globals in all directories? プロンプトで「no」と入力し、別の InterSystems IRIS インスタンスのデータベースを指定した場合、ここで「no」と入力し、そのインスタンス (またはそのインスタンスからコピーしたファイル) のジャーナル履歴ログおよびジャーナル・ファイルのディレクトリ・パスを指定し、そのインスタンスのジャーナル・ファイルからデータベースをリストアできるようにします。

     Important:

     別の InterSystems IRIS インスタンスからジャーナル履歴ログを使用している場合、実際のログではなくファイルのコピーを使用する必要があります。

     以下はその例です。

     If you have a copy of the journal history log file from the 
     instance where the journal files were created, enter its full path below;
     otherwise, press ENTER and continue.
     Journal history log: c:\InterSystems\IRIS23_journals\journal.log
     
     Specify the location of the journal files to be processed
     Directory of the journal files:  c:\InterSystems\IRIS23_journals\journal\
     Directory of the journal files: 
     
     

     

6. 処理対象とするジャーナル・ファイルの範囲を指定します。以下の点に注意してください。

   • リストアされたバックアップ以後に InterSystems IRIS が複数のジャーナル・ファイルに切り替えた場合、最も古いジャーナル・ファイルから順番に、最新のものまでをリストアする必要があります。例えば、リストアする必要がある 3 つのジャーナル・ファイル 20230214.001、20230214.002、20230215.001 がある場合、以下の順番でリストアする必要があります。

     20230214.001

     20230214.002

     20230215.001

   • オンライン・バックアップでバックアップすると、リストア時のトランザクション・ロールバックに必要な最も古いジャーナル・ファイルに関する情報が 3 番目または最後のパスの開始時に表示され、バックアップ・ログにも格納されます。詳細は、"バックアップとリストア" を参照してください。

   以下のようにプロンプトに応答してください。

   • このインスタンスがジャーナル・ファイルを作成するかどうかに関する前述のプロンプトで「yes」と入力した場合、または「no」と応答してから別のインスタンスのジャーナル履歴ログおよびジャーナル・ファイルの場所を指定した場合、処理する最初のジャーナル・ファイルおよび最後のジャーナル・ファイルのパス名を入力できます。いずれのプロンプトにも「?」を入力して、指定した場所にあるファイルの番号付けされたリストを確認し、ファイルの番号を入力できます。以下はその例です。

     Specify range of files to process
     Enter ? for a list of journal files to select the first and last files from
     First file to process:  ?
      
     1) c:\intersystems\iris2\mgr\journal\20230212.001
     2) c:\intersystems\iris2\mgr\journal\20230213.001
     3) c:\intersystems\iris2\mgr\journal\20230214.001
     4) c:\intersystems\iris2\mgr\journal\20230214.002
     5) c:\intersystems\iris2\mgr\journal\20230215.001
     6) c:\intersystems\iris2\mgr\journal\20230216.001
     7) c:\intersystems\iris2\mgr\journal\20230217.001
     8) c:\intersystems\iris2\mgr\journal\20230217.002
     
     First file to process:  5 c:\intersystems\iris2\mgr\journal\20230215.001
     Final file to process:
       c:\intersystems\20231316mar14\mgr\journal\20230217.002 => 
     
     Prompt for name of the next file to process? No => no
     
     

     

   • このインスタンスがジャーナル・ファイルを作成するかどうかに関する前述のプロンプトで「no」を入力し、ジャーナル履歴ログを指定しなかった場合、処理する特定のジャーナル・ファイルを特定しようとするプロンプトで処理が続行されます。以下に例を示します。

     Journal history log:
     Specify range of files to process (names in YYYYMMDD.NNN format)
      
     from:     <20230212.001> [?] => 20230215.001
      
     through:  <20230217.001> [?] => 20230217.002
      
     Prompt for name of the next file to process? No => no
      
     Provide or confirm the following configuration settings:
      
     Journal File Prefix: [?] =>
      
     Files to dejournal will be looked for in:
          c:\intersystems\iris\mgr\journal\
     in addition to any directories you are going to specify below, UNLESS
     you enter a minus sign ('-' without quotes) at the prompt below,
     in which case ONLY directories given subsequently will be searched
     
     Directory to search: {return when done} -
          [Directory search list is emptied]
     Directory to search: {return when done} c:\intersystems\iris2\mgr\journal
     Directory to search: {return when done}
     Here is a list of directories in the order they will be searched for files:
          c:\intersystems\iris2\mgr\journal\
     
     

     

7. 以下のようにジャーナル・ファイルを処理します。

   Prompt for name of the next file to process? No => No 
   The following actions will be performed if you answer YES below:
    
   * Listing journal files in the order they will be processed
   * Checking for any missing journal file on the list ("a broken chain")
    
   The basic assumption is that the files to be processed are all
   currently accessible. If that is not the case, e.g., if you plan to
   load journal files from tapes on demand, you should answer NO below.
   Check for missing journal files? Yes => Yes
   
   

   

8. 指定した範囲内で 1 つまたは複数のジャーナル・ファイルが見つからない場合は、操作の中止を選択できます。操作を中止しなかった場合、またはファイルがすべて見つかった場合は、処理が続行され、リストアを開始する前にジャーナルの整合性をチェックする機会が得られます。

   Journal files in the order they will be processed:
   1. c:\intersystems\iris2\mgr\journal\20230215.001
   2. c:\intersystems\iris2\mgr\journal\20230216.001
   3. c:\intersystems\iris2\mgr\journal\20230217.001
   4. c:\intersystems\iris2\mgr\journal\20230217.002
   
   While the actual journal restore will detect a journal integrity problem
   when running into it, you have the option to check the integrity now
   before performing the journal restore. The integrity checker works by
   scanning journal files, which may take a while depending on file sizes.
   Check journal integrity? No => No
   
   

   

9. 現在のジャーナル・ファイルがリストアに含まれている場合は、ジャーナリングを別のファイルに切り替える必要があり、そのためのプロンプトが表示されます。

   The journal restore includes the current journal file.
   You cannot do that unless you stop journaling or switch
        journaling to another file.
   Do you want to switch journaling? Yes => yes
   Journaling switched to c:\intersystems\iris2\mgr\journal\20230217.003
   

   

10. 次に、リストア中に更新のジャーナリングを無効にし、処理を高速化するかどうかを選択します。

    You may disable journaling of updates for faster restore for all
    databases other than mirrored databases. 
    Do you want to disable journaling the updates? Yes => yes
    Updates will NOT be journaled
    
    

    
    Important:

    リストア中の更新のジャーナリングを無効化していないと、このセクションの冒頭で説明したように、パフォーマンスを向上するための並列デジャーナリングが使用されなくなります。

    ジャーナリングが無効になっている状態でデータベースの更新を継続すると、下記のいずれかを確実にしない限り、最新の良好なジャーナルを使用して手動でリストアすることはできなくなります。

    • 更新される内容を正確に把握し、アプリケーションの要件を満足するためにリストアされる内容を管理できます。

    • 関連するデータベースを最後のバックアップからリストアしたうえで、ジャーナルを適用すると、ジャーナルが無効な状態で書き込まれたデータが喪失することを容認します。

    このような状況では、ジャーナルのリストア完了後に下記のコマンドを実行し、オブジェクト ID が同期していることを確認することをお勧めします。同期していないことが判明した ID のみが配列 errors にレポートされます。

    Do CheckIDCounters^%apiOBJ(.errors)
    zwrite errors
    

    

11. リストア・ジョブのエラー発生時の既定の動作を確認または変更した後、リストアを開始することを確認します。

    Before we job off restore daemons, you may tailor the behavior of a
    restore daemon in certain events by choosing from the options below:
     
         DEFAULT:    Continue despite database-related problems (e.g., a target
         database cannot be mounted, error applying an update, etc.), skipping
         updates to that database. Affected database(s) may not be self-consistent
         and will need to be recovered separately
     
         ALTERNATE:  Abort if an update would have to be skipped due to a
         database-related problem (e.g., a target database cannot be mounted,
         error applying an update, etc.). Databases will be left in a
         self-consistent state as of the record that caused the restore to be
         aborted. Parallel dejournaling will be disabled with this setting  
    
         DEFAULT:    Abort if an update would have to be skipped due to a
         journal-related problem (e.g., journal corruption, some cases of missing
         journal files, etc.)
     
         ALTERNATE:  Continue despite journal-related problems (e.g., journal
         corruption, some missing journal files, etc.), skipping affected updates
     
    Would you like to change the default actions? No => No
      
    Start the restore? Yes =>
    

    
    Important:

    データベース関連の問題が原因で中断しないようにする場合は、このセクションの冒頭で説明したように、パフォーマンスを向上させるための並列デジャーナリングが使用されなくなります。

12. ジャーナル・リストアの進行状況は間隔をおいて表示され、ジョブが完了すると、このリストアによって更新されたデータベースのリストが表示されます。

    c:\MyIRIS1\mgr\journal\20230406.001
     35.73%  70.61% 100.00%
    c:\MyIRIS1\mgr\journal\20230406.002
     35.73%  70.61% 100.00%
    c:\MyIRIS1\mgr\journal\20230406.003
     100.00%
    [Journal restore completed at 20230407 02:25:31]
     
    The following databases have been updated:
    
    1. c:\MyIRIS1\mgr\source22\
    2. c:\MyIRIS1\mgr\source23\
    3. c:\MyIRIS1\mgr\irislocaldata\
    4. c:\MyIRIS1\mgr\irislib\
    5. c:\MyIRIS1\mgr\iristemp\
    
    The following databases have been skipped:
    
    1. /bench/user/InterSystems/IRIS/162/
    2. /scratch1/user/InterSystems/IRIS/p750.162/mgr/
    3. /scratch1/user/InterSystems/IRIS/p750.162/mgr/irislocaldata/
    4. /scratch1/user/InterSystems/IRIS/p750.162/mgr/irislib/
    5. /scratch1/user/InterSystems/IRIS/p750.162/mgr/iristemp/
    6. /scratch1/user/InterSystems/IRIS/p750.162/mgr/user/
    

    

13. オープン・トランザクションがある場合、リストアの最後に、不完全トランザクションのロールバックを求める以下のようなプロンプトが表示されます。

    Rollback incomplete transactions? No =>
    

    

    このプロンプトは、リストアされたデータベースに不完全トランザクションがある場合にのみ表示されます。詳細は、"不完全トランザクションのロールバック" を参照してください。

^ZJRNFILT を使用したジャーナル・レコードのフィルタ処理

ジャーナル・ファイルの操作のためにジャーナル・フィルタ・メカニズムが用意されています。ジャーナル・フィルタ・プログラムは、^ZJRNFILT と呼ばれ、ユーザが記述する下記の形式のルーチンです。これは、InterSystems IRIS のジャーナル・リストア・プログラム ^JRNRESTO から呼び出され、選択したレコードのみをリストアします。^ZJRNFILT ルーチンは、次の形式を使用して生成します。

ZJRNFILT(jidsys,dir,glo,type,restmode,addr,time)

引数	タイプ	説明
jidsys	入力	コンマで区切られた 2 つのコンポーネント ： jid (ジョブ ID) と remsysid (ECP の場合のみ)。 jidsys を %SYS.Journal.Record.GetRealPIDSYSinFilterOpens in a new tab メソッドに渡して (以下の “^ZJRNFILT Examples” に示すように)、ジャーナルを生成した PID (プロセス ID) を特定します。
dir	入力	リストアする IRIS.DAT ファイルが格納されたディレクトリのフル・パス名。ジャーナル・レコードでの指定と同じにする必要があります。
glo	入力	ジャーナル・レコードのグローバル。
type	入力	ジャーナル・レコードのコマンド・タイプ (Set の場合は S、Kill の場合は K)。
addr	入力	ジャーナル・レコードのアドレス
time	入力	レコードのタイムスタンプ ($horolog 形式)。これは、ジャーナル・バッファの作成時刻であり、Set 処理や Kill 処理が実行された時刻ではありません。つまり、この特定の処理が最も早く実行された時刻を示しています。
restmode	出力	0 - レコードをリストアしません。 1 - レコードをリストアします。

^ZJRNFILT の考慮事項

^ZJRNFILT を使用するときは、以下の点を考慮してください。

• スタートアップ・ルーチン (^STU) で ^JRNRESTO を呼び出す場合は、どのような状況でもフィルタ・ルーチンを呼び出すことはありません。

• ジャーナルのリストアでジャーナル・フィルタ (^ZJRNFILT) が呼び出されるのは、それが存在する場合のみです。ジャーナル・フィルタが存在する場合は、リストア処理でそのフィルタを使用するかどうかを指定するようにリストア手順で求められます。

• リストアするジャーナル・ファイルのすべてのレコードに対してジャーナル・フィルタを使用することを指定すると、ここに示した入力引数を使用してジャーナル・フィルタ ^ZJRNFILT が呼び出されるので、現在のレコードをリストアするかどうかを指定します。

• ^ZJRNFILT ルーチンでは、あらゆるロジックを使用して、レコードをリストアするかどうかを指定できます。出力引数 restmode を使用して操作の確認が返されます。

• ^ZJRNFILT ルーチンのロジックでディレクトリ名 dir を使用する場合は、完全ディレクトリ・パス名で指定します。

• グローバル参照全体が、プログラムのロジックで使用するために ^ZJRNFILT に渡されます。

• ジャーナルのリストア処理が完了すると、^ZJRNFILT ルーチンの名前を変更するか、そのルーチンを削除するかの確認を求められます。フィルタの名前変更を選択すると、フィルタの名前は ^XJRNFILT に変更され、元の ^ZJRNFILT は削除されます。

• ^ZJRNFILT ルーチンにエラーが発生すると、リストア処理が中止され、対応するメッセージが表示されます。

^ZJRNFILT の例

2 つのグローバル、^ABC および ^XYZ がジャーナリングの対象となっています。ジャーナリングが有効になっている間、以下のコードが実行され、ジャーナル・ファイルには、この 2 つのグローバルに対する Set 処理および Kill 処理が記録されます。

 For I=1:1:500 Set ^ABC(I)=""
 For I=1:1:500 Set ^XYZ(I)=""
 For I=1:1:100 Kill ^ABC(I)

1. ^ABC のみのレコードをすべてリストアする場合、^ZJRNFILT ルーチンは以下のようになります。

   ZJRNFILT(jidsys,dir,glo,type,restmode,addr,time)    /*Filter*/
    Set restmode=1                                  /*Return 1 for restore*/
    If glo["XYZ" Set restmode=0                     /*except when it is ^XYZ*/
    Quit
    ; 

   

2. ^ABC に対する kill 処理以外のレコードをすべてリストアする場合、^ZJRNFILT ルーチンは以下のようになります。

   ZJRNFILT(jidsys,dir,glo,type,restmode,addr,time)    /*Filter*/
    Set restmode=1                                  /*Return 1 for restore*/
    If glo["^ABC",type="K" Set restmode=0           /*except if a kill on ^ABC*/
    Quit
    ;
   

   

3. jid が PID やミラー・メンバに対するものである場合のように、remsysid が実際の ECP システム ID ではないこともあります。そのような場合は、%SYS.Journal.Record.GetRealPIDSYSinFilterOpens in a new tab メソッドを使用して、実際の PID と同時に実際の ECP システム ID も返されるようにします。

   実際の PID (および ECP システム PID) をフィルタで得るには、次のような ^ZJRNFILT ルーチンを使用します。

   ZJRNFILT(jidsys,dir,glo,type,restmode,addr,time) ;
    SET restmode=0 ;test only
    SET pid=##class(%SYS.Journal.Record).GetRealPIDSYSinFilter(jidsys,.ecpsysid)
    DO ##class(%SYS.System).WriteToConsoleLog($SELECT(pid="":"jid="_+jidsys,1:"pid="_pid)_",ecpsysid="_ecpsysid)
    QUIT

   

4. 特定の時刻以降のレコードをすべてリストアする場合、^ZJRNFILT ルーチンは以下のようになります。

   ZJRNFILT(jidsys,dir,glo,type,restmode,addr,time) ;
    New zdh 
    Set zdh=$zdatetimeh("08/14/2015 14:18:31") ;in $H format as variable 'time'
    If time>zdh Set restmode=1 Quit
    If time<zdh Set restmode=0 Quit
    If $p(time,",",2)<$p(zdh,",",2) {
     Set restmode=0
    } Else {
       Set restmode=1
    }
    Quit
   

   

^JRNDUMP を使用したジャーナル・レコードの表示

ジャーナル・ファイルのレコードを表示するには、^JOURNAL メニューのオプション・プロンプトで「5」を入力するか、または以下の例に示すように、^JRNDUMP を実行します。

1. システム管理者のネームスペースから ^JRNDUMP ユーティリティを実行するには、次のように入力します。

   %SYS>DO ^JRNDUMP
   

   

      Journal                 Directory & prefix
    
      20231113.001            C:\MyIRIS\Mgr\Journal\
      20231113.002 [JRNSTART] C:\MyIRIS\mgr\journal\
      20231113.003            C:\MyIRIS\mgr\journal\
      20231113.004            C:\MyIRIS\mgr\journal\
      20231114.001            C:\MyIRIS\mgr\journal\
      20231115.001            C:\MyIRIS\mgr\journal\
      20231115.002            C:\MyIRIS\mgr\journal\
      20231115.003            C:\MyIRIS\mgr\journal\
   >  20231115.004            C:\MyIRIS\mgr\journal\
    
   
   

   

2. このルーチンは、ジャーナル・ファイルのリストを表示します。現在選択しているファイルの左側に大なり記号 (>) が表示され、その後に以下のプロンプトが表示されます。

   Pg(D)n,Pg(U)p,(N)ext,(P)rev,(G)oto,(E)xamine,(Q)uit =>
   
   

   

   これらのオプションを使用して、目的のジャーナル・ファイルに移動します。

   • インスタンスがミラー・メンバの場合、M と入力してミラー・ジャーナル・ファイルのみにリストを制限します。(ミラー・ジャーナル・ファイルの詳細は、"ジャーナル・ファイルとジャーナル履歴ログ" および "ミラー同期" を参照してください。)

   • ジャーナル・ファイル・リストの表示ページを変更するには、「D」または「U」を入力します。

   • 必要なジャーナル・ファイルに > を移動するには、「N」または「P」を入力します。

   • 表示するジャーナル・ファイルのフル・パス名を直接入力するには、「G」を入力します。

   • 選択したジャーナル・ファイルの内容を表示するには、「E」を入力します。

   • 選択されたジャーナル・ファイルに関する情報、および必要に応じてジャーナルのデータベースのリストを表示するには、「I」を入力します。

   • ルーチンを終了するには、「Q」を入力するか、Enter キーを押します。

3. 「I」の入力時、現在選択されているジャーナル・ファイルを受け入れた場合、または別のジャーナル・ファイルを指定した場合、以下のような情報が表示されます。

   Journal: C:\MyIRIS\mgr\journal\20231113.003
   File GUID: 97734819-CA75-4CB1-9C3E-74D294784D23
   Max Size: 1073741824
   Time Created: 2023-11-13 10:44:52
   File Count: 22
   Min Trans: 22,3497948
   Prev File: C:\MyIRIS\mgr\journal\20231113.002
   Prev File GUID: 8C5D3476-F12C-4258-BF6C-7423876653A4
   Prev File End: 0
   Next File: C:\MyIRIS\mgr\journal\20231113.004
   Next File GUID: 4F4D20B1-D38C-473E-8CF0-4D04C6AF90B0
   
   (D)atabases,(Q)uit =>
   

   

   [最小トランザクション] は、ファイル数および最小トランザクションの位置のオフセットです (開いているトランザクションは、すべてこの時点以降から開始しています)。

   選択されているファイルがミラー・ジャーナル・ファイルである場合、追加情報が表示されます。

   下部のプロンプトで「Q」を入力すると、ジャーナル・ファイル・リストが返されます。「D」を入力すると、以下のようなデータベース情報が表示されます。

   Journal: C:\MyIRIS\mgr\journal\20231113.003
     sfn  Directory or Mirror DB Name
   ==========================================================================
       0  C:\MyIRIS\mgr\
       1  C:\MyIRIS\mgr\irislib\
       2  C:\MyIRIS\mgr\iristemp\
       3  :mirror:MIR:MIRTEST
       5  C:\MyIRIS\mgr\irislocaldata\
       6  C:\MyIRIS\mgr\user\
    
   (P)rev,(N)ext,(Q)uit =>
   

   

   「Q」を入力すると、ジャーナル・ファイル情報の画面に戻ります。

4. 「G」または「E」を入力すると、ユーティリティにはそのジャーナル・ファイル名が表示され、オフセット・アドレス別にファイルの内容のリスト生成が開始されます。以下に例を示します。

   Journal: C:\MyIRIS\mgr\journal\20230330.002
      Address   Proc ID Op Directory        Global & Value
   ===============================================================================
       131088      2980 S  C:\MyIRIS\mgr\  SYS("shdwcli","doctest","remend") = 1+
       131156      2980 S  C:\MyIRIS\mgr\  SYS("shdwcli","doctest","end") = 1013+
       131220      2980 S  C:\MyIRIS\mgr\  SYS("shdwcli","doctest","jrnend") = 1+
   ...
   
   

   

5. 現在のリスト表示ページの下部には、そのジャーナル・ファイルに関する情報と以下のプロンプトが表示されます。

   Last record:     573004;   Max size: 1073741824
   (N)ext,(P)rev,(G)oto,(F)ind,(E)xamine,(Q)uit =>
   
   

   

   これらのオプションを使用して、表示するジャーナル・レコードに移動します。

   • アドレスの次のページまたは前のページを表示するには、「N」または「P」を入力します。

   • 特定のアドレスに表示を移動するには、「G」を入力します。

   • ジャーナル・ファイル内の特定の文字列を検索するには、「F」を入力します。

   • ジャーナル・レコードのアドレスを入力してその内容を表示するには、「E」を入力します。

   • ジャーナル・ファイルのリストに戻るには、「Q」を入力します。

6. 「E」または「G」を入力した後、プロンプトでアドレスを入力します。E オプションでは、入力したアドレスのジャーナル・レコードの内容、またはそのアドレス周辺のジャーナル・レコードの内容が表示されます。G オプションでは、そのアドレスを先頭とするジャーナル・レコードのページが表示されます。

   いずれのオプションでも、指定したオフセット・アドレスに最も近いレコードが探し出されます。ジャーナル・レコードの有効なアドレスを指定する必要はありません。また、ジャーナル・ファイルの先頭に移動するには、「0」(ゼロ) を入力します。ジャーナル・ファイルの末尾に移動するには、「-1」を入力します。

7. 「N」を入力すると、次のページにあるジャーナル・レコードの内容が表示され、「P」を入力すると、前のページにあるジャーナル・レコードの内容が表示されます。レコードの表示を終了するには、プロンプトで「Q」を入力し、ジャーナル・レコードのリストに戻ります。

ジャーナル・レコードには、さまざまな種類があります。

• ジャーナル・ヘッダの長さは 8192 バイトですヘッダは、各ジャーナル・ファイルの先頭に一度出現します。^JRNDUMP ユーティリティは、ジャーナル・ヘッダ・レコードを表示しません。

• ジャーナル・データ・レコード。

• ジャーナル・マーカ

以下は、^JRNDUMP で表示されるジャーナル・ファイル・データ・レコードのサンプルです。例では、Set コマンドの記録方法を示しています。Set がトランザクションの範囲外に発生したため、新しい値は記録されますが、古い値は記録されません。

Journal: C:\MyIRIS\mgr\journal\20230119.004
 
Address:                 233028
Type:                    Set
In transaction:          No
Process ID:              4836
ECP system ID:           0
Time stamp:              60284,53240
Collation sequence:      5
Prev address:            232984
Next address:            0
 
Global:    ^["^^C:\MyIRIS\mgr\"]ABC
New Value: 2
 
 
(N)ext,(P)rev,(Q)uit =>

トランザクションで古い値も記録し、以下の 2 番目の例に示すように、トランザクション・ロールバックを許可します。

Journal: C:\MyIRIS\mgr\journal\20231115.004
 
Address:                 204292
Type:                    Set
In transaction:          Yes
Process ID:              458772
ECP system ID:           0
Time stamp:              60584,52579 - 11/15/2023 14:36:19
Collation sequence:      5
Prev address:            204224
Next address:            204372 

Global:    ^["^^C:\MyIRIS\mgr\"]ABC
New Value: 5
Old Value: 2
 
 
(N)ext,(P)rev,(Q)uit =>

以下は、インクリメンタル・バックアップにより作成されたジャーナル・マーカ・レコードの例です。

Journal: C:\MyIRIS\mgr\journal\20231115.004
 
Address:                 210848
Type:                    JrnMark
Marker ID:               -1
Marker text:             NOV 15 2023;03:14PM;Incremental
Marker seq number:       1
Prev marker address:     0
Time stamp:              60584,52579 - 11/15/2023 14:36:19
Prev address:            210744
Next address:            210940
 
 
 
(N)ext,(P)rev,(Q)uit =>

以下のテーブルは、ジャーナル・データ・レコードのそれぞれのフィールドです。

以下のテーブルでは、^JRNDUMP ジャーナル・ファイルの表示の [Op] 列および ^JRNDUMP ジャーナル・レコード・リストの [タイプ] フィールドに表示されるジャーナル処理のリストを示し、説明します。例えば、ジャーナル・ファイルの表示の前述の例では、[Op] 列の [S] が JRNSET 処理を表すのに対し、ジャーナル・レコードの表示の例では、[Type] フィールドに表示される [Set] が JRNSET 処理を表します。管理ポータルのジャーナル・レコード表示の [タイプ] 列 ("ジャーナル・ファイルの表示" を参照) は、いくつかの処理の点で ^JRNDUMP リストの [タイプ] フィールドと異なります。例えば、JRNSET 処理は、ポータルでは RemoteSET で示され、^JRNDUMP 出力では NSet で示されます。これらの違いをテーブルに示します。

このテーブルでは、SELECT^JRNDUMP 関数の使用時に、処理に基づいてジャーナル・レコードをフィルタ処理するために指定できるコードも示します。

1 「T」は、トランザクション内で処理が実行されるときに付加されます。例えば、「ST」はトランザクション内の Set 処理を表し、「kT」はトランザクション内の ZKill 処理を表します。

2 ジャーナル・リストア中は処理が無視されます。

ダンプするジャーナル・レコードの選択

SELECT^JRNDUMP 関数は、ジャーナル・ファイルの任意のレコードまたはすべてのレコードを表示します。この関数に渡した引数に基づき、ジャーナル・ファイルの選択したレコードがファイルの先頭から順にダンプされます。

^JRNDUMP ユーティリティの SELECT エントリ・ポイントを使用する構文は、以下のようになります。

SELECT^JRNDUMP(%jfile,%pid,%dir,%glo,%gloall,%operation,%remsysid)

引数	説明
%jfile	ジャーナル・ファイル名。既定では現在のジャーナル・ファイルです。完全修飾パスでジャーナル・ファイルを指定する必要があります。
%pid	ジャーナル・レコードのプロセス ID。既定では任意のプロセスです。
%dir	ジャーナル・レコードのディレクトリ。既定では任意のディレクトリです。
%glo	ジャーナル・レコードのグローバル参照。既定では任意のグローバルです。
%gloall	glo で指定した名前を含むすべてのグローバル・ノードに関連するエントリを列挙するかどうかを指定するグローバル・インジケータ。0 — glo で指定した名前に完全一致するグローバル参照。1 — 部分一致。glo で指定した名前を使用しているグローバル参照を持つすべてのレコード。既定値は 0 です。
%operation	ジャーナル・レコードの処理タイプ。既定では任意の処理です。"ジャーナル・ファイルの処理" のテーブルにリストされている数値コードまたはアルファベット・コードを使用します。
%remsysid	ジャーナル・レコードの ECP システム ID。既定では任意のシステムです。1

1 %pid が指定されている場合、既定では %remsysid はローカル・システム (0) に設定されます。それ以外の場合は、0 に指定されている場合と同様に、既定では任意のシステムに設定されます。つまり、ローカル・システムのみからジャーナル・エントリを選択することはできません。

引数として NULL 文字列を渡すことができます。この場合、ルーチンはそれぞれの既定値を使用します。

ターミナルのその他の関数と同様に、Device: プロンプトを使用して、SELECT^JRNDUMP の出力先をターミナル以外のデバイス、またはファイルに指定できます。(ユーザによるデバイスの選択の詳細は、"入出力の概要" を参照してください。)出力先をファイルに指定した場合、パラメータの入力を求められます。ファイルに書き込む場合は、R と W を含める必要があります。既存のファイルの場合は、A を含めることで、既存の内容に出力が上書きされるのではなく、追加されます。新しいファイルの場合は、N を指定する必要があります。Parameters? プロンプトで「?」を入力すると、すべての利用可能な選択肢を表示できます。

Note:

上書き先のファイルが現在の出力よりも長い場合、元のファイルの余分な行が更新されたファイルから削除されない場合があります。

SELECT^JRNDUMP の例

以下の例では、特定のジャーナル・レコードを選択するためのさまざまな方法を示します。

プロセス ID が 1203 のジャーナル・ファイル内のすべてのレコードを選択して、JRNDUMP.OUT という名前の新しいファイルに出力を送信する場合は、以下のようになります。

%SYS>Do SELECT^JRNDUMP("C:\MyIRIS\mgr\journal\120020507.009","1203")

Device: SYS$LOGIN:JRNDUMP.OUT   
Parameters: "RWN"=>

グローバル参照 ^ABC を含むジャーナル・ファイルのすべてのレコードを選択する場合は、以下のようになります。

DO SELECT^JRNDUMP("C:\MyIRIS\mgr\journal\20050327.001","","","^ABC",1)

グローバル参照 ^ABC に完全に一致するレコードのみを選択する場合は、以下のようになります。

DO SELECT^JRNDUMP("C:\MyIRIS\mgr\journal\20050327.001","","","^ABC",0)

Note:

^ABC(1) または ^ABC(100) など、完全には一致しないレコードは選択されません。

グローバル ^ABC に対するローカルの Set 処理のレコードのみを選択する場合は、以下のようになります。

DO SELECT^JRNDUMP("C:\MyIRIS\mgr\journal\20050327.001","","","^ABC","","6")

グローバル ^ABC に対するローカルおよびリモートの Set 処理のレコードのみを選択する場合は、以下のようになります。

DO SELECT^JRNDUMP("C:\MyIRIS\mgr\journal\20050327.001","","","^ABC","","s")

PURGE^JOURNAL を使用したジャーナル・ファイルの削除

ファイルを削除するには、以下の例に示すように、PURGE^JOURNAL ルーチンを使用するか、または ^JOURNAL メニューのオプション・プロンプトで「6」を入力します。

PURGE^JOURNAL を直接実行する例

set $namespace="%SYS"
%SYS>Do PURGE^JOURNAL

^JOURNAL メニューからジャーナリングを開始する例

%SYS>Do ^JOURNAL
 
 ...
 6) Purge Journal Files (PURGE^JOURNAL)
 ...
Option? 6

1) Purge any journal NOT required for transaction rollback or crash recovery
2) Purge journals based on existing criteria (2 days or 2 backups)
 
Option?

このルーチンは、指定したオプションに対応して実行されるアクションについて報告します。以下に例を示します。

Option? 1

The following files have been purged (listed from latest to oldest):

3. c:\intersystems\iris\mgr\journal\20230714.001
2. c:\intersystems\iris\mgr\journal\20230713.001
1. c:\intersystems\iris\mgr\journal\20230710.003

削除するファイルがない場合、以下のメッセージが表示されます。

None purged

^JRNOPTS を使用したジャーナル設定の更新

管理ポータルの [ジャーナル設定] ページを使用する代わりに、^JRNOPTS ルーチンを使用するか、^JOURNAL メニューのオプション・プロンプトで「7」を入力して基本的なジャーナル構成設定を更新できます。設定を変更するには、プロンプトで新しい値を入力して、Enter キーを押します。以下に例を示します。

SYS>Do ^JRNOPTS
 
1) Primary Journal Directory: C:\MyIRIS\Mgr\Journal\
2) Alternate Journal Directory: D:\irissys\altjournal\ 
3) Journal File Size Limit (MB) 1024
4) Journal File Prefix: 
5) Journal Purge Options: 2 days OR 2 backups, whichever comes first
6) Compress Journal files: Yes

疑問符 (?) を入力すると、ヘルプが表示されます。以下に例を示します。

Journal File Prefix: ?
  Enter an alphanumeric string ('_' allowed) or . to reset prefix to null

設定を変更し、Change Property? プロンプトで Enter キーを押すと、変更内容が有効になります。

Change Property?
Save and activate changes? Yes =>
*** Journal options updated.

設定を変更しない場合、以下のメッセージが表示されます。

  
*** Nothing changed

ENCRYPT^JOURNAL を使用したジャーナルの暗号化

オプション 8) ジャーナルの暗号化の有効化と無効化 (ENCRYPT^JOURNAL) の詳細は、ジャーナル・ファイルの暗号化について詳しく説明している "暗号化の起動設定の構成" を参照してください。

Status^JOURNAL によるジャーナルの状態の表示

オプション 9) ジャーナルの状態の表示を選択すると、ジャーナルの状態に関する次の簡単な説明が表示されます。

• 現在のジャーナルのディレクトリとその空き領域

• 代替ジャーナルのディレクトリ (現在のジャーナルと異なる場合) とその空き領域

• 現在のジャーナル・ファイル、その最大サイズ、および使用している領域

• ジャーナルの状態。以下のいずれかの状態となります。

  • 有効

  • 無効 (停止)

  • I/O エラーのために無効 (中断)

  • I/O エラーのためにフリーズ

  • ジャーナルの切り替え中 (一時停止)

  I/O エラーのために中断した状態とフリーズした状態はジャーナル状態としては同じですが、実行されるアクションは異なり、フリーズした場合はジャーナル・データが破棄されます。

• 該当する場合、^JRNSTART、^JRNSTOP、または ^JRNSWTCH を実行しているすべてのプロセスのプロセス ID

以下に例を示します。

%SYS>Do ^JOURNAL
 
 ...
 9) Display Journal status (Status^JOURNAL)
 ...
Option? 9
 
Current journal directory:  C:\MyIRIS\Mgr\Journal\
Current journal directory free space (KB):  53503904
Alternate journal directory:  C:\MyIRIS\Mgr\
Alternate journal directory free space (KB): 53503904
Current journal file:  C:\MyIRIS\mgr\journal\20231129.001
Current journal file maximum size:    1073741824
Current journal file space used:         1979276
Journaling is enabled.

Manage^JRNROLL を使用したトランザクション・ロールバックの管理

InterSystems IRIS には、ジャーナルのレコードに対して部分的に完了したトランザクションをロールバックするための ^JRNROLL ユーティリティが用意されています。システムの起動時またはプライマリ・ミラー・メンバの起動時に保留中または処理中のトランザクション・ロールバックがある場合、Manage エントリ・ポイント (Manage^JRNROLL) を使用します。

トランザクション・ロールバックの管理を開始するには、以下の例に示すように、Manage^JRNROLL を実行するか、または ^JOURNAL メニューのオプション・プロンプトで「11」を入力します。

%SYS>Do ^JOURNAL
 
 ...
 11) Manage pending or in progress transaction rollback (Manage^JRNROLL)
 ...
Option? 11

オプション 11) 保留中または処理中のトランザクション・ロールバックの管理 (Manage^JRNROLL) を選択すると、以下のようなメッセージが表示されます。

Transaction rollback is pending or in progress 
Do you wish to run Manage^JRNROLL? Yes => Yes 
Rollback operations currently in progress 
     ID   Phase     MB Remaining   Current Open Transaction Count 
     1    scan      307            2 
          Rollback at system startup at 11/29/2023 15:54:35 (578MB) 
          20231129.004 has 2 open transaction(s) starting at offset 11303 
          2 file(s) remaining to process   

1) Restart pending rollback 
2) Interrupt transaction rollback 
3) Redisplay rollback information  
4) Discard pending rollback

Option?  

このオプションによって、トランザクション・ロールバックの現在のフェーズ (スキャンまたはロールバック)、処理される残りのデータの量 (MB)、検出された開いているトランザクションの数などの状態が表示されます。

さらに、リストされたトランザクション・ロールバックを管理するためのサブオプションがリストされます。例えば、処理を中断することができます。この場合、その処理は “保留中” の処理としてキューに登録されるため、保留中のロールバックを再開することが可能です。

ロールバックの間、一連の処理の (およそ) 10% ごとにメッセージがメッセージ・ログ (messages.log) に書き込まれ、処理のためにどのくらいの容量が残されているかと、開いているトランザクションがいくつリストされているかが示されます。

ジャーナル・ファイルが削除される場合、保留中のトランザクション・ロールバックに必要なファイルは保持されます (例えば、そうしなければそれらのファイルが削除されていた場合)。

MirrorCatchup^JRNRESTO を使用したミラーリングされるデータベースへのジャーナルのリストア

ミラー・ジャーナル・ファイルをミラーリングされるデータベースにリストアするには、^JOURNAL メニューのオプション・プロンプトで「12」を入力するか、またはオプション 4 の Restore Globals From Journal (^JRNRESTO) を使用したときに Catch-up mirrored databases? プロンプトで「yes」と入力します。以下に例を示します。

%SYS>Do ^JOURNAL

 ...
 12) Journal catch-up for mirrored databases (MirrorCatchup^JRNRESTO) 
 ...
Option? Option? 12

Specify the list of mirrored databases you want to catch-up.
Enter database, * for all, ? for a list or to end list? *
Enter database or to end list?
Starting catch-up for the following mirrored database(s):
     sfn #6: c:\intersystems\iris\mgr\mirrordb3\
Catch-up succeeded. 

ミラーリングされるデータベースをキャッチアップするには、ジャーナリングを実行している必要はありませんが、現在のジャーナル・ディレクトリがメモリから確実に利用できるように、少なくとも 1 回はジャーナリングを起動しておく必要があります。