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 物件中的資料串流至 sort 等標準 Linux 指令:
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。