Cloud Storage supporta il flusso di dati da un bucket a un processo senza richiedere prima il salvataggio dei dati in un file.
Utilizzo della convalida del checksum durante il flusso di dati
Non utilizzare un download in streaming se hai bisogno di una convalida del checksum
prima che i dati diventino accessibili. Questo perché i download in streaming utilizzano
l'intestazione Range
e Cloud Storage non restituisce i checksum
che si applicano solo alla parte richiesta dei dati dell'oggetto.
Ti consigliamo di utilizzare sempre la convalida del checksum al completamento di un download in streaming; mentre la convalida avviene dopo il download significa che i dati danneggiati sono accessibili durante il tempo richiesto per confermare il danneggiamento e rimuoverlo.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per i download in streaming, chiedi al tuo
che ti conceda il visualizzatore oggetti Storage
(roles/storage.objectViewer
) nel bucket.
Questo ruolo contiene l'autorizzazione necessaria per trasmettere in streaming i download. Per vedere le l'autorizzazione esatta richiesta, espandi la sezione Autorizzazioni obbligatorie sezione:
Autorizzazioni obbligatorie
storage.objects.get
Potresti riuscire a ottenere questa autorizzazione anche con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli nei bucket, consulta Utilizzare IAM con i bucket.
Riprodurre in streaming un download
I seguenti esempi mostrano come eseguire un download da un Cloud Storage a un processo:
Console
La console Google Cloud non supporta i download in streaming. Utilizza la Google Cloud CLI.
Riga di comando
Esegui il comando
gcloud storage cp
utilizzando un trattino per URL di destinazione, quindi indirizza i dati al processo:gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME - | PROCESS_NAME
Dove:
BUCKET_NAME
è il nome del bucket che contiene l'oggetto. Ad esempio,my_app_bucket
.OBJECT_NAME
è il nome dell'oggetto che di flussi di dati verso il processo. Ad esempio:data_measurements
.PROCESS_NAME
è il nome del processo in cui vengono inseriti i dati. Ad esempio,analyze_data
.
Puoi inoltre trasmettere flussi di dati da un oggetto Cloud Storage a un comando Linux standard come sort:
gcloud storage cp gs://my_app_bucket/data_measurements - | sort
Librerie client
C
Per ulteriori informazioni, consulta API Cloud Storage C documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Per eseguire un download in streaming, segui le istruzioni per download di un oggetto con le seguenti considerazioni:
Prima di iniziare il download, recupera i metadati dell'oggetto e salva il numero di generazione dell'oggetto. Includi questa generazione numero in ogni richiesta per assicurarti di non scaricare i dati da due generazioni diverse, nel caso in cui l'originale sovrascritto.
Utilizza l'intestazione
Range
nella richiesta per recuperare una parte di l'oggetto complessivo, che puoi inviare a un processo locale.Continua a fare richieste di parti successive dell'oggetto, fino a è stato recuperato l'intero oggetto.
API XML
Per eseguire un download in streaming, segui le istruzioni per download di un oggetto con le seguenti considerazioni:
Prima di iniziare il download, recupera i metadati dell'oggetto e salva il numero di generazione dell'oggetto. Includi questa generazione numero in ogni richiesta per assicurarti di non scaricare i dati da due generazioni diverse, nel caso in cui l'originale sovrascritto.
Utilizza l'intestazione
Range
nella richiesta per recuperare una parte di l'oggetto complessivo, che puoi inviare a un processo locale.Continua a fare richieste di parti successive dell'oggetto, fino a è stato recuperato l'intero oggetto.
Passaggi successivi
- Riprodurre in streaming un caricamento.
- Scopri di più sulla Transcodifica decompressiva.
- Scopri di più su caricamenti e download.