啟用或停用註釋資料表

根據預設，您的中繼資料表組態包含日誌資料表，表中記錄了儲存貯體中物件發生的事件。每個中繼資料表組態都需要日誌資料表。

或者，您可以將註釋資料表新增至中繼資料資料表組態。註釋資料表會追蹤儲存貯體中物件的所有註釋，讓您可以大規模查詢註釋資料。

註釋資料表包含儲存貯體中所有物件的最新註釋。您可以使用此表格，根據物件的註釋來識別物件，以簡化和加速業務工作流程和大數據任務。例如，您可以查詢註釋資料表來執行下列動作：

尋找具有特定註釋索引鍵或值的所有物件。
在儲存貯體中的物件之間建立註釋索引鍵的分佈。
尋找具有特定委託人套用註釋的所有物件。

如果您選擇為中繼資料資料表組態啟用註釋資料表，則資料表會經歷稱為回填的程序，在此期間，Amazon S3 會掃描您的一般用途儲存貯體，以擷取並填入儲存貯體中所有物件的註釋。視儲存貯體中的物件數量而定，此程序可能需要幾分鐘到數小時的時間。回填程序完成後，註釋資料表的狀態會從回填變更為作用中。回填完成後，物件的更新通常會在一小時內反映在註釋資料表中。

注意

您需要支付回填註釋資料表的費用。如需詳細資訊，請參閱 Amazon S3 定價。
您無法暫停註釋資料表的更新，然後繼續更新。不過，您可以停用註釋資料表組態。停用註釋資料表並不會將其刪除。註釋資料表會保留給您的記錄，直到您決定將其刪除為止。

如果您已停用註釋資料表，但之後想要重新啟用，您必須先從 AWS 受管資料表儲存貯體中刪除舊的註釋資料表。當您重新啟用註釋資料表組態時，Amazon S3 會建立新的註釋資料表，而且會再次向您收取重新填入新註釋資料表的費用。

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、 AWS SDKs 或 Amazon S3 REST API 來啟用或停用註釋資料表。

先決條件

如果您已停用註釋資料表，現在想要重新啟用，您必須先從 AWS 受管資料表儲存貯體手動刪除舊的註釋資料表。否則，重新啟用註釋資料表會失敗，因為註釋資料表已存在於資料表儲存貯體中。若要刪除註釋資料表，請參閱刪除中繼資料表。

當您重新啟用註釋資料表組態時，Amazon S3 會建立新的註釋資料表，而且會再次向您收取重新填入新註釋資料表的費用。

註釋資料表 IAM 角色

註釋資料表需要 IAM 角色，授予 Amazon S3 Metadata 從儲存貯體讀取註釋的許可。當您建立此角色時，請使用下列信任和許可政策。

信任政策

下列信任政策會將 Amazon S3 Metadata 識別為可擔任該角色的服務主體。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "metadata.s3.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:s3:::amzn-s3-demo-bucket"
                }
            }
        }
    ]
}

許可政策

下列許可政策授予 IAM 角色讀取註釋所需的最低許可。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PermissionForGetAnnotation",
      "Effect": "Allow",
      "Action": [
        "s3:GetObjectAnnotation",
        "s3:GetObjectVersionAnnotation"
      ],
      "Resource": ["arn:aws:s3:::amzn-s3-demo-bucket/*"]
    },
    {
      "Sid": "PermissionsForListBucket",
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket",
        "s3:ListBucketVersions"
      ],
      "Resource": ["arn:aws:s3:::amzn-s3-demo-bucket"]
    },
    {
      "Sid": "PermissionsForDecryptAnnotation",
      "Effect": "Allow",
      "Action": ["kms:Decrypt"],
      "Resource": ["*"]
    }
  ]
}

如果您的物件使用 SSE-KMS 加密，則 kms:Decrypt許可涵蓋用於加密物件之 AWS KMS 金鑰的解密。您也需要將角色指派給註釋資料表組態的iam:PassRole許可。