Session settings

Table of contents

Session settings only apply to the currently connected client session.


To configure a modifiable session setting, use SET, for example:

SET search_path TO myschema, doc;

To retrieve the current value of a session setting, use SHOW eg:

SHOW search_path;

Besides using SHOW, it is also possible to use the current_setting scalar function.

Supported session settings

Default: pg_catalog, doc
Modifiable: yes

The list of schemas to be searched when a relation is referenced without a schema.

CrateDB will try to resolve an unqualified relation name against the configured search_path by iterating over the configured schemas in the order they were declared. The first matching relation in the search_path is used. CrateDB will report an error if there is no match.


This setting mirrors the PostgreSQL search_path setting.

Some PostgreSQL clients require access to various tables in the pg_catalog schema. Usually, this is to extract information about built-in data types or functions.

CrateDB implements the system pg_catalog schema and it automatically includes it in the search_path before the configured schemas, unless it is already explicitly in the schema configuration.

Default: true
Modifiable: yes

An experimental setting which enables CrateDB to consider whether a Join operation should be evaluated using the HashJoin implementation instead of the Nested-Loops implementation.


It is not always possible or efficient to use the HashJoin implementation. Having this setting enabled, will only add the option of considering it, it will not guaranty it. See also the available join algorithms for more insights on this topic.

Default: 32
Modifiable: no

Shows the maximum number of index keys.


The session setting has not effect on CrateDB and was added to enhance compatibility with PostgreSQL.


Experimental session settings might be removed in the future even in minor feature releases.