Bucket Storage
Bucket storage provides scalable object storage for files and binary data in Raindrop applications. Instead of storing files in databases or managing complex file systems, bucket storage offers a simple key-value approach for any type of content.
What Bucket Storage Provides
Object-Based Storage Every piece of data gets a unique key and can be retrieved instantly without navigating directory structures.
Scalable Performance Handles everything from small configuration files to large media files with automatic distribution and redundancy.
Flexible Data Types Store any content type - images, videos, documents, JSON files, or binary data without schema restrictions.
HTTP Integration Built-in support for web-friendly features like content types, caching headers, and range requests for streaming.
When to Use Bucket Storage
Good Fit
- User Uploads: Profile photos, documents, media files
- Application Assets: Static files, generated reports, cached data
- Content Delivery: Images, videos, downloadable files that need global access
- Binary Data: Any data that doesn’t fit well in structured databases
Consider Alternatives
- Structured Data: User profiles, transactions, and relational data belong in SQL databases
- High-Frequency Updates: Frequently modified shared data works better in databases or KV storage
- Complex Queries: If you need to search across file contents, consider SmartBuckets instead
Integration Patterns
Service Layer Access Services handle file uploads, downloads, and content management with business logic validation.
CDN and Caching Built-in HTTP features enable global content delivery with appropriate caching strategies.
Key Design
Organize objects with descriptive keys like users/123/profile.jpg
or reports/2024/quarterly.pdf
for logical organization.
Bucket storage excels at handling discrete files and media while keeping your databases focused on structured data.