Buckets, Memory, and Storage

      Couchbase Server saves data within Buckets.

      Creating, Maintaining, and Accessing Data

      Couchbase Server keeps data within Buckets. Before you add any data, you must create a bucket within which to store it. Buckets can be created by means of the Couchbase Web Console, the REST API, or the CLI. Each bucket is assigned a name at its creation: this name is referenced by the application or user wishing to save or access items within it.

      The types of bucket most frequently used are Couchbase and Ephemeral buckets. Couchbase buckets exist both in memory and on disk. Ephemeral buckets exist only in memory. Buckets can be configured to maintain data in compressed format, so as to maximize resource-effectiveness. Documents within a bucket can be assigned a Time To Live, to ensure that they expire after a specified time-period, and that their data is thus made permanently inaccessible.

      Couchbase Server manages memory to ensure high performance and scalability: memory quotas are established, and data not recently used can be ejected, to make room for data more frequently requested. Multi-threaded readers and writers provide simultaneous read and write operations for data on disk, ensuring high throughput.

      The pages in this section provide detailed descriptions of buckets, memory, and storage.