Blob Storage: almacenamiento persistente vs temporal
Blob Storage: almacenamiento persistente vs temporal
El Blob Storage de Square Cloud fue diseñado para ofrecer flexibilidad en el almacenamiento de archivos, desde logs temporales hasta assets críticos de tu aplicación. La principal diferencia entre los modos de almacenamiento reside en el parámetro de expiración y en la forma en que el sistema maneja el nombre de los archivos.
1. Almacenamiento temporal (Expire)
El almacenamiento temporal es ideal para archivos que tienen un ciclo de vida corto, como informes generados bajo demanda, backups de transición o archivos de caché que no necesitan ocupar espacio para siempre.
Cómo funciona:
Al realizar el upload, defines el parámetro expire en la URL. Ese valor va desde 1 hora hasta 1825 días (5 años) (30/30d o 6h). Los plazos menores de 7 días son solo para Enterprise.
- Nombre con expiración: Un archivo con expiración lleva en su nombre la fecha de expiración (
~e…), no un hash. - Hash opcional: El hash aleatorio solo se agrega con
security_hash=true, en cualquier modo (ej.:foto_a1b2c3.png).
2. Almacenamiento persistente (Permanente)
El modo persistente es la elección correcta para archivos que componen la estructura de tu aplicación, como fotos de perfil de usuarios, logos, CSS o documentos que deben estar disponibles por tiempo indeterminado.
Cómo funciona:
Sin expire, se aplica la regla del prefijo (si existe). Sin regla, el archivo es permanente. Para no sustituir un archivo existente, usa overwrite=false.
- Sustitución (Overwrite): Sin
security_hash, no se añade hash. Si subes un nuevo archivo con el exacto mismo nombre de un objeto que ya existe en tu Storage, el archivo antiguo será sustituido por la versión más reciente. - Ventaja: Facilita la actualización de assets estáticos sin necesidad de cambiar la URL en tu código fuente.
3. Comparativa rápida
Característica | Almacenamiento temporal | Almacenamiento persistente |
|---|---|---|
Parámetro en la URL | Requiere | Ausencia de |
Nombre del archivo | Incluye la fecha de expiración ( | Sin sufijo de expiración |
Hash de seguridad | Solo con | Solo con |
Conflicto de nombre | Sustituye el archivo (salvo | Sustituye el archivo (salvo |
4. ¿Cuál elegir?
- Usa Temporal para: Comprobantes de transacción, logs de depuración, archivos exportados por usuarios para descarga única.
- Usa Persistente para: Imágenes de interfaz, uploads de usuarios (como avatares) y archivos de configuración. Para datos, usa una base de datos administrada (SQLite no funciona sobre el Blob).
Consejo Pro: Al usar el almacenamiento persistente para sustituir archivos, recuerda que los navegadores y las CDN pueden mantener el archivo antiguo en caché durante algún tiempo.
Actualizado el: 04/10/2026
¡Gracias!