Questo documento descrive come archiviare e recuperare i dati utilizzando libreria client di Cloud Storage. Presuppone che tu abbia completato le attività descritto in Configurazione di Cloud Storage per attivare un'istanza Cloud Storage nel bucket e scaricare le librerie client. Inoltre, presuppone che tu sappia come creare un'applicazione App Engine.
Per ulteriori esempi di codice, consulta Librerie client di Cloud Storage
Importazioni obbligatorie
Utilizza lo snippet di codice riportato di seguito per accedere a Cloud Storage utilizzando la libreria client:
Specifica il bucket Cloud Storage
Prima di eseguire qualsiasi operazione in Cloud Storage, devi fornire il bucket .Il modo più semplice per specificare un nome di bucket è utilizzare il bucket predefinito per il progetto.
La chiamata a get_default_gcs_bucket_name
riesce solo se hai creato
il bucket predefinito
per il tuo progetto.
Scrittura in Cloud Storage
L'esempio seguente mostra come scrivere nel bucket:
Tieni presente quanto segue:
Nella chiamata per aprire il file in scrittura, l'esempio specifica Intestazioni Cloud Storage che scrivono metadati personalizzati per il file; questo i metadati possono essere recuperati utilizzando
cloudstorage.stat()
. Puoi trovare l'elenco supportate nel riferimento dicloudstorage.open()
.L'intestazione
x-goog-acl
non è impostata. Ciò significa che il Cloud Storage predefinito L'ACL di lettura pubblica verrà applicato a dell'oggetto quando viene scritto nel bucket.Assicurati di richiamare la funzione per chiudere il file al termine della scrittura. Se non farlo, il file non viene scritto in Cloud Storage. Ricorda che dopo il chiami la funzione file Python
close()
, non puoi aggiungerla al file. Se devi modificare un file, devi chiamare la funzione file Pythonopen()
per riaprire il file in modalità di scrittura, operazione che esegue una sovrascrittura, non un'aggiunta.
Lettura da Cloud Storage
L'esempio seguente mostra come leggere un file completo dal bucket:
In entrambi gli esempi, l'argomento blob_name
che passi a
cloudstorage.open()
è il percorso del file in
YOUR_BUCKET_NAME/PATH_IN_GCS
. Nota
che l'impostazione predefinita per cloudstorage.open()
è la modalità di sola lettura. Non devi
è necessario specificare una modalità all'apertura di un file per leggerlo.
Elenco dei contenuti del bucket
Il codice campione mostra come navigare in un bucket con contenuti di tipo blob
:
Tieni presente che il nome file completo viene visualizzato come una stringa senza directory
delimitatori. Se vuoi visualizzare il file con la sua directory più riconoscibile
gerarchia, imposta il parametro delimiter
sul delimitatore di directory che vuoi
per gli utilizzi odierni.
Eliminazione di file in Cloud Storage
Il codice seguente mostra come eliminare un file da Cloud Storage utilizzando
cloudstorage.delete()
(importato come gcs
).
Questo esempio esegue la pulizia dei file scritti nel bucket Sezione Scrittura in Cloud Storage.
Passaggi successivi
- Visita il documentazione di riferimento API.
- Per ulteriori guide e tutorial, consulta la documentazione di Cloud Storage.