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
Le importazioni nel file richiesto per App Engine e Cloud Storage sono:
google.golang.org/appengine
,google.golang.org/appengine/file
cloud.google.com/go/storage
come mostrato nel seguente snippet:
Specifica del bucket Cloud Storage
Prima di poter eseguire qualsiasi operazione di Cloud Storage, devi fornire il nome del bucket. Il modo più semplice per farlo è utilizzare per il tuo progetto il bucket predefinito, che si può ottenere dal contesto App Engine, come mostrato in questo snippet:
Scrittura in Cloud Storage
Per scrivere un file in Cloud Storage:
Quando il file viene creato, nell'esempio sono specificate le intestazioni Cloud Storage (x-goog-meta-foo
e x-goog-meta-bar
). Questo codice facoltativo introduce la nozione di utilizzo delle intestazioni Cloud Storage, che puoi applicare:
- Interessa il comportamento della richiesta
- Specifica un accesso al file nel bucket diverso dai valori predefiniti (vedi x-goog-acl)
- Scrivi i metadati dei file.
Le intestazioni x-goog-meta-*
mostrate sopra sono metadati di file personalizzati che puoi impostare; queste intestazioni vengono sempre restituite con il file. Tieni presente che lo spazio disponibile per le intestazioni personalizzate e i relativi dati è limitato a pochi kilobyte, perciò usali con attenzione.
Poiché nell'esempio di codice non viene impostato x-goog-acl
, all'oggetto viene applicato l'ACL predefinito di Cloud Storage public read quando viene scritto nel bucket.
Infine, nota la chiamata a Close()
del file al termine della scrittura. Se non esegui questa operazione, il file non verrà scritto in Cloud Storage. Tieni presente che dopo aver chiamato Close()
, non puoi aggiungere elementi al file.
Lettura da Cloud Storage
Per leggere un file da Cloud Storage:Elenco dei contenuti del bucket
Questo codice campione mostra come elencare i contenuti del bucket:
Eliminazione di file in Cloud Storage
Il codice seguente mostra come eliminare un file da Cloud Storage utilizzando il metodo ObjectHandle.delete()
.
Questo esempio esegue la pulizia dei file scritti nel bucket nella sezione Scrittura in Cloud Storage.
Passaggi successivi
- Consulta la documentazione di riferimento API.
- Per ulteriori guide e tutorial, consulta la documentazione di Cloud Storage.