Oracle Cloud Infrastructureドキュメント

Storage Gatewayファイル管理操作を使用した

このトピックでは、Storage Gatewayファイル管理操作の使用方法について説明します。

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

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

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

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

ノート

Storage Gatewayでは、128 MBより大きいファイルのマルチパートのアップロードが自動的に実行されます(詳細は、「マルチパート・アップロードの使用」を参照)。

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

ファイルを読む

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

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

ノート

読取りキャッシュに存在しないファイルの読取りまたは書込みを試み、ファイルがArchive層に格納されている場合は、Input/Ouput errorが表示されます。

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

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

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

Archive Storageからのファイル/オブジェクトのリストア

Storage Gatewayコマンド行からファイル・リストアを開始できます。 Oracle Cloud InfrastructureArchive Storageからオブジェクトのリストアを開始し、オブジェクトがObject Storageにリストアされた後、対応するファイルStorage Gatewayを使用して読み取ることもできます。

ノート

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

Storage Gatewayコマンド行を使用したアーカイブ済ファイルのリストア

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

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

重要

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

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

ファイルの削除

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