cbft-bleve

The cbft-bleve tool returns information on a Full Text Index partition or on a Zap file.

Syntax

cbft-bleve [command] [--help]

The command specified as the principal argument to cbft-bleve can be any one of the following.

Command Description

check

Checks the contents of a specified Moss-index partition.

count

Counts the number of documents referenced by a specified Moss-index partition.

dictionary

Prints to standard output the term dictionary for a specified field in a specified Moss-index partition.

dump

Dumps the contents of a specified Moss-index partition.

fields

Lists the fields in a specified Moss-index partition.

mapping

Prints to standard output the mapping used for a specified Moss-index partition.

query

Executes a specified query against a specified Moss-index partition.

registry

Prints to standard output the analyzers, tokenizers and other components used by a specified Moss-index partition.

scorch

Establishes that the index partition on which information is to be returned is a Scorch-index partition.

zap

Estabishes that the path is that of a Zap file, on which information is to be returned.

When a value for command is not specified, --help prints help text to standard output, describing the acceptable values of command. When a value for command is specified, --help prints help text describing additional syntax entailed by the specified value (see Per Command Syntax, below).

Specifying Index Partitions

The Search Service divides each Full Text Index into partitions. The default number of partitions per index is six. For information, see Index Partitions.

Many of the commands that can be used with cbft-bleve take as their principal argument the filesystem path of an index partition. Index partitions are themselves directories. The name of each (whether it is a Moss or a Scorch index) is formed from the user-defined index-name, the uuid of the user-defined index, and the partition id: these are connected with underscores, and given the .pindex suffix. For example, myIndex_690ef363c7557832_13aa53f3.pindex.

Index partitions can be found in the following locations, on each node running the Search Service:

OS Location

Linux

/opt/couchbase/var/lib/couchbase/data/@fts/

Windows

C:\Program Files\couchbase\server\var\lib\couchbase\data\@fts\

MacOS

/Library/Application Support/Couchbase/var/lib/couchbase/data/@fts/

To specify a Moss index partition, the pathname of the .pindex directory (located in one of the @fts directories listed above) should be given. To specify a Scorch index partition, the pathname of the store subdirectory (located in the .pindex directory) should be given.

Some commands provide information on the Zap file provided with each Scorch-index partition. To specify a Zap file, the pathname of the .zap file itself (located in the store subdirectory, under the .pindex directory) should be given.

Note that on Linux and MacOS, supervisor permission may be required, to view and access index partitions: therefore, the sudo command should be used as appropriate.

Per-Command Syntax

Each of the top-level commands that can be specified as a value to cbft-bleve entails its own syntax. The scorch and zap values refer to a specified Scorch index and to its associated Zap file, respectively. All other top-level commands refer to a specified Moss index.

Syntax and command-line examples for cbft-bleve when applied to: