2.85.1　pdorbeginの形式と規則

(1)　機能

指定したオリジナルRDエリアと，レプリカグループ内の指定した世代のレプリカRDエリアをオンライン再編成閉塞にします。

表を指定した場合，その表の関連するRDエリアを処理対象とし，各オリジナルRDエリアと，レプリカグループ内の指定した世代のレプリカRDエリアをオンライン再編成閉塞にします。関連するRDエリアについては，pdrdreflsコマンドを参照してください。また，制約定義での関連エリアも対象にする場合は，-cオプションを指定します。詳細は-cオプションの説明を参照してください。

pdorbeginコマンドを実行してからpdorchgコマンドを実行するまでの間は，指定したオリジナルRDエリアがあるレプリカグループ内のRDエリアにアクセスする，トランザクションは待ち状態となります。

オンライン再編成閉塞を解除したい場合は-uオプションを指定します。

pdorbeginコマンドは，HiRDB Staticizer Optionが組み込まれていて，かつシステム定義のpd_max_reflect_process_countオペランド及びpd_inner_replica_controlオペランドを指定している場合に実行できます。

ページの先頭へ

(2)　実行者

HiRDB管理者が実行できます。

ページの先頭へ

(3)　形式

　pdorbegin ｛-r オリジナルRDエリア名〔，オリジナルRDエリア名〕…
 
　　　　　　 ｜-t 〔認可識別子.〕表識別子 〔-s サーバ名〔，サーバ名〕…〕 〔-c 制約種別〕｝
 
　　　　　 〔-q 世代番号〕 〔-w 排他待ち時間〕 〔-e〕 〔-u〕 〔-W 実行監視時間〕
　　　　　　〔-I｛put｜noput｝〕

　pdorbegin ｛-r オリジナルRDエリア名〔，オリジナルRDエリア名〕…
 
　　　　　　 ｜-t 〔認可識別子.〕表識別子 〔-c 制約種別〕｝
 
　　　　　 〔-s サーバ名〔，サーバ名〕…〕
 
　　　　　 〔-q 世代番号〕 〔-w 排他待ち時間〕 -u 〔-W 実行監視時間〕
　　　　　　〔-I｛put｜noput｝〕

ページの先頭へ

(4)　オプション

ページの先頭へ

(5)　規則

1. pdorbeginコマンドは，HiRDBが稼働中のときだけ実行できます。

2. pdorbeginコマンドは，シングルサーバ又はシステムマネジャがあるサーバマシンで実行してください。

3. pdorbeginコマンドを実行する場合，データディクショナリ用RDエリアが次のどちらかの状態でなければなりません。

   • オープン状態，かつ閉塞解除状態

   • オープン状態，かつコマンド閉塞状態

4. pdorbeginコマンドは，オプションの指定によって次のように処理をします。

   • -rオプション指定時

     指定したオリジナルRDエリアのサーバごとに処理をします。指定したオリジナルRDエリアと，レプリカグループ内の指定した世代番号のレプリカRDエリアを，すべてオンライン再編成閉塞にできなかった場合は，そのサーバの処理はエラーとなり，次のサーバの処理をします。

   • -tオプション指定時

     指定した表の関連するRDエリアを処理対象とし，各オリジナルRDエリアと，レプリカグループ内の指定した世代のレプリカRDエリアをオンライン再編成閉塞にします。該当するサーバを一括して処理するため，すべてのサーバの状態が同一となります。

5. 指定したオリジナルRDエリアがあるサーバ内に，既にオンライン再編成閉塞となっているRDエリアがある場合，pdorbeginコマンドはエラーとなります。

6. オリジナルRDエリアの状態によってpdorbeginコマンドの実行可否が変わります。詳細については，「RDエリアの状態遷移」を参照してください。なお，レプリカRDエリアについては，コマンド閉塞かつクローズ状態である必要があります。

7. pdorcreateコマンドで追い付き状態管理表が作成されていない場合，又は-rオプションで指定したオリジナルRDエリアに追い付き状態管理表が作成されている場合は，pdorbeginコマンドはエラーとなります。

8. 表定義時の列回復制約にALL以外を指定していて，その表（LOB列）を格納しているユーザLOB用RDエリアを-rオプションに指定した場合，そのユーザLOB用RDエリアがあるサーバに対するコマンドはエラーとなります。

9. 処理対象RDエリアに共用RDエリアがある場合，全バックエンドサーバで一括処理をします。そのため，指定したオリジナルRDエリア，及びレプリカグループ内の指定した世代のレプリカRDエリアをすべてオンライン再編成閉塞にできない場合，エラーとなります。

10. pdorbeginコマンドを実行した場合，参照及び更新トランザクションとの間でデッドロックになることがあります。システム定義にpd_deadlock_priority_use=Yを指定し，更にpd_command_deadlock_priorityに運用コマンドのデッドロックプライオリティ値を指定することで，デッドロック発生時に参照及び更新トランザクションと運用コマンドのどちらを優先させるかを選択できます。pdorbeginコマンドをエラーにする場合は，運用コマンドのデッドロックプライオリティ値を大きくします。この場合，pdorbeginコマンドがコマンド実行時に掛けた排他をすべて解除してからエラーになるため，一定時間後にpdorbeginコマンドを再度実行してください。pdorbeginコマンドを優先し，参照及び更新トランザクションをエラーにする場合は，運用コマンドのデッドロックプライオリティ値を小さくしてください。

11. サーバ内にオンライン再編成閉塞の共用RDエリアと非共用RDエリアが混在する場合，-sオプションを指定してオンライン再編成閉塞を解除するときは，共用RDエリアと非共用RDエリアを別々に実行する必要があります。同時に実行するとエラーになります。

12. 処理対象（表又はRDエリア）と，オプション（-t，-r，-s，-u，及び-c）の組み合わせによって，コマンドの実行可否，及び実行範囲が変わります。pdorbeginコマンドの実行可否と実行範囲を次に示します。

    処理対象		オプション					実行可否	実行範囲	コマンドの実行形式
    		-t	-r	-s	-u	-c
    表	非分割表（HiRDB/シングルサーバの共用表を含む）	●	−	−	−	−	○	すべての関連するRDエリア※2	形式1
    		●	−	−	●	−	○
    		●	−	●	−	−	○※1	指定したバックエンドサーバの関連するRDエリア※2
    		●	−	●	●	−	○※1
    		●	−	−	−	●	○	すべての関連するRDエリア※3
    		●	−	−	●	●	○
    		●	−	●	−	●	○※1	指定したバックエンドサーバに関連するすべてのRDエリア※3
    		●	−	●	●	●	○※1
    	横分割表	●	−	−	−	−	○	すべての関連するRDエリア※2
    		●	−	−	●	−	○
    		●	−	●	−	−	○※1	指定したバックエンドサーバの関連するRDエリア※2
    		●	−	●	●	−	○※1
    		●	−	−	−	●	○	すべての関連するRDエリア※3
    		●	−	−	●	●	○
    		●	−	●	−	●	○※1	指定したバックエンドサーバに関連するすべてのRDエリア※3
    		●	−	●	●	●	○※1
    	共用表（HiRDB/パラレルサーバ限定）	●	−	−	−	−	○	すべてのバックエンドサーバの関連するRDエリア※2
    		●	−	−	●	−	○		形式2
    		●	−	●	−	−	×	該当しません。	形式1
    		●	−	●	●	−	○	指定したバックエンドサーバの関連するRDエリア※2	形式2
    		●	−	−	−	●	○	すべてのバックエンドサーバの関連するRDエリア※3	形式1
    		●	−	−	●	●	○		形式2
    		●	−	●	−	●	×	該当しません。	形式1
    		●	−	●	●	●	○	指定したバックエンドサーバの関連するRDエリア※3	形式2
    RDエリア	非共用RDエリアだけ	−	●	−	−	−	○	指定したRDエリアだけ	形式1
    		−	●	−	●	−	○
    		−	●	●	−	−	×	該当しません。
    		−	●	●	●	−	×
    		−	●	−	−	●	×
    	共用RDエリアだけ	−	●	−	−	−	○	すべてのバックエンドサーバ
    		−	●	−	●	−	○		形式2
    		−	●	●	−	−	×	該当しません。	形式1
    		−	●	●	●	−	○	指定したバックエンドサーバ	形式2
    		−	●	−	−	●	×	該当しません。	形式1
    	非共用RDエリアと共用RDエリアが混在	−	●	−	−	−	○	すべてのバックエンドサーバ
    		−	●	−	●	−	○		形式2
    		−	●	●	−	−	×	該当しません。	形式1
    		−	●	●	●	−	×		形式2
    		−	●	−	−	●	×		形式1

    （凡例）

    ●：オプション指定あり

    −：オプション指定なし

    ○：実行できます。

    ×：実行できません。

    注※1

    指定したバックエンドサーバと，関連するRDエリアがあるバックエンドサーバが一致しない場合，エラーとなります。

    注※2

    制約定義の関連を含めません。

    注※3

    制約定義の関連を含めます。

ページの先頭へ

(6)　注意事項

1. pdorbeginコマンドの結果は，pdls -d orgコマンド，又はリターンコードで確認できます。リターンコードを次に示します。

   0：正常終了

   4：警告終了（一部のサーバで処理が成功）

   8：異常終了

   12：異常終了（コマンドがエラーメッセージを表示できない事象が発生）

   リターンコードが12の場合，シングルサーバ又はディクショナリサーバがあるホストのsyslogfileのエラーメッセージを参照し，エラーの要因を取り除いた後，再度コマンドを実行してください。syslogfileにエラーメッセージが出力されていない場合は，保守員に連絡してください。

2. オンライン再編成閉塞は，HiRDBを再開始した場合でも引き継がれます。

3. pdorbeginコマンドは，RDエリアに対して排他制御モードEXで排他を掛けます。そのため，指定したRDエリアにほかのトランザクションがアクセスしている場合は，そのトランザクションが終了するまでpdorbeginコマンドは待ち状態となります。また，pdorbeginコマンドの実行からpdorchgコマンドの完了までの間，指定したRDエリアに対するトランザクションは，レプリカグループ構成の排他で待ち状態となります。

4. -tオプションを指定した場合，内部でpdrdreflsコマンドを実行します。そのため，-tオプション指定時は，pdrdreflsコマンドのメッセージが出力されることがあります。

5. リアルタイムSANレプリケーションの処理方式にハイブリッドを選択している場合，pdorbeginコマンドを実行すると，リモートサイトへのデータベース同期待ち合わせをします。このため，-rオプションで指定したRDエリア一つにつき，2秒以上のオーバヘッドが掛かることがあります。リモートサイトへのデータベース同期待ち合わせに失敗した場合，リモートサイトのデータベースを回復する必要があります。リアルタイムSANレプリケーションを使用した場合の障害発生時の運用については，マニュアル「HiRDB Version 9 ディザスタリカバリシステム　構築・運用ガイド」を参照してください。

ページの先頭へ