Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-1010

Missing details about how a bucket is similar to a keyspace

    XMLWordPrintable

Details

    Description

      This page for the first time introduces the concept of keyspaces and states that it's similar to buckets. But it doesn't have details about when exactly a keyspace gets created or how exactly it relates to a bucket.

      For example, I just ran the following command on a new installation of couchbase:

      SELECT * FROM system:keyspaces;
      

      and could see the following results:

      {
          "requestID": "a1a25f6f-3a0e-4e75-8fd0-235ca2429940",
          "signature": {
              "*": "*"
          },
          "results": [
              {
                  "keyspaces": {
                      "datastore_id": "http://127.0.0.1:8091",
                      "id": "default",
                      "name": "default",
                      "namespace_id": "default"
                  }
              },
              {
                  "keyspaces": {
                      "datastore_id": "http://127.0.0.1:8091",
                      "id": "gamesim-sample",
                      "name": "gamesim-sample",
                      "namespace_id": "default"
                  }
              },
              {
                  "keyspaces": {
                      "datastore_id": "http://127.0.0.1:8091",
                      "id": "travel-sample",
                      "name": "travel-sample",
                      "namespace_id": "default"
                  }
              },
              {
                  "keyspaces": {
                      "datastore_id": "http://127.0.0.1:8091",
                      "id": "beer-sample",
                      "name": "beer-sample",
                      "namespace_id": "default"
                  }
              }
          ],
          "status": "success",
          "metrics": {
              "elapsedTime": "171.921577ms",
              "executionTime": "171.842105ms",
              "resultCount": 4,
              "resultSize": 910
          }
      }
      

      Based on that I can only guess that a keyspace is infact a bucket which I think is incorrect (don't see a reason why it would be called a keyspace if it was indeed a bucket).

      In short, the page doesn't explain why a separate `keyspace` term is necessary in N1QL and how it differs from a bucket.

      Reporter: Jaikiran
      E-mail: jai.forums2013@gmail.com

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            guy.klages Guy Klages (Inactive)
            docsite-collector Docs Site Collector
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty