Cloud Storage 支援串流物件讀取作業,可讓應用程式或程序透過網路連線,直接即時使用物件位元組串流,而不必將資料副本儲存到本機磁碟或持久儲存空間。
如要下載物件並儲存至本機檔案系統,請參閱「將物件下載為檔案」一文。
在串流讀取時使用檢查碼驗證
如果您需要在處理資料前進行總和檢查碼驗證,請勿使用串流讀取。由於串流讀取通常會使用 HTTP Range 標頭,因此 Cloud Storage 不會傳回僅適用於任意要求部分物件資料的總和檢查碼。伺服器檢查碼會驗證完整物件,也就是說,系統可能會在完整串流完成並驗證前,讀取及處理已損毀的資料。
必要的角色
如要取得串流讀取所需的權限,請要求管理員授予您 bucket 的「Storage 物件檢視者」(roles/storage.objectViewer) 角色。
這個角色具備串流讀取所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
storage.objects.get
如需授予 bucket 角色的操作說明,請參閱「在 bucket 上設定及管理 IAM 政策」。
串流物件讀取作業
下列範例說明如何從 Cloud Storage 物件串流讀取資料至程序:
控制台
Cloud de Confiance 控制台不支援串流讀取作業。請改用 Google Cloud CLI。
指令列
執行
gcloud storage cp指令,並對到達網頁網址使用連字號,然後將資料填入處理程序:gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME - | PROCESS_NAME
其中:
BUCKET_NAME是包含物件的值區名稱。例如:my_app_bucket。OBJECT_NAME是您要串流至程序的物件名稱。例如:data_measurements。PROCESS_NAME是您要饋送資料的程序名稱。例如:analyze_data。
此外,您也可以將資料從 Cloud Storage 物件串流到標準的 Linux 指令,例如 sort:
gcloud storage cp gs://my_app_bucket/data_measurements - | sort
用戶端程式庫
C++
詳情請參閱「Cloud Storage C++ API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
C#
詳情請參閱「Cloud Storage C# API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Go
詳情請參閱「Cloud Storage Go API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Java
詳情請參閱「Cloud Storage Java API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Node.js
詳情請參閱「Cloud Storage Node.js API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
PHP
詳情請參閱「Cloud Storage PHP API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Python
詳情請參閱「Cloud Storage Python API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Ruby
詳情請參閱「Cloud Storage Ruby API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證作業」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。