p4journaldbchecksums

概要

テーブルチェックサムを使用してジャーナルノートを書き込みます。

構文


p4 [g-opts] journaldbchecksums [-t tableincludelist | -T tableexcludelist] [-l level]
p4 [g-opts] journaldbchecksums -u filename -t tablename [-v version] [-z]
p4 [g-opts] journaldbchecksums -s -t tablename [-b blocksize] [-v version]
p4 [g-opts] journaldbchecksums -c changelist

解説

p4 journaldbchecksumsコマンドは、分散および複製インストール環境でデータの整合性を確保するためのツールのセットを提供します。

Perforceサービスでは、p4 admin checkpointまたはp4 admin journalコマンドを使用すると常に自動で整合性チェックを実行し、p4 journaldbchecksumsコマンドを使用すると整合性チェックを手動で実行します。

このコマンドを使用するには、構造化ロギング(p4 logparse参照)を有効にし、少なくとも1つの構造化ログがintegrityタイプのイベントを取得している必要があります。

整合性チェックの実行時、Perforceサービスは、指定のテーブル(または、テーブルの指定がない場合は、すべてのテーブル)のチェックサムを含むレコードをジャーナルに書き込みます。レプリカサーバはこれらのレコードを受け取ると、これらのチェックサムを自身のデータベーステーブルに対して計算した値と比較します。これはp4 dbstatコマンドの処理と同様です。比較結果はレプリカのログに書き込まれます。

チェックするテーブルは、個々のテーブルを-tおよび-Tオプションで追加または削除するか、または3つの検証レベルのうちの1つを使用することで管理できます。

検証レベルは、rpl.checksum.auto構成可能変数または-l levelオプションで管理されます。レベル1は、最も重要なシステムとリビジョンテーブルに対応します。レベル2は、レベル1すべてと、レプリカ間で相違のないメタデータが含まれます。レベル3は、レプリカや、特にビルドファームやエッジサーバー間で相違するメタデータを含むすべてのメタデータが含まれます。

個々のチェンジリストおよびテーブルをチェックする場合、rpl.checksum.change構成可能変数やrpl.checksum.table構成可能変数により、イベントをログに書き込むタイミングを管理します。

検証の各レベルに関連するデータベーステーブルのリストの詳細については、『Perforceサーバ管理者ガイド: マルチサイト展開』を参照してください。

オプション

-b blocksize

テーブルのスキャン時に、ブロックごとにblocksize個のレコードをスキャンします。デフォルトは5,000です。サーバーはブロックごとにチェックサムを計算し、ジャーナルノートとして書き込みます。レプリカサーバーはこれらのノートの処理時にこれらのブロックを自動的に検証します。テーブルはブロックごとにロック解除されるため、このコマンドは生産システム上の大規模なテーブルに使用できます。ブロック検証の結果を検査することにより、データベーステーブルの一部のみに影響する破損箇所が明らかになります。

-c changelist

個々のサブミット済みチェンジリストのチェックサムを計算します。チェックサムはジャーナルノートとして書き込まれ、レプリカサーバはこれらのノートの処理時に変更のチェックサムを自動的に検証します。

-l level

チェックサムのレベルを指定します。各レベルは、より大きなテーブルのセットに対応します。これらのレベルは、rpl.checksum.auto構成可能変数で使用されるレベルに対応します。

-s -t tablename

指定のデータベーステーブルをスキャンします。

-t tables

チェックサムを計算するテーブルを指定します。複数のテーブルを指定するには、リストを二重引用符で囲み、テーブル名をスペースで区切ります。テーブル名は、"db."で始めます。テーブル名はまた、カンマで区切ることもできます。

-T tableexcludelist

リストされているものを除く、すべてのテーブルのチェックサムを計算します。

-u filename -t tablename

指定のデータベーステーブルをアンロードします。このコマンドはまた、この操作をドキュメントにするジャーナルノートを書き、これらのノートの処理時にレプリカサーバが同じテーブルを同じファイルへ自動的にアンロードするように指示します。

-v version

テーブルをアンロードまたはスキャンする場合に使用するサーバのバージョン番号を指定します。サーバのバージョン番号の指定がない場合、現在のサーバのバージョンが使用されます。

-z

テーブルのアンロード時にファイルを圧縮します。

g-opts

“グローバルオプション”を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？

ファイル引数にリビジョン範囲を使えるか？

最低限必要なアクセスレベル

適用外

適用外


operator super