Questo documento descrive come archiviare e recuperare i dati utilizzando la libreria client di Cloud Storage. Per attivare un bucket Cloud Storage e scaricare le librerie client, si presume che tu abbia completato le attività descritte in Configurazione per Cloud Storage. 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 mediante la libreria client:
Specifica del bucket Cloud Storage
Prima di eseguire qualsiasi operazione in Cloud Storage, devi fornire il nome del bucket.Il modo più semplice per specificare il nome di un bucket è utilizzare il bucket predefinito per il tuo progetto.
La chiamata a get_default_gcs_bucket_name
ha esito positivo solo se hai creato il bucket predefinito per il progetto.
Scrittura in Cloud Storage
Il seguente esempio mostra come scrivere nel bucket:
Tieni presente quanto segue:
Nella chiamata per aprire il file per la scrittura, l'esempio specifica alcune intestazioni Cloud Storage che scrivono metadati personalizzati per il file; questi metadati possono essere recuperati utilizzando
cloudstorage.stat()
. Puoi trovare l'elenco delle intestazioni supportate nel riferimentocloudstorage.open()
.L'intestazione
x-goog-acl
non è impostata. Ciò significa che l'ACL Cloud Storage predefinito di public read verrà applicato all'oggetto quando viene scritto nel bucket.Assicurati di richiamare la funzione per chiudere il file al termine della scrittura. Se non lo fai, il file non viene scritto in Cloud Storage. Tieni presente che dopo aver chiamato la funzione del file Python
close()
, non puoi aggiungere elementi al file. Se devi modificare un file, devi chiamare la funzione file Pythonopen()
per riaprire il file in modalità di scrittura, eseguendo la sovrascrittura, non un'aggiunta.
Lettura da Cloud Storage
Il seguente esempio 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 formato YOUR_BUCKET_NAME/PATH_IN_GCS
. Tieni presente che l'impostazione predefinita per cloudstorage.open()
è la modalità di sola lettura. Non è necessario specificare una modalità quando si apre 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 completo del file viene visualizzato come una stringa senza delimitatori di directory. Se vuoi visualizzare il file con una gerarchia di directory più riconoscibile, imposta il parametro delimiter
sul delimitatore di directory che vuoi utilizzare.
Eliminazione di file in Cloud Storage
Il codice seguente mostra come eliminare un file da Cloud Storage utilizzando il metodo cloudstorage.delete()
(importato come gcs
).
Questo esempio esegue la pulizia dei file scritti nel bucket nella sezione Scrittura in Cloud Storage.
Passaggi successivi
- Consulta la documentazione di riferimento delle API.
- Per ulteriori guide e tutorial, consulta la documentazione di Cloud Storage.