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

Storage Insights 資料集提供 BigQuery 資料表和檢視表，可讓您分析作業模式，並監控 Cloud Storage bucket、物件和專案的資源用量。您可以使用這些結構定義編寫查詢，稽核儲存空間用量、驗證安全性設定，以及追蹤儲存環境中的活動。

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

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

您可以將儲存空間批次作業與 Storage Insights 資料集連結，以動態選取資料。這種方法可讓您直接使用篩選運算式查詢資料集資料欄，而不必使用手動資訊清單檔案。下表中的「Storage batch operations filterable」欄，指出直接在 Google Cloud CLI 中建構一般運算語言 (CEL) 篩選器引數 (--bucket-filters 或 --object-filters) 時，是否支援中繼資料欄位。如果支援某個欄位，您可以直接在篩選運算式中參照該欄位的資料欄名稱。如要進一步瞭解支援的語法，請參閱 CEL 篩選器參考資料。

值區中繼資料

bucket 中繼資料結構定義包含 bucket_attributes_view 和 bucket_attributes_latest_snapshot_view 資料表。值區中繼資料表包含下列欄位：

中繼資料欄位 模式 類型 說明 可篩選儲存空間批次作業
snapshotTime NULLABLE TIMESTAMP snapshotTime 欄位會以 RFC 3339 格式儲存值區中繼資料快照的重新整理時間。從同一個快照重新整理作業產生的所有記錄，都會有相同的 snapshotTime。
name NULLABLE STRING 值區名稱。
location NULLABLE STRING 值區的位置。bucket 中物件的物件資料會存放在這個位置的實體儲存空間。
project NULLABLE INTEGER bucket 所屬專案的編號。
storageClass NULLABLE STRING bucket 的預設儲存空間級別。
public NULLABLE RECORD 已淘汰，這個欄位會指出 bucket 是否可公開存取。請改用 iamConfiguration。
public.bucketPolicyOnly NULLABLE BOOLEAN 已淘汰，這個欄位是 public 記錄的一部分，指出是否啟用統一 bucket 層級存取權，這會防止透過物件層級 ACL 存取。
public.publicAccessPrevention NULLABLE STRING 已淘汰，這個欄位是 public 記錄的一部分，指出是否禁止公開存取 bucket。
autoclass NULLABLE RECORD bucket 的自動調整級別設定，啟用後會根據物件的存取方式和時間，控管物件的儲存空間級別。
autoclass.enabled NULLABLE BOOLEAN 是否啟用自動調整級別。
autoclass.toggleTime NULLABLE TIMESTAMP 上次為這個 bucket 啟用或停用自動調整級別的時間，採用 RFC 3339 格式。
versioning NULLABLE BOOLEAN 值區是否已啟用版本管理功能。詳情請參閱「物件版本管理」。
lifecycle NULLABLE BOOLEAN bucket 是否有生命週期設定。詳情請參閱生命週期管理。
metageneration NULLABLE INTEGER 這個 bucket 的中繼資料代別。
timeCreated NULLABLE TIMESTAMP bucket 的建立時間，採用 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，值區中的物件可以有物件層級的保留設定。
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 虛刪除物件的保留時間 (以秒為單位)，期間內無法永久刪除。這個值必須大於或等於 7 天，且小於 90 天。您也可以將值設為 0，停用虛刪除政策。
enforcedEncryptionAllowedTypes REPEATED STRING bucket 允許的加密類型。可能的值如下：
  • 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 金鑰，用於 bucket 中的新物件。如果設定這個欄位，系統會使用 Cloud Key Management Service 進行預設加密 (CMEK)。如未設定，系統會使用 Google-owned and Google-managed encryption keys 進行預設加密 (GMEK)。
iamConfiguration NULLABLE RECORD bucket 的 IAM 設定。
iamConfiguration.uniformBucketLevelAccess NULLABLE RECORD bucket 的統一 bucket 層級存取權設定。
iamConfiguration.uniformBucketLevelAccess.enabled NULLABLE BOOLEAN bucket 是否使用統一 bucket 層級存取權。
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 值區的位置。bucket 中物件的物件資料會存放在這個位置的實體儲存空間。
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 bucket 所屬專案的編號。
ref NULLABLE RECORD 參照 Cloud Storage 物件的 BigQuery ObjectRef 值。如要在查詢中使用這個資料欄，請參閱「使用 BigQuery 分析物件資料和中繼資料」。如果物件結尾為 /，這個欄位會傳回空值。如要瞭解如何疑難排解，請參閱「查詢資料集時，ref 欄中出現空值」。
ref.uri NULLABLE STRING 相關聯 Cloud Storage 物件的 BigQuery 參考網址，等同於物件的 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：表示計算物件的公開狀態時，發生暫時性內部錯誤。現有快照不會回填失敗的公開狀態。儲存空間分析會在後續快照中還原狀態。

最新 bucket 和物件中繼資料快照

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

  • bucket_attributes_latest_snapshot_view 資料表提供 Cloud Storage bucket 的最新中繼資料。其結構與值區中繼資料結構定義相符。

  • object_attributes_latest_snapshot_view 資料表提供 Cloud Storage 物件的最新中繼資料。其結構與物件中繼資料架構相符。

專案中繼資料

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

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

物件結構定義目錄

連結的資料集會以名為 object_contexts_catalog_view 的檢視表，公開物件情境的最新中繼資料，包括擴充資料酬載 (預先發布版)。

object_contexts_catalog_view 檢視表提供 Cloud Storage 物件的最新背景資訊。目錄檢視畫面每 24 小時更新一次。初始載入作業需要 24 到 48 小時。新值區或重新定位值區中的物件會在 24 到 48 小時內顯示。

object_contexts_catalog_view 資料表包含下列欄位：

中繼資料欄位 模式 類型 說明
project NULLABLE INTEGER 值區所屬專案的編號。
bucket NULLABLE STRING 包含這個物件的值區名稱。
name NULLABLE STRING 物件名稱。
generation NULLABLE INTEGER 這個物件的內容產生作業。
location NULLABLE STRING 物件的位置。
createdTime NULLABLE STRING 物件的建立時間。
catalogUpdatedTime NULLABLE TIMESTAMP 目錄中項目的更新時間。
contexts REPEATED RECORD 附加至物件的背景資訊項目陣列。
contexts.key NULLABLE STRING 情境項目的索引鍵 (例如 google:annotation:label-detector-v1)。
contexts.value NULLABLE STRING 與情境索引鍵相關聯的字串值。
contexts.contextCreationTime NULLABLE TIMESTAMP 這個特定脈絡項目的建立時間。
contexts.contextUpdateTime NULLABLE TIMESTAMP 這項特定脈絡項目的上次更新時間。
contexts.extendedData (預先發布版) NULLABLE JSON JSON 物件，包含情境的結構化擴充資料酬載 (例如機器學習模型定界框和標籤)。如果情境沒有擴充資料，這個欄位會是 NULL。

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

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

物件活動資料

Storage Insights 資料集中的 object_events_view 資料表提供可查詢的記錄，包括建立、更新和刪除物件作業、中繼資料，以及這些作業期間發生的錯誤詳細資料。您可以查詢 object_events_view 檢視表，使用這些資料追蹤儲存空間資產的變更，並排解相關問題。object_events_view 檢視表中的資料範圍限定於 Storage Intelligence 訂閱項目，並列出其中所有已啟用的物件。

object_events_view 資料表包含下列欄位：

欄位 模式 類型 說明
requestCompletionTimestamp NULLABLE TIMESTAMP 要求完成的時間戳記，採用 RFC 3339 格式。
project NULLABLE INTEGER 值區資源所屬專案的編號。
bucketName NULLABLE STRING 要求中指定的 bucket 名稱。
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 和物件的匯總資料。舉例來說，如果只為十個特定 bucket 啟用 Storage Intelligence，檢視畫面就只會顯示這十個 bucket 的資料。相反地，如果您在較高層級 (組織、資料夾或專案) 啟用 Storage Intelligence，該範圍內的所有 bucket 和物件都會自動納入，且檢視畫面會顯示這些項目的匯總資料。

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 對 bucket 提出的要求總數。
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 前置字串，以 RECORD 形式傳回，其中前置字串為 STRING，計數為 INTEGER。
topPrefixesResponseBytes REPEATED RECORD 回應位元組數最多的前 5 個 bucket 前置字串，以 RECORD 形式傳回，其中前置字串為 STRING，計數為 INTEGER。
topPrefixesHighestOperations REPEATED RECORD 作業數量最多的前 5 個 bucket 前置字串，以 RECORD 形式傳回，其中前置字串為 STRING，數量為 INTEGER。

bucket 區域活動檢視畫面

bucket_region_activity_view 資料表會匯總 bucket 傳送和接收的位元組總數，並依目的地地區匯總。您可以運用 bucket 活動區域資料，找出最活躍的區域，進而決定最佳 bucket 位置、分析區域輸出，並視需要考慮bucket 遷移，以最佳化效能、成本或韌性。bucket_region_activity_view 資料表中的資料範圍僅限於您的 Storage Intelligence 訂閱項目，並包含所有已啟用 bucket 的記錄。

欄位 模式 類型 說明
snapshotStartTime NULLABLE TIMESTAMP 快照的開始時間，採用 RFC 3339 格式。
snapshotEndTime NULLABLE TIMESTAMP 快照的結束時間，採用 RFC 3339 格式。
project NULLABLE INTEGER bucket 的專案編號。
name NULLABLE STRING 值區名稱。
generation NULLABLE INTEGER 值區的版本編號。
requestLocation NULLABLE STRING 要求來源的 Google Cloud 位置。
bucketLocation NULLABLE STRING bucket 的位置。
requestBytes NULLABLE INTEGER 在指定 bucket 和位置之間，要求傳輸的位元組總數。
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 所有來源位置的值區和物件屬性資料表擷取完成時間，採用 RFC 3339 格式。
eventTime NULLABLE TIMESTAMP 事件發生的時間。
eventCode NULLABLE STRING 與對應項目相關聯的事件代碼。eventCode 值如下：
  • eventCode 1 表示 manifest.viewName 檢視畫面已重新整理，並顯示快照 (manifest.snapshotTime) 中來源位置 (manifest.location) 的所有項目。
  • eventCode 2 表示資料集已更新，其中包含所有來源位置的值區和物件項目。重新整理作業會在快照 (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 擷取物件的服務帳戶。您可以利用這項資訊對值區錯誤進行偵錯。
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 的物件。 將 Identity and Access Management (IAM) 權限授予服務帳戶 bucketErrorRecord.serviceAccount，允許擷取 bucket bucketErrorRecord.bucketName 的物件。詳情請參閱「將必要權限授予服務代理」。
3 目的地專案不屬於該組織 目的地專案 projectErrorRecord.projectNumber 不在組織 projectErrorRecord.organizationName 中。 將目的地專案 projectErrorRecord.projectNumber 新增至組織 projectErrorRecord.organizationName。如要瞭解如何在組織之間遷移專案，請參閱「在組織之間遷移專案」。
4 來源專案未設定 Storage Intelligence。 來源專案 projectErrorRecord.projectNumber 未設定 Storage Intelligence。 為來源專案 projectErrorRecord.projectNumber 設定 Storage Intelligence。詳情請參閱「設定及管理 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) 權限授予，允許擷取 bucket bucketErrorRecord.bucketName 的活動。詳情請參閱「將必要權限授予服務代理」。

後續步驟