p4 unload // P4コマンドリファレンス

概要

ワークスペース、ラベル、またはタスクストリームを、アンロードディポまたはフラットファイルにアンロードします。

構文

解説

p4 unloadコマンドには2つの主要な使用方法があります。

このコマンドを使用すると、使用頻度の低いメタデータをバージョニングエンジンのdb.*ファイルからアンロードディポ内のフラットファイル群に転送できます。メタデータをアンロードすると、バージョニングエンジンに必要とされる作業データのサイズが減少し、過去何年分ものメタデータを持つ大規模なサイトにおいて大幅にパフォーマンスを向上させることができます。

p4 clients、p4 labels、p4 files、p4 sizes、p4 fstatなどのPerforceコマンドは、アンロードされたメタデータを無視します。(アンロードされたメタデータを表示するには、これらのコマンドに-Uオプションを使用してください。)Perforceのレポートコマンドを使用するユーザのほとんどは、目的のデータの上位集合を取得した後に自動または手動での後処理を使用して、出力内の不要な行を破棄することを意図しています。例えば、p4 clientsコマンド(引数なしで実行)は、現在および過去に組織に属するすべての従業員(10年前に退職していたとしても)によってこれまでに作成された、すべてのクライアントワークスペースの名前を返します。使われなくなったメタデータをアンロードすると、コマンドラインクエリの出力だけではなく、P4Vなどのアプリケーションに表示される情報量においても、ユーザに高いS/N比をもたらします。
クライアント、ラベル、またはタスクストリームをアンロードするには、アンロードディポのファイルではなくクライアントのフラットファイルに対してコマンドの-oオプションを使用します。これは、クライアントを別のデータベースに読み込む場合や、クライアントのプライベートバックアップを作成する場合に役立ちます。フラットファイルは標準のジャーナル形式を使用しています。コマンドの実行後にクライアント、ラベル、タスクストリームは完全に読み込まれた状態を維持します。

-cおよび-lオプションを使用すると、特定のクライアントワークスペースまたはラベルをアンロードできます。デフォルトでは、ユーザは自分が所有するワークスペースまたはラベルしかアンロードできません。管理者は-fオプションを使用して、他のユーザが所有するワークスペースおよびラベルをアンロードできます。

ワークスペースを1つのエッジサーバから別のエッジサーバに移動するためにワークスペースをアンロードする必要はありません。p4 reloadコマンドを実行すると、ワークスペースを新しいエッジサーバにリロードする前に、指定したワークスペースが自動的にアンロードされます。

-a、-al、または-acオプションを使用すると、すべての指定されたラベルおよび/またはクライアントワークスペースがアンロード対象となります。-oオプションも使用している場合は、これらのオプションを使用できません。

-d dateおよび/または-u userオプションを使用すると、アンロード操作の対象は特定の日付dateよりも古いか、特定のユーザuserが所有しているか、またはその両条件に該当するラベルおよび/またはワークスペースに限定されます。

-Lオプションを使用すると、ロックされたワークスペースおよび/またはラベルがアンロードされます。デフォルトでは、ロックが解除されたラベルまたはワークスペースのみがアンロードされます。

ワークスペースのアクセス日付は、そのワークスペースを直接参照するコマンドによってワークスペースが使用されるたびに更新されます。同様に、ラベルのアクセス日付は、そのラベルを直接参照するコマンドによってラベルが使用されるたびに更新されます。また、ワークスペースのアクセス日付はそのワークスペースが@workspaceの形式でリビジョン指定子に使用されたときにも更新され、ラベルのアクセス日付はそのラベルが@labelnameの形式でリビジョン指定子に使用されたときにも更新されます。

デフォルトでは、アンロードディポ内のデータは圧縮されません。圧縮形式で保存するには、-zオプションを使用してください。アンロードされたメタデータは多くの場合、圧縮した方がはるかに効率的です。1回のビルドに使用された後はほとんどあるいは全くアクセスされることのない何百万個ものビルド関連のワークスペースやラベルが存在する、連続稼動のビルド環境ではその傾向が特に高まります。

オプション

`-a`	該当するすべてのクライアントワークスペースとラベルをアンロードします。`-d`、`-u`、または`-d`と`-u`の両方のオプションを必要とします。このオプションはタスクストリームには影響しません。
`-ac`	クライアントワークスペースをアンロードします。`-d`、`-u`、または`-d`と`-u`の両方のオプションを必要とします。
`-al`	ラベルをアンロードします。`-d`、`-u`、または`-d`と`-u`の両方のオプションを必要とします。
`-c client`	指定されたクライアントワークスペースのメタデータを`db.have`(および関連テーブル)からアンロードし、それをアンロードディポに格納します。
`-d date`	指定された日付よりも古いメタデータをアンロードします。
`-f`	強制オプション。管理者は他のユーザが所有するワークスペース、ラベル、またはタスクストリームのアンロードが可能です。
`-l label`	指定されたラベルを`db.label`(および関連テーブル)からアンロードし、それをアンロードディポに格納します。
`-L`	`locked`されたワークスペース、ラベル、またはタスクストリームをアンロードします。
`-o ouputFile`	メタデータをアンロードディポではなくファイルにアンロードします。ただし、このオプションが動作するためには、アンロードディポが存在する必要があります。データは最初にアンロードディポに配置されてから、指定した出力ファイルに移動されるためです。標準のユーザは自分のクライアントのオブジェクトのみをアンロードできます。管理者はこのオプションを使用して、他のユーザが所有するオブジェクトをアンロードできます。
`-s stream`	指定されたタスクストリームをアンロードします(`stream`は`task`タイプである必要があります)。
`-u user`	指定されたユーザが所有するメタデータをアンロードします。
`-z`	アンロードされたワークスペース、ラベル、またはタスクストリームを圧縮形式で保存します。
`g-opts`	「“グローバルオプション”」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？	ファイル引数にリビジョン範囲を使えるか？	最低限必要なアクセスレベル
使用不可	使用不可	`write` `admin`

ワークスペースまたはラベルのアンロードを行うには、ユーザがワークスペースの所有リストにあるすべてのファイルおよび/またはラベルによってタグ付けされているファイルをスキャンすることが可能でなければなりません。管理者は(p4 groupフォームにおいて)MaxScanRowsおよびMaxResultsを十分な大きさの値に設定して、ユーザがp4 unloadまたはp4 reloadの操作にサポートを要求しなくて済むようにする必要があります。

P4コマンドリファレンス (2015.1)

p4 unload

概要

構文

解説

オプション

使用上の留意点

関連コマンド