# Couchbase ## 1. Couchbase Couchbase is a high-performance NoSQL document database built for scale, low latency, and rapid development. It stores data as flexible JSON documents, making it easy to evolve data models as requirements change. Unlike many NoSQL systems, Couchbase combines key-value storage, indexing, querying, caching, and persistence in one platform. Its memory-first architecture and shared-nothing clustering let you scale horizontally without sacrificing performance. Couchbase can be used in high-volume, real-time environments like e-commerce, social platforms, and financial systems. In Couchbase, a **bucket** is the top-level container that holds data and defines memory, replication, and persistence settings. Within a bucket, a **scope** acts as a namespace to group related collections, providing logical organization and isolation. A **collection** sits inside a scope and stores JSON documents of a similar type, similar to a table in relational databases. In the context of an online clothing store, the data could be organized with a main **bucket** containing two **scopes**: inventory and customer. The inventory **scope** would hold **collections** like products warehouses, and suppliers, while the customer **scope** would include users, orders, and reviews. This structure keeps related data grouped and easy to manage. In the below snapshot of the Couchbase UI, you can see what a collection that sits in the **default** scope of the **main** bucket looks like, with a preview of the JSON data being stored on the right.
## 2. Couchbase in Bluetext In Bluetext, Couchbase is integrated into a project through a three-phase tool discovery system. First, **add-couchbase** starts the Couchbase server and Couchbase UI, aswell as the config manager, which sets up the initial database structure, then stops running. This is followed by the **add-couchbase-client** tool, which adds the Couchbase library to the project, and adds **add-couchbase-collection** as a discoverable tool. The **add-couchbase-collection** tool creates the actual collection in Couchbase. By default with Bluetext, collections are created in the main bucket, under the default scope. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.bluetext.dev/core-supported-technologies/couchbase.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.