Chat now with support
Chat mit Support

SharePlex 11.4 - リファレンス・ガイド

このガイドについて このガイドで使用される表記規則 Oracle用SharePlexコマンド SharePlexパラメーター PostgreSQL用SharePlexコマンド PostgreSQL用SharePlexパラメーター 一般SharePlexユーティリティ Oracleクラウドインフラストラクチャ SharePlex環境変数

add partition

add partitionコマンドを使用すると、水平分割レプリケーションを設定するときに、パーティションスキームに行パーティションを追加できます。作成する行パーティションごとに、add partitionを発行します。

このコマンドは、以下の必須コンポーネントを含む、パーティション作成に必要なすべての情報を取得します。

  • パーティションスキーム名。新しいパーティションスキームを作成するには、そのスキームの最初の行パーティションを作成するadd partitionコマンドでスキームの名前を指定します。SharePlexは自動的にパーティションスキームを作成します。その後、そのパーティションスキームに行パーティションを追加するときに、その名前を指定します。
  • 行パーティションを作成するハッシュ値または列条件の指定。
  • 行パーティションで指定された行のルーティング。

既にレプリケートされているテーブルにコマンドが影響する場合は、設定ファイルを再アクティベーションします。SharePlexは設定が変更されたテーブルのみをロックします。

水平分割レプリケーションの設定方法の詳細については、『SharePlex管理ガイド』を参照してください。

用途

サポート対象のソース: Oracle
サポート対象のターゲット: すべて
認証レベル: オペレーター（2）
発行場所: ソースシステム
関連コマンド: modify partition、drop partition、drop partition scheme、view partitions

構文

基本コマンド コマンドオプション リモートオプション

add partition to scheme_name

set

{condition = column_condition |

hash = hash_value}

および

route = routing_map

[and name = partition_name]

[and tablename = target_table]

[and description = description]

 利用不可
構文の説明
コンポーネント 説明
to scheme_name

toは、行パーティションがscheme_nameに追加されることを示す必須キーワードです。

scheme_nameはパーティションスキームの名前です。パーティションスキームは、最初に発行するadd partitionコマンドによって作成されます。このコマンドは、パーティション化する最初の行のセットも指定します。

水平分割を多用する場合は、パーティションスキームの命名規則を確立しておくことをお勧めします。

set

行パーティションの定義を開始する必須キーワード。

condition = column_condition

列条件に基づいて行パーティションを作成します。条件は引用符で囲む必要があります。((region_id = West) and region_id is not null)のような標準的なWHERE条件構文を使用します。

conditionコンポーネントとhashコンポーネントは相互に排他的です。

hash = value

ハッシュ値に基づいて行パーティションを作成します。指定された値は、パーティションスキームにおける行パーティションの数を決定します。

conditionコンポーネントとhashコンポーネントは相互に排他的です。

route = routing_map

このパーティションのルート。これは以下のいずれかになります。

列条件に基づくパーティション:

標準のSharePlexルーティングマップを指定します（例: sysB@o.myora、sysB:q1@o.myoraまたはsysB@o.myora+sysC@o.myora（複合ルーティングマップ））。

ターゲットがJMS、Kafka、またはファイルの場合、ターゲットをx.jms、x.kafka、またはx.fileとして指定する必要があります（例: sysA:hpq1@x.kafka）。

異なる名前を持つ複数のターゲットテーブルにパーティションをルーティングするには、以下の手順を実行します。

  • 異なるターゲット名ごとにadd partitionコマンドを個別に発行します。tablenameオプションを使って名前を指定します。
  • 設定ファイルで、このパーティションスキームを使用するエントリのターゲットテーブルとして、これらのターゲットテーブルのいずれかを指定します。SharePlexは、設定が有効化されると他の名前を検出します。
  • SP_ORD_FIRST_FINDパラメーターを0に設定し、パーティションスキームのすべての列条件をSharePlexでチェックするようにします。デフォルトでは、SharePlexは、特定の行変更がパーティションスキームの1つの列条件のみを満たすことを想定しています。

ハッシュに基づくパーティション:

以下のフォーマットを使用して、各パーティションに名前付きpostキューを作成するようにSharePlexに指示します。

host:basename|#{o.SID | r.database}

ここで

  • hostはターゲットシステムの名前です。
  • basenameはすべてのキューに割り当てられる基本名です。
  • |#は、1からhashで設定された値までの整数を基本名に付加することでキューに連番を付けるようにSharePlexに指示します。
  • o.SID（Oracleターゲットの場合）またはr.database（Open Targetターゲットの場合）。
name = name

（推奨）このパーティションの短い名前。このオプションは、列条件に基づくパーティションにのみ有効です。名前を付けておくと、将来パーティションを変更したり削除したりする必要が生じたときに、長い列の条件を入力する必要がなくなります。

tablename = owner.table

（オプション）このオプションは、ターゲットテーブルが複数あり、そのうちの1つ以上が異なる名前である場合に使用します。名前ごとにadd partitionコマンドを個別に発行します。

テーブル名は完全修飾名でなければなりません。大文字と小文字が区別される場合は、名前を引用符で囲んで指定する必要があります。

例:

add partition to scheme1 set name = p1 and condition = "C1 > 200" and route = sysb:p1@o.orasid and tablename = myschema.mytable

description = description （オプション） このパーティションの説明。
例
列条件に基づく行パーティション

異なる行のセットを異なるpostキューにルーティング:

sp_ctrl> add partition to scheme1 set name = q1 and condition = "C1 >= 200" and route = sysb:q1@o.orasid

sp_ctrl> add partition to scheme1 set name = q2 and condition = "C1 < 200" and route = sysb:q2@o.orasid

異なる行のセットを、異なるターゲットシステムおよびソースと異なるテーブル名にルーティング:

sp_ctrl> add partition to scheme1 set name = east and condition = "area = east" and route = sys1e@o.orasid and tablename = ora1.targ

sp_ctrl> add partition to scheme1 set name = west and condition = "area = west" and route = sys2w@o.orasid and tablename = ora2.targ

ハッシュ値に基づく行パーティション

行を4つのパーティションに分け、それぞれを異なるpostキューで処理します。

sp_ctrl> add partition to scheme1 set hash = 4 and route = sysb:hash|#@o.ora112

analyze config

analyze configコマンドを使用すると、設定ファイル内のテーブルの分析を実行できます。このコマンドは、テーブルのアクティビティに関する情報を収集します。

重要! 分析を実行する前に、設定をアクティベーションしないでください。また、分析を実行するときに、他のアクティブな設定がないことを確認してください。このコマンドの使用方法は、実際のアクティベーションに似ています。

分析プロセスは、コマンドで指定された時間に収集されたデータに基づいてその結果を書き出します。レプリケーションストリームはその後、自動的にクリーンアップされます。

分析は、変数データディレクトリのlogサブディレクトリにあるファイルに書き込まれます。ファイル名は次のようになります。

o.datasource-analysis.actid

分析プロセスは、レプリケーション内の各オブジェクトのアクティビティに関する情報とトランザクション情報を保持します。トランザクション情報は、同じレプリケーションストリーム（同じキューとプロセスのセット）でレプリケートする必要があるような、相互に関連するテーブルのグループを識別するために使用できます。

分析では、関連するテーブルの各グループ、テーブルごとの総操作数、グループの総操作数がリストされます。

例:

>cat o.w111a64f-analysis.1575

Activity Analysis

 

Group 1 of related tables: 1000 total operations in group

"TEST"."SS2_TEST1" 346

"TEST"."SS2_TEST2" 348

"TEST"."SS2_TEST3" 306

 

Group 2 of related tables: 1124 total operations in group

"TEST"."SRC_TEST1" 232

"TEST"."SRC_TEST2" 177

"TEST"."SRC_TEST3" 178

"TEST"."SRC_TEST4" 175

"TEST"."SRC_TEST5" 188

"TEST"."SRC_TEST6" 174

 

Tablename Inserts Updates Deletes Rollbacks Total
"TEST"."SS2_TEST2" 146 169 33 0 348
"TEST"."SS2_TEST1" 140 176 30 0 346
"TEST"."SS2_TEST3" 116 158 32 0 306
"TEST"."SS2_TEST1" 75 114 29 14 232
"TEST"."SS2_TEST5" 61 94 22 11 188
"TEST"."SS2_TEST3" 69 73 28 8 178
"TEST"."SS2_TEST2" 69 77 21 10 177
"TEST"."SS2_TEST4" 54 89 19 13 175
"TEST"."SS2_TEST6" 61 79 25 9 174

現在の分析の状況を表示するには:

分析の状況を表示するには、show analyzeコマンドを使用します。

sp_ctrl (alvspxl11:8567)> show analyze detail

 

Host: alvspxl11.quest.com

Operations  
Source Status Processed Since Total Backlog
------ ------------ ----------- ------- ------ -------
o.w111a64f Running 1497 17-Mar-12 10:41:54 1496 0
           

Last operation processed:

Redo log: 295 Log offset: 32327800

UPDATE of "TEST"."SRC_TEST3" at 03/17/12 0:59:17

 

Activation id : 1573
Operations processed : 1497
Transactions processed : 398
Analysis complete : 20-Mar-12 10:41:54

完了前に分析を終了するには:

分析が完了する前に終了するには、abort configコマンドまたはdeactivate configコマンドを使用するか、SP_ANL_RUN_TIMEパラメータを変更します。

用途

サポート対象のソース: Oracle
サポート対象のターゲット: すべて
認証レベル: 管理者（1）
発行対象: ソースシステム
関連コマンド: abort config、copy config、create config、deactivate config、edit config、list config、purge config、remove config、rename config、show config、verify config、view config 

構文

基本コマンド コマンドオプション リモートオプション
analyze config filename n {minutes | hours | days}

[ on host |

on host:portnumber |

on login/password@host |

on login/password@host:portnumber ]

構文の説明
コンポーネント 説明
filename 

分析する設定ファイルの名前。設定名では大文字と小文字が区別されます。

例:

sp_ctrl(sysA)>analyze config sales

n {minutes | hours | days) 分析するアクティビティの分数、時間数、または日数。
リモートオプション

これらのオプションにより、リモートマシンにコマンドを発行したり、ログイン名、パスワード、ポート番号、またはそれらの組み合わせを含むコマンドをスクリプト化したりすることができます。

オプション 説明
on host

リモートシステム（現在のsp_ctrlセッションが実行されているシステム以外）でコマンドを実行します。リモートシステムのログイン認証情報の入力を求めるプロンプトが表示されます。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on SysA

on host:portnumber

リモートログインとポート番号を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on SysA:8304

on login/password@host

リモートログイン、パスワード、ホスト名を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例:sp_ctrl(sysB)>status on john/spot5489@SysA

on login/password@host:portnumber

リモートログイン、パスワード、ホスト名、ポート番号を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on john/spot5489@SysA:8304

例

analyze config testconf 5 days

 

sp_ctrl (alvspxl11:8567)> show analyze

Process Source Target State PID
------ ------------ ----------- ------- ----
Capture o.w111a64f   Running 2968
Analyze o.w111a64f   Running 2976

 

append status

append statusコマンドは、最後に実行されたcopyまたはappendコマンドジョブのステータスを表示するために使用します。append statusコマンドを使用すると、copyまたはappendジョブ、またはcopyまたはappendジョブの一部の詳細なステータスを表示したり、SharePlexが履歴を保持するすべてのcopyおよびappendジョブのステータスを表示したりできます。

append statusコマンドの使用方法の詳細については、以下の例を参照してください。

用途

サポート対象のソース: Oracle
サポート対象のターゲット: Oracle
認証レベル: ビューアー
発行対象: ソースまたはターゲット
関連コマンド: copystatus

構文

基本コマンド コマンドオプション リモートオプション
append status

[job_id]

[Job_id.table_id]

[all]

[full]

[detail]

[status]

[ on host |

on host:portnumber |

on login/password@host |

on login/password@host:portnumber ]

構文の説明
コンポーネント 説明
job_id

指定されたSharePlex割り当てジョブIDを持つジョブのステータス履歴を表示します。

例: sp_ctrl(sysA)>append status 28282

job_id.table_id

指定されたSharePlex割り当てジョブIDとテーブルを持つジョブのステータス履歴を表示します。

例: sp_ctrl(sysA)>append status 2828.HR.SRC_TEST3

all

データベースに履歴があるすべてのジョブの概要行を表示します。

例: sp_ctrl(sysA)>append status all

full

ジョブ内の各オブジェクトのステータスを表示します。デフォルトでは、job statusコマンドは、完了していないオブジェクト、または例外的なステータスで完了したオブジェクトのステータスを表示します。

例: sp_ctrl(sysA)>append status 2828 full

detail

報告されたすべてのオブジェクトの詳細情報を表示します。デフォルトでは、job statusコマンドは報告されたすべてのオブジェクトの概要行を表示します。詳細情報は、job_id.table_idオプションで表示されるものと同じであることに注意してください。

例: sp_ctrl(sysA)>append status detail

[status]

指定されたステータスの過去のジョブのステータス履歴を表示します。

例: sp_ctrl(sysA)>append status "Error"

リモートオプション

これらのオプションにより、リモートマシンにコマンドを発行したり、ログイン名、パスワード、ポート番号、またはそれらの組み合わせを含むコマンドをスクリプト化したりすることができます。

オプション 説明
on host

リモートシステム（現在のsp_ctrlセッションが実行されているシステム以外）でコマンドを実行します。リモートシステムのログイン認証情報の入力を求めるプロンプトが表示されます。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on SysA

on host:portnumber

リモートログインとポート番号を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on SysA:8304

on login/password@host

リモートログイン、パスワード、ホスト名を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例:sp_ctrl(sysB)>status on john/spot5489@SysA

on login/password@host:portnumber

リモートログイン、パスワード、ホスト名、ポート番号を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on john/spot5489@SysA:8304

 

authlevel

認証レベル

authlevelコマンドを使用して、システム上でSharePlexコマンドを発行するための権限レベルを決定します。

以下に示すのは表示例です。

User is a viewer (level=3)

用途

サポート対象のソース: Oracle
サポート対象のターゲット: すべて
認証レベル: ビューアー（3）
発行対象: ソースまたはターゲットシステム
関連コマンド: なし

構文

基本コマンド リモートオプション
認証レベル

[ on host |

on host:portnumber |

on login/password@host |

on login/password@host:portnumber ]

リモートオプション

これらのオプションにより、リモートマシンにコマンドを発行したり、ログイン名、パスワード、ポート番号、またはそれらの組み合わせを含むコマンドをスクリプト化したりすることができます。

オプション 説明
on host

リモートシステム（現在のsp_ctrlセッションが実行されているシステム以外）でコマンドを実行します。リモートシステムのログイン認証情報の入力を求めるプロンプトが表示されます。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on SysA

on host:portnumber

リモートログインとポート番号を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on SysA:8304

on login/password@host

リモートログイン、パスワード、ホスト名を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例:sp_ctrl(sysB)>status on john/spot5489@SysA

on login/password@host:portnumber

リモートログイン、パスワード、ホスト名、ポート番号を指定する必要がある場合は、リモートシステムでコマンドを実行します。使用する場合は、コマンド構文の最後の構成要素でなければなりません。

例: sp_ctrl(sysB)>status on john/spot5489@SysA:8304

Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen