couchbase

Type:

Use a Couchbase instance as a cache.

Introduced in version 4.12.0.

  • Common

  • Advanced

# Common config fields, showing default values
label: ""
couchbase:
  url: couchbase://localhost:11210 # No default (required)
  username: "" # No default (optional)
  password: "" # No default (optional)
  bucket: "" # No default (required)
# All config fields, showing default values
label: ""
couchbase:
  url: couchbase://localhost:11210 # No default (required)
  username: "" # No default (optional)
  password: "" # No default (optional)
  bucket: "" # No default (required)
  collection: _default
  transcoder: legacy
  timeout: 15s
  default_ttl: "" # No default (optional)

Fields

url

Couchbase connection string.

Type: string

# Examples

url: couchbase://localhost:11210

username

Username to connect to the cluster.

Type: string

password

Password to connect to the cluster.

This field contains sensitive information that usually shouldn’t be added to a config directly, read our secrets page for more info.

Type: string

bucket

Couchbase bucket.

Type: string

collection

Bucket collection.

Type: string

Default: "_default"

transcoder

Couchbase transcoder to use.

Type: string

Default: "legacy"

Option Summary

json

JSONTranscoder implements the default transcoding behavior and applies JSON transcoding to all values. This will apply the following behavior to the value: binary ([]byte) → error. default → JSON value, JSON Flags.

legacy

LegacyTranscoder implements the behavior for a backward-compatible transcoder. This transcoder implements behavior matching that of gocb v1.This will apply the following behavior to the value: binary ([]byte) → binary bytes, Binary expectedFlags. string → string bytes, String expectedFlags. default → JSON value, JSON expectedFlags.

raw

RawBinaryTranscoder implements passthrough behavior of raw binary data. This transcoder does not apply any serialization. This will apply the following behavior to the value: binary ([]byte) → binary bytes, binary expectedFlags. default → error.

rawjson

RawJSONTranscoder implements passthrough behavior of JSON data. This transcoder does not apply any serialization. It will forward data across the network without incurring unnecessary parsing costs. This will apply the following behavior to the value: binary ([]byte) → JSON bytes, JSON expectedFlags. string → JSON bytes, JSON expectedFlags. default → error.

rawstring

RawStringTranscoder implements passthrough behavior of raw string data. This transcoder does not apply any serialization. This will apply the following behavior to the value: string → string bytes, string expectedFlags. default → error.

timeout

Operation timeout.

Type: string

Default: "15s"

default_ttl

An optional default TTL to set for items, calculated from the moment the item is cached.

Type: string