Oracle Cloud Infrastructureドキュメント

ストレージ・ゲートウェイ・ファイル管理操作を使用した

このトピックでは、ストレージ・ゲートウェイのファイル管理操作の使用方法について説明します。

REST API、Javaライブラリまたはその他のクライアントを使用して、ストレージ・ゲートウェイのファイル・システムにマップされているバケット内のオブジェクトを直接取得、作成、更新または削除する場合は、注意が必要です。 ストレージ・ゲートウェイ・ファイル・システムを「リフレッシュ」するまで、ストレージ・ゲートウェイは変更を認識しておらず、データはストレージ・ゲートウェイオブジェクト・ストレージの間で矛盾しています。

バケットへのファイルのアップロード

ファイル・システムをOracle Cloud Infrastructure Object Storageバケットに接続する前に、ネームスペース、テナントOCID、コンパートメントOCIDなど、Oracle Cloud Infrastructure Object Storageテナンシの詳細を書き留めます。

ファイルをストレージ・ゲートウェイまたはNFSクライアント・ホストのマウントされたディレクトリにコピーします。 ストレージ・ゲートウェイはファイルをディスク・キャッシュに書き込みます。 システムがファイルをキューに入れ、非同期に「オブジェクト・ストレージ」バケットにアップロードします。 対応するオブジェクトは、ファイル・システムの作成時に指定したストレージ層(「標準」または「アーカイブ」)に作成されます。 詳細は、「最初のファイル・システムの作成」または「ファイル・システムの管理」を参照してください。

ノート

ストレージ・ゲートウェイでは、128 MBより大きいファイルに対してマルチパートのアップロードが自動的に実行されます。
詳細については、「マルチパート・アップロードの使用」を参照してください。

現在のブラウザ・セッション中にテナンシにアップロードされたファイルを表示できます。 「ファイル・システムの詳細の表示」「完了したアップロード」タブを参照してください。

ファイルを読む

ファイルをストレージ・ゲートウェイ・ファイル・システムに書き込むと、ファイルはローカル・ディスク・キャッシュに格納されます。 マウントされたディレクトリからファイルを直接読み取ることができます。 ストレージ・ゲートウェイは、テナンシの対応する「オブジェクト・ストレージ」バケットにファイルを非同期でコピーします。 ストレージ・ゲートウェイを使用してバケットからデータを取得するには、マウントされたディレクトリからファイルを読み取ります。

領域が使用可能な場合、ストレージ・ゲートウェイは自動的にファイルを読取りキャッシュに配置します。 ファイルが読取りキャッシュにある場合は、ファイルをすぐに取得できます。 ファイルが読取りキャッシュで使用できず、Archive層に格納されている場合は、オブジェクトをリストアする必要があります。 詳細は、「アーカイブ・ストレージからのファイルとオブジェクトのリストア」を参照してください。

ノート

「アーカイブ」層に格納されており、読取りキャッシュに存在しないファイルに対して、読取りまたは書込みはできません。 このアクションはInput/Ouput errorを返します。

ストレージ・ゲートウェイは、アップロード時のチェックサム検証を使用してデータの整合性をチェックします。 チェックサムの検証はファイル全体またはオブジェクト全体でのみ機能するため、部分読取りではデータの整合性の検証を実行できないことがあります。

ファイル・システム内のファイルのアップロード・チェックサムを読み取るには、ファイル・システムがマウントされているNFSクライアントから次のコマンドを実行します:

sudo docker exec ocisg bash -c "cd /mnt/gateway/${filesystem} && cat ${filepath}:::meta:csm"

「アーカイブ・ストレージ」からのファイルとオブジェクトのリストア

ストレージ・ゲートウェイ・コマンド・ラインからファイル・リストアを開始できます。 また、Oracle Cloud Infrastructureで、「アーカイブ・ストレージ」からのオブジェクト・リストアを開始することもできます。 「オブジェクト・ストレージ」にオブジェクトをリストアした後で、ストレージ・ゲートウェイを使用して対応するファイルを読み取ることができます。

ノート

ストレージ・ゲートウェイでは、事前定義済のスケジュールに従ってバケット内のオブジェクトのアーカイブおよび削除を管理するOracle Cloud Infrastructure Object Storageオブジェクトのライフサイクル・ポリシーがサポートされています。
オブジェクト・ライフサイクル・ポリシーを使用すると、標準の「オブジェクト・ストレージ」層でバケット作成を指定してから、ポリシーを作成して、「アーカイブ・ストレージ」層への後続のデータ移動をスケジュールできます。 このライフサイクル・ポリシー・アーカイブ・メソッドは、即時アーカイブで不適切な中間ファイルまたは一時ファイルおよびディレクトリを生成するオンプレミス・アプリケーションを持つ場合に便利です。 詳細については、「オブジェクト・ライフサイクル管理の使用」を参照してください。

ストレージ・ゲートウェイ・コマンド・ラインを使用したアーカイブ済ファイルのリストア

1つ以上のアーカイブ済ファイルをリストアするには
1つ以上のファイルのアーカイブ・ステータスを確認するには
リストア・ジョブのステータスをファイルシステム用に確認するには

Oracle Cloud Infrastructureを使用したアーカイブ済ファイルのリストア

重要

Oracle Cloud Infrastructureを使用してアーカイブ・オブジェクトをリストアする場合は、ストレージ・ゲートウェイ「リフレッシュ」操作を使用して、オブジェクト・ストレージで直接追加または変更されたデータを表示します。

Oracle Cloud Infrastructure Consoleを使用してアーカイブしたオブジェクトをリストアするには
Oracle Cloud Infrastructure Consoleを使用してオブジェクト・リストアのステータスを確認するには
Oracle Cloud Infrastructure CLIを使用してアーカイブされたオブジェクトをリストアするには
Oracle Cloud Infrastructure CLIを使用してオブジェクト・リストアのステータスを確認するには

ファイルの削除

不要になったファイルは、ファイル・システムがマウントされているディレクトリから削除することで、NFSクライアントから削除します。