tencent cloud

Cloud Object Storage

ドキュメントCloud Object Storageデータレークストレージメタデータアクセラレーションデータ管理メタデータアクセラレーションバケットのインベントリ機能

メタデータアクセラレーションバケットのインベントリ機能

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-11-24 11:42:46
メタデータアクセラレーションバケットはCOSバケットインベントリ機能を再利用しており、Hadoop OIVツールのようなファイルメタデータのエクスポートを提供します。メタデータアクセラレーションバケットは、ユーザーのインベントリタスク設定に基づき、毎日または毎週、バケット内の指定されたパス配下にあるファイルを定期的にスキャンし、インベントリレポートをCSV形式のファイルとしてユーザー指定のパスに出力します。ファイル分析、監査、ガバナンスなどのシナリオに適しています。
説明：
現在、メタデータアクセラレーションバケットのインベントリ機能はホワイトリスト形式でパブリックベータテスト中です。本記事は、パブリックベータ期間中の説明としてのみ使用されます。インベントリ機能の有効化を申請する必要がある場合は、お問い合わせください。
パブリックベータ期間中、インベントリ機能にCOS管理機能料金は発生しません。将来の課金に関する説明は、サイトの通知および公式サイトのドキュメントの記載に準じます。

利用制限

メタデータアクセラレーションバケットのインベントリは、パブリックベータ期間中、以下の制限がありますのでご了承ください。
1つのCOSメタデータアクセラレーションバケットに設定できるインベントリルールの最大数は5件です。
説明：
通常、バケットのルートパスをインベントリのスキャンパスとして設定することを推奨します。もし5件を超えるルール設定が必要なシナリオの場合は、お問い合わせください。
バケットをまたいだインベントリレポートの配信はサポートしていません。タスク設定におけるターゲットパスは、ソースバケットと一致させる必要があります。
インベントリは現在、カスタムIDをサポートしていません。タスク作成後にタスクIDが自動的に割り当てられます。このIDはList APIで照会可能です。
メタデータアクセラレーションバケットは現在、リアルタイム更新インベントリをサポートしていません。

インベントリレポートの配信について

ユーザーがインベントリタスクを設定すると、COSは設定に基づき、バケット内の指定パス配下にあるファイルを定期的にスキャンし、CSV形式のインベントリレポートを出力します。レポートの配信パスはタスク設定で指定可能で、CSVファイルの具体的なパスは以下の通りです：
destination-prefix/YYYY-MM-DD-HH/Data/8d1048acf48096d17502bd62efc9f8c1.csv
destination-prefix：ユーザーがインベントリ配信タスクで指定した配信パス。
YYYY-MM-DD-HH：タイムスタンプ。インベントリタスクが実行された年、月、日、時刻。
説明：
パス内の「時刻」はタスクが開始された時刻であり、実際の配信時刻とは異なります。COSメタデータアクセラレーションバケットは、日次レベルのタスクのみを設定できます。初回設定時または前回の配信から24時間以内にレポートが1件生成されます。固定時刻でのタスク実行やレポート配信を指定することはできません。
インベントリレポート：CSV形式で配信されます。ファイル名はCOSによって生成されたランダムな値です。

インベントリタスクは設定ルールに従ってパス配下のファイルをスキャンします。生成されるレポートにはヘッダー情報は含まれません。レポートに出力されるフィールドの順序と説明は以下の通りです。
フィールド
説明
FileName
ファイル名
ATime
ファイルのアクセス日時
説明：
読み書きパフォーマンスを確保するため、メタデータアクセラレーションバケットはデフォルトでATimeの追跡を有効にしていません。ATime機能のご利用が必要な場合は、お問い合わせください。
MTime
ファイル内容の変更日時
CTime
ファイルメタデータの変更日時
Size
ファイルサイズ（単位：Byte）
FileType
ファイルの状態をディレクトリまたはファイルとして出力します。出力形式：DIR（ディレクトリ）またはFILE（ファイル）
ACL
ファイルの権限を数字で出力します。例：755
UserName
ユーザー名。例：hadoop
GroupName
ユーザーグループ名。例：supergroup
StorageClass
現在のファイルのストレージタイプ。以下の値のいずれかになります：
STANDARD（標準ストレージ）
DEGRADE（低頻度ストレージ）
ARCHIVE（アーカイブストレージ）
DEEP_ARCHIVE（ディープアーカイブストレージ）
ARCHIVE+STANDARD（アーカイブストレージが復元済み）
DEEP_ARCHIVE+STANDARD（ディープアーカイブストレージが復元済み）

インベントリの設定方法

現在、COSメタデータアクセラレーションバケットは、コンソールでのインベントリ設定をサポートしていません。API経由でのみ設定可能です。具体的な手順は以下の通りです。
1. COSロールの作成。
2. COSロールへの権限の紐付け。
3. インベントリ機能の有効化。

1. COSロールの作成。

COSロールを作成します。詳細なAPI情報についてはCreateRoleをご参照ください。
ここで、roleNameは、COS_QcsRoleである必要があります。
policyDocumentは以下の通りです。
{
    "version": "2.0",
    "statement": [{
        "action": "name/sts:AssumeRole",
        "effect": "allow",
        "principal": {
            "service": "cos.cloud.tencent.com"
        }
    }]
}

2. COSロールへの権限の紐付け

ロールに権限を紐付けます。詳細なAPI情報についてはAttachRolePolicyをご参照ください。
ここで、policyNameは、QcloudCOSFullAccessを、roleNameは、ステップ1のCOS_QcsRole（またはroleName作成時に返されたroleID）を使用します。

3. インベントリ機能の有効化

APIによるインベントリ機能の有効化。COSメタデータアクセラレーションバケットは、インベントリ機能を再利用しており、COS Inventory APIによるインベントリの設定をサポートしています。メタデータアクセラレーションバケットの特性により、APIの一部のフィールドはCOSインベントリAPIと異なります。具体的な呼び出し方法は、以下のAPI例をご参照ください。




前の記事へ: メタデータアクセラレーションバケットのライフサイクル次の記事へ: メタデータアクセラレーション機能を有効にしたバケットへのHDFSデータの移行

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック