JDBC Driver for Couchbase

Build 22.0.8462

FlexibleSchemas

Whether the provider allows queries to use columns that it has not discovered.

Data Type

bool

Default Value

false

Remarks

By default driver will only allow queries to use columns that it has found during the metadata discovery process (see TypeDetectionScheme for details). This means that the driver has the full information for each column it presents, but it also means that fields set on only a few documents may not be exposed. Disabling this option means that the driver will allow you to write a query with any columns you want. If you use columns in a query that have not been discovered the driver will assume that they are simple strings.

For example, the driver uses column type information to automatically convert dates for comparision since Couchbase cannot natively compare dates directly. If the driver detects that datecol is a date field, it can apply the STR_TO_MILLIS conversion automatically:

/* SQL */
WHERE datecol < '2020-06-12';

/* N1QL */
WHERE STR_TO_MILLIS(datecol) < STR_TO_MILLIS('2020-06-12');

When using undiscovered columns the driver cannot make this type of conversion for you. You must apply any needed conversions manually to ensure that operations behave the way you want them to.

Copyright (c) 2023 CData Software, Inc. - All rights reserved.
Build 22.0.8462