jindocache コマンドを使用して、キャッシュポリシーの管理、キャッシュへのデータのロード、キャッシュ状態のモニタリング、キャッシュデータの削除を行います。フラグなしで jindocache を実行すると、サポートされているすべてのコマンドとその構文が一覧表示されます。
前提条件
開始する前に、次のことを確認してください:
-
JindoCache が設定済みです。詳細については、「JindoCache の透明なキャッシュ機能を使用して OSS-HDFS へのアクセスを高速化する」および「JindoCache の透明なキャッシュ機能を使用して OSS へのアクセスを高速化する」をご参照ください。
コマンドリファレンス
listCacheSet
現在のシステム内のすべての CacheSet を一覧表示します。変更を加える前に、このコマンドを使用して、アクティブなキャッシュポリシーの対象となっているパスを確認します。
jindocache -listCacheSet
refreshCacheSet
ローカルの設定ファイルから CacheSet ポリシーを更新します。新しいポリシーファイルに存在しない CacheSet は削除されます。
jindocache -refreshCacheSet <localPath>
| パラメーター | 説明 | 例 |
|---|---|---|
<localPath> |
cacheset.xml ファイルへのパス。ファイル作成時に指定したストレージパスです。 |
/path/cacheset.xml |
例:
jindocache -refreshCacheSet /path/cacheset.xml
load
リモートファイル (メタデータまたはデータ) をローカルディスクにキャッシュします。これにより、後続の読み取りは OSS などのバックエンドストレージではなく、ローカルディスクから提供されます。
完全なコマンドフォーマットは次のとおりです:
jindocache -load [-meta] [-data] [-s] [-m] [-R] [-replica <value>] <path>
メタデータのキャッシュ
ファイルのメタデータをローカルディスクにキャッシュします。コンピューティングジョブを実行する前にこれを使用すると、OSS へのメタデータのラウンドトリップをなくすことができます。
jindocache -load -meta <options> <path>
| パラメーター | 説明 |
|---|---|
-s |
同期モードで実行します。コマンドはキャッシュが完了するまで開いたままで、ログをコンソールにストリーミングします。進捗のモニタリングに推奨されます。 |
-R |
ディレクトリ内のすべてのファイルを再帰的にキャッシュします。<path> がディレクトリの場合に必要です。 |
<path> |
メタデータをキャッシュするパス。例: oss://emr-test/dir1 |
ディレクトリの場合は、次の推奨形式を使用します:
jindocache -load -meta -s -R <path>
データのキャッシュ
ファイルのデータをローカルディスクにキャッシュします。データ集約型のワークロードを実行する前にこれを使用して、キャッシュをウォームアップします。
jindocache -load -data <options> <path>
| パラメーター | 説明 |
|---|---|
-s |
同期モードで実行します。コマンドはキャッシュが完了するまで開いたままで、ログをコンソールにストリーミングします。進捗のモニタリングに推奨されます。 |
-replica <value> |
キャッシュするレプリカの数。デフォルト: 1。 |
-R |
ディレクトリ内のすべてのファイルを再帰的にキャッシュします。<path> がディレクトリの場合に必要です。 |
-m |
データをディスクではなくメモリにロードします。 |
<path> |
データをキャッシュするパス。例: oss://emr-test/dir1 |
ディレクトリの場合は、次の推奨形式を使用します:
jindocache -load -data -s -R <path>
mount
バックエンドストレージパスをキャッシュシステムにマウントします。引数なしで jindocache -mount を実行すると、現在のすべてのマウントポイントが一覧表示されます。
jindocache -mount <mountpoint> <path>
| パラメーター | 説明 | 例 |
|---|---|---|
<mountpoint> |
ローカルのマウントポイントパス | /mount/dir |
<path> |
マウントするバックエンドストレージパス | oss://emr-test/dir1 |
例:
jindocache -mount /mount/dir oss://emr-test/dir1
umount
マウントポイントをキャッシュシステムからアンマウントします。
jindocache -unmount <mountpoint>
例:
jindocache -unmount /mount/dir
report
JindoCache ストレージアクセラレーションシステムに関するシステムレベルの情報 (ノード数、キャッシュサイズ、キャッシュ容量など) を照会します。
jindocache -report
reportMetrics
JindoCache ストレージアクセラレーションシステムのメトリクスの一部を照会します。
jindocache -reportMetrics
unCache
キャッシュシステムからキャッシュファイルを削除します。
jindocache -unCache oss://<bucket>/<dir>
例:
jindocache -unCache oss://emr-test/dir1
disableCacheSet
名前を指定して CacheSet を削除します。不要になったキャッシュポリシーを削除するために使用します。
jindocache -disableCacheSet <name>
例:
jindocache -disableCacheSet name1
getCacheSet
指定されたパスを管理する CacheSet を検索します。データのロードまたはエビクションの前に、適用されるキャッシュポリシーを確認するために使用します。
jindocache -getCacheSet <path>
例:
jindocache -getCacheSet oss://emr-test/dir1