Schema for information about the index used for a find query.

interface ExplainResult {
    covering: boolean;
    dbname: string;
    fields: string[];
    index: IndexInformation;
    limit: number;
    mrargs?: ExplainResultMrArgs;
    opts: ExplainResultOpts;
    partitioned?: any;
    selector: JsonObject;
    skip: number;
}

Properties

covering: boolean

When true, the query is answered using the index only and no documents are fetched.

dbname: string

Name of database.

fields: string[]

Fields that were requested to be projected from the document. If no fields were requested to be projected this will be empty and all fields will be returned.

Schema for information about an index.

limit: number

The used maximum number of results returned.

Arguments passed to the underlying view.

Options used for the request.

partitioned?: any

Schema for any JSON type.

selector: JsonObject

JSON object describing criteria used to select documents. The selector specifies fields in the document, and provides an expression to evaluate with the field content or other data.

The selector object must:

  • Be structured as valid JSON.
  • Contain a valid query expression.

Using a selector is significantly more efficient than using a JavaScript filter function, and is the recommended option if filtering on document attributes only.

Elementary selector syntax requires you to specify one or more fields, and the corresponding values required for those fields. You can create more complex selector expressions by combining operators.

Operators are identified by the use of a dollar sign $ prefix in the name field.

There are two core types of operators in the selector syntax:

  • Combination operators: applied at the topmost level of selection. They are used to combine selectors. A combination operator takes a single argument. The argument is either another selector, or an array of selectors.
  • Condition operators: are specific to a field, and are used to evaluate the value stored in that field. For instance, the basic $eq operator matches when the specified field contains a value that is equal to the supplied argument. See the Cloudant Docs for a list of all available combination and conditional operators.
  • Only equality operators such as $eq, $gt, $gte, $lt, and $lte (but not $ne) can be used as the basis of a query. You should include at least one of these in a selector.

For further reference see selector syntax.

skip: number

Skip parameter used.

Generated using TypeDoc