儲存空間分析資料集資料表和結構定義

本文說明 儲存空間分析資料集中包含的資料表及其結構定義，可用於分析作業模式、監控資源用量，以及瞭解儲存空間環境中的活動。

中繼資料的資料集結構定義

以下各節說明資料集包含的中繼資料欄位。如要進一步瞭解 BigQuery 資料欄模式，請參閱「模式」。欄模式會決定 BigQuery 儲存及查詢資料的方式。

值區中繼資料

儲存空間值區中繼資料結構包含 bucket_attributes_view 和 bucket_attributes_latest_snapshot_view 資料表。值區中繼資料表包含下列欄位：

中繼資料欄位 模式 類型 說明
snapshotTime NULLABLE TIMESTAMP snapshotTime 欄位會以 RFC 3339 格式儲存 bucket 中繼資料快照的重新整理時間。從相同快照重新整理作業產生的所有記錄，都會有相同的 snapshotTime。
name NULLABLE STRING 值區名稱。
location NULLABLE STRING 值區的位置。值區中物件的物件資料會儲存在這個位置的實體儲存空間。
project NULLABLE INTEGER 值區所屬專案的專案編號。
storageClass NULLABLE STRING 值區的預設儲存空間級別。
public NULLABLE RECORD 已淘汰，這個欄位會指出值區是否可公開存取。請改用 iamConfiguration。
public.bucketPolicyOnly NULLABLE BOOLEAN 已淘汰，這個欄位是 public 記錄的一部分，表示是否已啟用統一的 bucket 層級存取權，這會禁止透過物件層級 ACL 存取。
public.publicAccessPrevention NULLABLE STRING 已淘汰，這個欄位是 public 記錄的一部分，用於指出是否禁止公開存取 bucket。
autoclass NULLABLE RECORD bucket 的自動調整級別設定，啟用後，系統會根據物件的存取方式和時間，控管物件的儲存空間級別。
autoclass.enabled NULLABLE BOOLEAN 是否啟用 Autoclass。
autoclass.toggleTime NULLABLE TIMESTAMP 上次為這個 bucket 啟用或停用自動調整級別功能的時間，採用 RFC 3339 格式。
versioning NULLABLE BOOLEAN bucket 是否已啟用版本管理。詳情請參閱「物件版本管理」。
lifecycle NULLABLE BOOLEAN bucket 是否有生命週期設定。詳情請參閱生命週期管理。
metageneration NULLABLE INTEGER 這個 bucket 的中繼資料產生作業。
timeCreated NULLABLE TIMESTAMP 儲存空間的建立時間，採用 RFC 3339 格式。
tags NULLABLE RECORD 已淘汰，這個欄位包含與 bucket 相關聯的使用者定義鍵/值組合。請改用 resourceTags。
tags.lastUpdatedTime NULLABLE TIMESTAMP 已淘汰，這個欄位會指出上次更新 tags 的時間。
tags.tagMap REPEATED RECORD 已淘汰，這個欄位是 tags 記錄的一部分，包含標記鍵和值的對應。
tags.tagMap.key NULLABLE STRING 已淘汰，這個欄位是 tags.tagMap 記錄的一部分，也是標記的鍵。
tags.tagMap.value NULLABLE STRING 已淘汰，這個欄位是 tags.tagMap 記錄的一部分，也是標記的值。
labels REPEATED RECORD 使用者提供的值區標籤，以鍵/值組合表示。
labels.key NULLABLE STRING 個別標籤項目。
labels.value NULLABLE STRING 標籤的值。
retentionPeriod NULLABLE LONG 值區資料保留政策的保留期限 (以秒為單位)。
retentionMode NULLABLE STRING 值區資料保留政策的保留模式。可能的值為 Locked 或 Unlocked。
objectRetentionEnabled NULLABLE BOOLEAN 值區是否已啟用物件保留鎖定。可能的值為 True 或 False。如果這個欄位為 True，bucket 中的物件就能有物件層級的保留設定。
defaultEventBasedHold NULLABLE BOOLEAN 值區是否已啟用預設依據事件的屬性。可能的值為 True 或 False。
softDeletePolicy NULLABLE RECORD bucket 的虛刪除政策，定義 bucket 中的物件刪除後，會處於虛刪除狀態的時間長度。處於虛刪除狀態的物件無法永久刪除，且在hardDeleteTime前可還原。
softDeletePolicy.effectiveTime NULLABLE DATETIME

軟刪除政策生效的日期時間，採用 RFC 3339 格式。

只要 softDeletePolicy.retentionDurationSeconds 增加，softDeletePolicy.effectiveTime 就會更新。
softDeletePolicy.retentionDurationSeconds NULLABLE LONG 虛刪除物件的保留時間 (以秒為單位)，在此期間無法永久刪除物件。這個值必須大於或等於 604800 (7 天)，且小於 7776000 (90 天)。值也可以設為 0，停用虛刪除政策。
enforcedEncryptionAllowedTypes REPEATED STRING 值區允許的加密類型。可能的值如下：
  • GMEK (Google-owned and Google-managed encryption keys)
  • CMEK (客戶管理的加密金鑰)
  • CSEK (客戶提供的加密金鑰)
encryption NULLABLE RECORD bucket 的加密設定。除非您在上傳時指定物件層級加密，否則 Cloud Storage 會使用這項設定，加密新增至 bucket 的物件。
encryption.defaultEncryptionType NULLABLE STRING 值區的預設加密類型。如果已設定 encryption.defaultKmsKeyName，這個值為 CMEK，否則為 GMEK。
encryption.defaultKmsKeyName NULLABLE STRING 設定用於值區中新物件的預設 Cloud Key Management Service 金鑰。如果設定這個欄位，系統會使用 Cloud Key Management Service 進行預設加密 (CMEK)。如果未設定， Google-owned and Google-managed encryption keys 會用於預設加密 (GMEK)。
iamConfiguration NULLABLE RECORD 值區的 IAM 設定。
iamConfiguration.uniformBucketLevelAccess NULLABLE RECORD 值區的統一值區層級存取權設定。
iamConfiguration.uniformBucketLevelAccess.enabled NULLABLE BOOLEAN 值區是否使用統一值區層級存取權。
iamConfiguration.publicAccessPrevention NULLABLE STRING 值區的禁止公開存取狀態，為 "inherited" 或 "enforced"。
resourceTags REPEATED RECORD bucket 的標記。詳情請參閱「Cloud Resource Manager API」。
resourceTags.key NULLABLE STRING resourceTags 鍵。
resourceTags.value NULLABLE STRING resourceTags 值。
objectCount NULLABLE INTEGER bucket 中的物件總數。
totalSize NULLABLE INTEGER 值區的總大小 (以位元組為單位)。

物件中繼資料

物件中繼資料結構定義包含 object_attributes_view 和 object_attributes_latest_snapshot_view 資料表。這些資料表包含現有物件的中繼資料、非現行物件版本 (如果已啟用物件版本管理)，以及虛刪除的物件 (如果已啟用虛刪除)。物件中繼資料表包含下列欄位：

中繼資料欄位 模式 類型 說明
snapshotTime NULLABLE TIMESTAMP snapshotTime 欄位會以 RFC 3339 格式儲存物件中繼資料快照的重新整理時間。從相同快照重新整理作業產生的所有記錄，都會有相同的 snapshotTime。
bucket NULLABLE STRING 包含這個物件的值區名稱。
location NULLABLE STRING 值區的位置。值區中物件的物件資料會儲存在這個位置的實體儲存空間。
componentCount NULLABLE INTEGER 僅適用於複合物件。複合物件中的非複合物件數量。componentCount 包含用於組合目前物件的任何複合物件所含的非複合物件。
contentDisposition NULLABLE STRING 物件資料的內容處理。
contentEncoding NULLABLE STRING 物件資料的內容編碼。
contentLanguage NULLABLE STRING 物件資料的內容語言。
contentType NULLABLE STRING 物件資料的內容類型。
contexts REPEATED RECORD 以鍵/值組合形式附加至物件的脈絡資料。如要進一步瞭解物件脈絡資料，請參閱「物件脈絡資料總覽」。
contexts.key NULLABLE STRING 物件脈絡資料鍵。
contexts.value NULLABLE STRING 物件脈絡資料鍵的值。
contexts.type NULLABLE STRING 物件內容類型，一律為 custom。
contexts.createTime NULLABLE TIMESTAMP 這個物件內容金鑰首次新增至物件的時間。採用 RFC 3339 格式。
contexts.updateTime NULLABLE TIMESTAMP 上次更新這個物件內容鍵的時間。採用 RFC 3339 格式。
crc32c NULLABLE INTEGER CRC32c 檢查碼，如 RFC 4960 附錄 B 所述；以大端序的位元組順序，使用 base64 編碼。如果物件是使用客戶自行管理的加密金鑰 (CMEK) 加密，就不會顯示這個欄位。
customTime NULLABLE TIMESTAMP 物件的使用者指定時間戳記。採用 RFC 3339 格式。
etag NULLABLE STRING 物件的 HTTP 1.1 實體標記。
eventBasedHold NULLABLE BOOLEAN 物件是否受到依據事件的訴訟保留規則約束。
generation NULLABLE INTEGER 這個物件的內容生成。
md5Hash NULLABLE STRING 資料的 MD5 雜湊，使用 base64 編碼。複合物件和使用客戶自行管理的加密金鑰 (CMEK) 加密的物件不會顯示這個欄位。
metadata REPEATED RECORD 使用者提供的中繼資料，以鍵/值組合形式呈現。
metadata.key NULLABLE STRING 個別的中繼資料項目。
metadata.value NULLABLE STRING 中繼資料值。
metageneration NULLABLE INTEGER 這個物件在這個產生時間的中繼資料版本。
name NULLABLE STRING 物件名稱。
size NULLABLE INTEGER 物件大小 (以位元組為單位)。
storageClass NULLABLE STRING 物件的儲存空間級別。
temporaryHold NULLABLE BOOLEAN 物件是否受到暫時性訴訟保留。
timeCreated NULLABLE TIMESTAMP 物件的建立時間。這個時間戳記不會變更。採用 RFC 3339 格式。
timeDeleted NULLABLE TIMESTAMP 物件的刪除時間。採用 RFC 3339 格式。如果是物件的非現行版本，timeDeleted 欄位會指出該版本成為非現行版本的時間。
updated NULLABLE TIMESTAMP 物件中繼資料的最近修改時間。採用 RFC 3339 格式。
timeStorageClassUpdated NULLABLE TIMESTAMP 上次變更物件儲存空間級別的時間。
retentionExpirationTime NULLABLE TIMESTAMP 物件最早可刪除的時間。這個值取決於為物件設定的保留設定，以及為包含物件的值區設定的保留政策。 採用 RFC 3339 格式。
retentionExpirationTimeLockStatus NULLABLE BOOLEAN 「retentionExpirationTime」的鎖定狀態。
retentionExpirationTimeSource NULLABLE STRING retentionExpirationTime 的來源。
retainUntilTime NULLABLE TIMESTAMP 指出物件層級資料保留政策設定所設定的時間，僅反映物件層級設定。物件保留的生效日期會顯示在 retentionExpirationTime 欄位中。retentionExpirationTime 是指物件層級和值區層級資料保留政策中較晚的日期。
retainUntilTimeLockStatus NULLABLE BOOLEAN retainUntilTime 的鎖定狀態，由物件層級的保留政策設定決定。
softDeleteTime NULLABLE DATETIME 物件虛刪除的時間。僅適用於設有虛刪除政策的 bucket 中的物件。
hardDeleteTime NULLABLE DATETIME 虛刪除的物件永久刪除的時間，屆時將無法還原。這個值是值區的 softDeleteTime 值和 softDeletePolicy.retentionDurationSeconds 值的總和。僅適用於設有虛刪除政策的 bucket 中的物件。
project NULLABLE INTEGER 值區所屬專案的專案編號。
ref NULLABLE RECORD 參照 Cloud Storage 物件的 BigQuery ObjectRef 值。如要在查詢中使用這個資料欄，請參閱「使用 BigQuery 分析物件資料和中繼資料」。如果物件結尾為 /，這個欄位會傳回空值。如要瞭解如何排解問題，請參閱「查詢資料集時 `ref` 資料欄中的空值」。
ref.uri NULLABLE STRING 相關聯 Cloud Storage 物件的 BigQuery 參照 URL，相當於物件的 URI。例如 gs://bucket_name/object_name。
ref.version NULLABLE STRING 相關聯 Cloud Storage 物件的 BigQuery 版本 ID，相當於物件的 generation 欄位。
ref.authorizer NULLABLE STRING 您可使用Cloud 資源連結，從 BigQuery 存取 Cloud Storage 物件。在物件中繼資料結構定義中，這個值一律為 null。
ref.details NULLABLE JSON

Cloud Storage 物件的 BigQuery 呈現方式中可用的中繼資料欄位，使用下列結構定義：

gcs_metadata json {
          "content_type": string,
          "md5_hash": string,
          "size": number,
          "updated": number
        }
encryptionType NULLABLE STRING 物件的加密類型。可能的值如下：
  • GMEK (Google-owned and Google-managed encryption keys)
  • CMEK (客戶管理的加密金鑰)
  • CSEK (客戶提供的加密金鑰)
securityInsights NULLABLE RECORD 提供物件的公開存取狀態，指出物件是否可公開讀取或寫入。詳情請參閱「找出可公開存取的物件」。
securityInsights.publicAccessInsight NULLABLE RECORD 提供物件的公開存取狀態。
securityInsights.publicAccessInsight.readPublicAccess NULLABLE STRING 物件的公開可讀取狀態。可能的值如下：
  • PUBLIC：表示物件具有授予公開存取權的權限，且沒有其他政策限制該存取權。
  • NOT_PUBLIC：表示物件受到權限或禁止政策保護，無法公開存取。
  • UNSUPPORTED：表示物件位於代管資料夾中。
  • ERROR：表示計算物件公開狀態時發生暫時性內部錯誤。現有快照不會回填失敗的公開狀態。儲存空間分析會在後續快照中還原狀態。
securityInsights.publicAccessInsight.readPublicAccessSource NULLABLE STRING 如果 readPublicAccess 為 PUBLIC，則傳回公開讀取權限的來源，否則這個欄位為 null。可能的值如下：
  • Object：表示物件層級權限。
  • Bucket：表示 bucket 層級權限。
  • ERROR：表示系統在判斷公開存取來源時發生暫時性內部錯誤。
securityInsights.publicAccessInsight.writePublicAccess NULLABLE STRING 物件的公開可寫入狀態。可能的值如下：
  • PUBLIC：表示物件具有授予公開存取權的權限，且沒有其他政策限制該存取權。
  • NOT_PUBLIC：表示物件受到權限或禁止政策保護，無法公開存取。
  • UNSUPPORTED：表示物件位於代管資料夾中。
  • ERROR：表示計算物件公開狀態時發生暫時性內部錯誤。現有快照不會回填失敗的公開狀態。儲存空間分析會在後續快照中還原狀態。

最新的值區和物件中繼資料快照

連結的資料集會透過下列專屬檢視畫面，公開值區和物件中繼資料的最新快照：

專案中繼資料

連結的資料集會將專案中繼資料公開為名為 project_attributes_view 的檢視區塊：

中繼資料欄位 模式 類型 說明
snapshotTime NULLABLE TIMESTAMP snapshotTime 欄位會以 RFC 3339 格式儲存專案中繼資料快照的重新整理時間。從相同快照重新整理作業產生的所有記錄，都會有相同的 snapshotTime。
name NULLABLE STRING 專案名稱。
id NULLABLE STRING 專案的專屬 ID。
number NULLABLE INTEGER 與專案相關聯的數值。

活動記錄資料表的資料集結構定義

儲存空間分析資料集提供活動記錄，包括作業指標、錯誤記錄和可自訂範圍的匯總檢視畫面，可滿足各種分析需求。以下各節說明活動記錄結構定義，以及這些結構定義中的可用資料。

物件活動記錄

儲存空間分析 資料集中的 object_events_view 資料表提供可查詢的記錄，包括建立、更新及刪除物件作業、中繼資料，以及這些作業期間發生的錯誤詳細資料。您可以查詢 object_events_view 檢視畫面，追蹤及排解儲存空間資產的變更。object_events_view 檢視畫面中的資料範圍為 Storage Intelligence 訂閱方案，並列出其中所有已啟用物件。

object_events_view 資料表包含下列欄位：

欄位 模式 類型 說明
requestCompletionTimestamp NULLABLE TIMESTAMP 要求完成的時間戳記，採用 RFC 3339 格式。
project NULLABLE INTEGER 擁有 bucket 資源的專案編號。
bucketName NULLABLE STRING 要求中指定的值區名稱。
objectName NULLABLE STRING 要求中指定的物件名稱。這個欄位可以為空值。
requestOperation NULLABLE STRING 執行的 Cloud Storage 作業。這個欄位僅限寫入、更新和刪除作業，且可為空值。
requestBytes NULLABLE INTEGER 要求中傳送的位元組數。
responseBytes NULLABLE INTEGER 回應中傳送的位元組數。
requestProcessingTimeMicros NULLABLE INTEGER 伺服器處理要求所花的時間 (以微秒為單位)。 這段時間的計算方式是從接收到第一個位元組開始，到傳送回應為止。如果是支援續傳的上傳作業，則作業中最後一個上傳要求收到回應時才算結束點。
requestId NULLABLE STRING 要求的 ID。
requestHost NULLABLE STRING 原始要求中指定的主機。
requestHttpMethod NULLABLE STRING 用於這項要求的 HTTP 方法。
responseStatus NULLABLE INTEGER 伺服器回應中傳送的 HTTP 狀態碼。
requestReferrer NULLABLE STRING 要求的 HTTP 轉介網站。
size NULLABLE INTEGER 物件大小 (以位元組為單位)。
generation NULLABLE INTEGER 物件的內容生成，用於物件版本管理。
timeCreated NULLABLE TIMESTAMP 物件的建立時間，採用 RFC 3339 格式。
storageClass NULLABLE STRING 物件的儲存空間級別。
errorReason NULLABLE STRING 錯誤原因 (僅限 429 錯誤)。
location NULLABLE STRING 物件的位置。

專案活動檢視畫面

「project_activity_view」表格會提供專案的匯總作業洞察資料。表格會統計作業類型、傳輸的位元組數，以及回應代碼和錯誤，彙整出活動總數。您可以運用專案活動洞察資料進行監控、追蹤及內部成本歸因。檢視畫面中的資料取決於 Storage Intelligence 訂閱範圍。這個檢視畫面只會顯示訂閱方案中已啟用儲存區和物件的匯總資料。舉例來說，如果您只為十個特定 bucket 啟用 Storage Intelligence，檢視畫面就只會顯示這十個 bucket 的資料。反之，如果您在較高層級 (機構、資料夾或專案) 啟用 Storage Intelligence，系統會自動納入該範圍內的所有值區和物件，並在檢視畫面中顯示這些項目的匯總資料。

project_activity_view 資料表包含下列欄位：

欄位 模式 類型 說明
snapshotStartTime NULLABLE TIMESTAMP 快照的開始時間，採用 RFC 3339 格式。
snapshotEndTime NULLABLE TIMESTAMP 快照的結束時間，採用 RFC 3339 格式。
project NULLABLE INTEGER 專案編號。
totalRequests NULLABLE INTEGER 專案提出的要求總數。
totalReads NULLABLE INTEGER 讀取作業總數。
totalWrites NULLABLE INTEGER 寫入作業的總數。
totalUpdates NULLABLE INTEGER 更新作業總數。
totalDeletes NULLABLE INTEGER 刪除作業總數。
totalLists NULLABLE INTEGER 列出作業的總數。
totalRequestBytes NULLABLE INTEGER 傳輸的要求位元組總數。
totalResponseBytes NULLABLE INTEGER 傳輸的回應位元組總數。
count4xx NULLABLE INTEGER 4xx 錯誤總數。
count5xx NULLABLE INTEGER 5xx 錯誤總數。
count2xx NULLABLE INTEGER 2xx 成功回應的總數。
count400 NULLABLE INTEGER 不良要求的 400 錯誤總數。
count401 NULLABLE INTEGER 未經授權要求發生 401 錯誤的總次數。
count403 NULLABLE INTEGER 遭拒要求的 403 錯誤總數。
count429 NULLABLE INTEGER 要求超出用量限制時，429 錯誤的總數。

bucket 活動檢視畫面

「bucket_activity_view」表格會提供 bucket 的匯總作業洞察資料。這份表格會匯總活動總數，並列出作業類型、傳輸的位元組數、回應代碼、錯誤，以及前幾項前置字元的詳細資料。您可以運用 bucket 活動洞察資料，在 bucket 層級進行監控、疑難排解、計量，以及分析最活躍和最不活躍的 bucket。bucket_activity_view 表格中的資料範圍限定為您的 Storage Intelligence 訂閱項目，並包含所有已啟用 bucket 的記錄。

bucket_activity_view 資料表包含下列欄位：

欄位 模式 類型 說明
snapshotStartTime NULLABLE TIMESTAMP 快照的開始時間，採用 RFC 3339 格式。
snapshotEndTime NULLABLE TIMESTAMP 快照的結束時間，採用 RFC 3339 格式。
name NULLABLE STRING 值區名稱。
generation NULLABLE INTEGER 值區的版本編號。
project NULLABLE INTEGER 專案編號。
location NULLABLE STRING bucket 的位置。
totalRequests NULLABLE INTEGER 對值區提出的要求總數。
totalReads NULLABLE INTEGER 讀取作業總數。
totalWrites NULLABLE INTEGER 寫入作業的總數。
totalUpdates NULLABLE INTEGER 更新作業總數。
totalDeletes NULLABLE INTEGER 刪除作業總數。
totalLists NULLABLE INTEGER 列出作業的總數。
totalRequestBytes NULLABLE INTEGER 傳輸的要求位元組總數。
totalResponseBytes NULLABLE INTEGER 傳輸的回應位元組總數。
count4xx NULLABLE INTEGER 4xx 錯誤總數。
count5xx NULLABLE INTEGER 5xx 錯誤總數。
count2xx NULLABLE INTEGER 2xx 成功回應的總數。
count400 NULLABLE INTEGER 不良要求的 400 錯誤總數。
count401 NULLABLE INTEGER 未經授權要求發生 401 錯誤的總次數。
count403 NULLABLE INTEGER 遭拒要求的 403 錯誤總數。
count429 NULLABLE INTEGER 要求超出用量限制時，429 錯誤的總數。
topPrefixes429Errors REPEATED RECORD 發生最多 429 錯誤的前 5 個 bucket 前置字元，以 RECORD 形式傳回，其中包含前置字元 (STRING) 和錯誤計數 (INTEGER)。
topPrefixesRequestBytes REPEATED RECORD 傳回要求位元組數最多的前 5 個 bucket 前置字元，格式為包含前置字元的 STRING 和包含計數的 INTEGER 的 RECORD。
topPrefixesResponseBytes REPEATED RECORD 回應位元組數最多的前 5 個 bucket 前置字元，以 RECORD 形式傳回，其中包含前置字元 (STRING) 和計數 (INTEGER)。
topPrefixesHighestOperations REPEATED RECORD 作業數量最多的前 5 個 bucket 前置字元，以 RECORD 形式傳回，其中包含前置字元 (STRING) 和計數 (INTEGER)。

值區區域活動檢視畫面

bucket_region_activity_view 表格會依目的地區域匯總，顯示 bucket 傳送及接收的總位元組數。使用 bucket 活動區域資料找出最活躍的區域，協助您判斷最佳 bucket 位置、分析區域輸出，並視需要考慮遷移 bucket，以提升效能、降低成本或提高復原能力。bucket_region_activity_view 表格中的資料範圍為您的 Storage Intelligence 訂閱項目，並包含所有已啟用儲存空間的記錄。

欄位 模式 類型 說明
snapshotStartTime NULLABLE TIMESTAMP 快照的開始時間，採用 RFC 3339 格式。
snapshotEndTime NULLABLE TIMESTAMP 快照的結束時間，採用 RFC 3339 格式。
project NULLABLE INTEGER 水桶的專案編號。
name NULLABLE STRING 值區名稱。
generation NULLABLE INTEGER 值區的版本編號。
requestLocation NULLABLE STRING 要求來源的 Google Cloud 位置。
bucketLocation NULLABLE STRING bucket 的位置。
requestBytes NULLABLE INTEGER 在指定值區和位置之間，要求傳輸的位元組總數。
responseBytes NULLABLE INTEGER 在指定 bucket 和位置之間，回應傳輸的位元組總數。

事件和錯誤的資料集結構定義

在連結的資料集中，您也可以在 events_view 和 error_attributes_view 檢視畫面中查看快照處理事件和錯誤。如要排解快照處理錯誤，請參閱「排解資料集錯誤」。

事件記錄

您可以在連結資料集的 events_view 檢視畫面中查看事件記錄：

中繼資料欄位 模式 類型 說明
manifest.snapshotTime NULLABLE TIMESTAMP 事件快照的重新整理時間，採用 RFC 3339 格式。
manifest.viewName NULLABLE STRING 要重新整理的檢視區塊名稱。
manifest.location NULLABLE STRING 要重新整理的資料來源位置。
globalManifest.snapshotTime NULLABLE TIMESTAMP 所有來源位置的 Bucket 和物件屬性資料表，其擷取完成時間採用 RFC 3339 格式。
eventTime NULLABLE TIMESTAMP 事件發生的時間。
eventCode NULLABLE STRING 與對應項目相關聯的事件代碼。eventCode 值如下：
  • eventCode 1 表示 manifest.viewName 檢視畫面已重新整理，並顯示快照 (manifest.snapshotTime) 中來源位置 (manifest.location) 的所有項目。
  • eventCode 2 表示資料集已重新整理，並包含所有來源位置的 bucket 和物件項目。重新整理作業會在快照 (globalManifest.snapshotTime) 內進行。
  • eventCode 3 是指活動記錄檢視畫面會重新整理，並顯示記錄視窗內來源位置的所有項目。(manifest.location)

錯誤代碼

您可以在連結資料集的 error_attributes_view 表格中查看錯誤代碼：

中繼資料欄位 模式 類型 說明
errorCode NULLABLE INTEGER 與這個項目相關的錯誤代碼。如需有效值清單和解決這類錯誤的方法，請參閱「排解資料集錯誤」。
errorSource NULLABLE STRING 錯誤來源。有效值：CONFIGURATION_PREPROCESSING。
errorTime NULLABLE TIMESTAMP 發生錯誤的時間。
sourceGcsLocation NULLABLE STRING 發生錯誤的來源 Cloud Storage 位置。專案不會與位置相關聯，因此這個欄位為空值。
bucketErrorRecord.bucketName NULLABLE STRING 發生錯誤的值區名稱。您可以使用這項資訊偵錯 bucket 錯誤。
bucketErrorRecord.serviceAccount NULLABLE STRING 需要從 bucket 擷取物件的服務帳戶。您可以使用這項資訊偵錯 bucket 錯誤。
projectErrorRecord.projectNumber NULLABLE INTEGER 發生錯誤的專案數量。您可以使用這項資訊偵錯專案錯誤。
projectErrorRecord.organizationName NULLABLE STRING 專案必須隸屬的機構名稱，才能進行處理。如果值為 0，表示專案不在機構中。您可以使用這項資訊偵錯專案錯誤。

排解資料集錯誤

如要排解連結資料集中 error_attributes_view 檢視畫面記錄的快照處理錯誤，請參閱下表：

錯誤代碼 錯誤案例 錯誤訊息 疑難排解
1 來源專案不屬於該機構 來源專案 projectErrorRecord.projectNumber 不屬於機構 projectErrorRecord.organizationName。 將來源專案 projectErrorRecord.projectNumber 新增至機構 projectErrorRecord.organizationName。如要瞭解如何在機構之間遷移專案，請參閱「在機構之間遷移專案」。
2 Bucket 授權錯誤 權限遭拒，無法擷取 bucket bucketErrorRecord.bucketName 的物件。 授予服務帳戶 bucketErrorRecord.serviceAccount Identity and Access Management (IAM) 權限，允許擷取值區 bucketErrorRecord.bucketName 的物件。詳情請參閱「將必要權限授予服務代理」。
3 目的地專案不屬於該機構 目的地專案 projectErrorRecord.projectNumber 不屬於機構 projectErrorRecord.organizationName。 將目的地專案 projectErrorRecord.projectNumber 新增至組織 projectErrorRecord.organizationName。如要瞭解如何在機構之間遷移專案，請參閱「在機構之間遷移專案」。
4 來源專案未設定 Storage Intelligence。 來源專案 projectErrorRecord.projectNumber 未設定 Storage Intelligence。 為來源專案設定 Storage Intelligence projectErrorRecord.projectNumber。詳情請參閱「設定及管理 Storage Intelligence」。
5 Bucket 未設定 Storage Intelligence。 Bucket bucketErrorRecord.bucketName 未設定 Storage Intelligence。 為 bucket bucketErrorRecord.bucketName 設定 Storage Intelligence。詳情請參閱「設定及管理 Storage Intelligence」。
6 Bucket 存取驗證錯誤 ACTIVITY_BUCKET_ACCESS_AUTHORIZATION_ERROR，適用於 bucket bucketErrorRecord.bucketName。 授予服務帳戶 bucketErrorRecord.serviceAccount Identity and Access Management (IAM) 權限，允許擷取值區 bucketErrorRecord.bucketName 的活動。詳情請參閱「將必要權限授予服務代理」。

後續步驟