A newer version of this documentation is available.

View Latest

scopes-details

  • reference
    +
    Provides low-level details on scopes.

    Syntax

    cbstats host:11210 [common options] scopes-details [vbucket-reference]

    Description

    This command is used to provide low-level details on scopes, for a specified bucket. This includes details identifying the existing scopes; and vBucket-specific details, which include sequence numbers and item counts.

    Options

    The optional vbucket-reference parameter is an integer, in the range of 0 to 1023 inclusive, specifying a particular vBucket. If a vBucket is specified, the only details returned are the vBucket-specific details for that vBucket. If no vBucket is specified, vBucket-specific details for all vBuckets are returned, as well as details identifying the existing scopes for the bucket.

    For information on returning a vbucket-reference that corresponds to a particular document id, see the section Examples: Find vBucket IDs, on the reference page for the cbstats command key. For common cbstats options, see cbstats.

    Examples

    The following command retrieves scopes-details on all vBuckets for travel-sample, for the specified node:

    /opt/couchbase/bin/cbstats localhost:11210 \
    -u Administrator -p password \
    -b travel-sample scopes-details

    The initial section of the output is as follows:

    0x0:0x0:name:          _default
    0x0:collections:       1
    0x0:name:              _default
    0x8:0x9:name:          MyCollection
    0x8:collections:       1
    0x8:name:              MyScope
    0x9:0xa:name:          MySecondCollection
    0x9:0xb:name:          MyThirdCollection
    0x9:collections:       2
    0x9:name:              MySecondScope
    manifest_uid:          7
    vb_0:0x0:              2
    vb_0:0x0:0x0:items:    38
    vb_0:0x8:              1
    vb_0:0x8:0x9:items:    0
    vb_0:0x9:              0
    vb_0:0x9:0xa:items:    0
    vb_0:0x9:0xb:items:    0
    vb_0:manifest_uid:     7
    vb_0:scopes:           3
    vb_1:0x0:              2
    vb_1:0x0:0x0:items:    29
          .
          .
          .

    Each line of the output presents a data key. Each key is either of the format scopeID : collectionID : datumLabel; or of the format scopeID : datumLabel. Each scopeID or collectionID is a hexadecimal number, prefixed by 0x. Each datumLabel is a string. Each data key is concluded with a colon, and the associated value is presented to the right of the colon.

    The output’s initial lines describe the scopes and collections in the bucket on the specified node.

    The manifest_uid value (here, 7) is associated with the current state of collections on the node; and will be incremented whenever a collections-related change is made.

    Subsequent information in the output relates to each vBucket corresponding to travel-sample. The vBuckets are numbered, from 0 to 1023. For each vBucket, information is provided on sequence numbers and total items.

    The following command specifies a vbucket-reference, thereby returning information on the specified vBucket only:

    /opt/couchbase/bin/cbstats localhost:11210 \
    -u Administrator -p password \
    -b travel-sample scopes-details 8

    Details for vBucket 8 are duly returned:

    vb_8:0x0:           2
    vb_8:0x0:0x0:items: 26
    vb_8:0x8:           1
    vb_8:0x8:0x9:items: 0
    vb_8:0x9:           0
    vb_8:0x9:0xa:items: 0
    vb_8:0x9:0xb:items: 0
    vb_8:manifest_uid:  7
    vb_8:scopes:        3

    See Also

    For an overview of scopes and collections, see Scopes and Collections.

    For a step-by-step explanation of creating scopes and collections with the CLI, see Manage Scopes and Collections with the CLI. For a comparable explanation with the REST API, see Manage Scopes and Collections with the REST API.

    To use cbstats to provide higher-level information on scopes, see the reference page for the cbstats scopes command.