En este documento, se describe cómo almacenar y recuperar datos mediante Cloud Storage en una app de App Engine que usa la biblioteca cliente de App Engine para Cloud Storage. Se supone que realizaste las tareas descritas en Configura Cloud Storage para activar un bucket de Cloud Storage y descargar las bibliotecas cliente. También se supone que sabes compilar una aplicación de App Engine, como se describe en la Guía de inicio rápido del entorno estándar de App Engine para Python 2.
Importaciones requeridas
El archivo main.py
contiene las importaciones típicas que se usan para acceder a Cloud Storage a través de la biblioteca cliente:
Necesitas el módulo os
y la API de app_identity
para obtener el nombre del bucket predeterminado en el entorno de ejecución. Ten en cuenta que si no usas el bucket predeterminado, necesitarás otra manera de proporcionar el nombre del bucket.
Cómo especificar el bucket de Cloud Storage
Antes de realizar cualquier operación en Cloud Storage, debes proporcionar el nombre del bucket. La forma más fácil de hacer esto es con el bucket predeterminado para tu proyecto, que puedes obtenerlo de la siguiente manera:La llamada a get_default_gcs_bucket_name
se realiza de forma correcta solo si creaste el bucket predeterminado para tu proyecto.
Escribe en Cloud Storage
En el siguiente ejemplo, se muestra como escribir en el bucket:
Ten en cuenta que en la llamada para abrir el archivo en el que deseas escribir, el ejemplo especifica determinados encabezados de Cloud Storage que escriben metadatos personalizados del archivo. Estos metadatos se pueden recuperar mediante cloudstorage.stat()
. Puedes encontrar la lista de encabezados compatibles en la referencia de cloudstorage.open()
.
También, ten en cuenta que no se configuró el encabezado x-goog-acl
. Esto significa que la LCA de Cloud Storage predeterminada de lectura pública se aplicará al objeto cuando se escriba en el bucket.
Por último, presta atención a la llamada para cerrar el archivo después de terminar la escritura. Si no lo haces, el archivo no se escribirá en Cloud Storage. Ten en cuenta que después de llamar a la función close()
del archivo de Python, no puedes adjuntar el archivo. Si necesitas modificar un archivo, tienes que llamar a la función open()
del archivo de Python para volver a abrirlo en el modo de escritura, lo cual reemplazará el archivo, no lo adjunta.
Lee en Cloud Storage
En el siguiente ejemplo, se muestra cómo leer un archivo del bucket:
Para leer las líneas seleccionadas del archivo, usa seek()
:
En ambos ejemplos, el argumento filename
que pasas a cloudstorage.open()
es la ruta de acceso al archivo en formato YOUR_BUCKET_NAME/PATH_IN_GCS
. Ten en cuenta que la configuración predeterminada para cloudstorage.open()
es el modo de solo lectura. No es necesario especificar un modo cuando se abre un archivo para leerlo.
Enumera el contenido del bucket
En el código de muestra, se indica cómo desplazarse por un bucket con una gran cantidad de archivos. A fin de desplazarse por una lista de contenidos del bucket, usa los parámetros marker
y max_keys
:
Ten en cuenta que el nombre completo del archivo se muestra como una string sin delimitadores de directorio. Si deseas mostrar el archivo con su jerarquía de directorios más reconocible, establece el parámetro delimiter
en el delimitador del directorio que deseas usar.
Borra archivos en Cloud Storage
En el siguiente código, se muestra cómo borrar un archivo de Cloud Storage mediante el método cloudstorage.delete()
(importado como gcs
).
Este ejemplo limpia los archivos que se escribieron en el depósito en la sección Cómo escribir en Cloud Storage.
¿Qué sigue?
- Visita la documentación de referencia de la API.
- Consulta la documentación de Cloud Storage para obtener más instructivos y guías.