Couchbase Playground

Python - Sub-document Mutate

The Sub-document API allows for retrieving or mutating a portion of a larger document, without having to first retrieve the entire document, which can provide for higher performance.

Visit the docs to learn more about Sub-document Operations in Python.

To run this example, click the button in the top right corner of the code editor.

Code Editor

#!/usr/bin/python3

import sys
import couchbase.collection
import couchbase.subdocument as SD

from couchbase.durability import Durability
from couchbase.cluster import Cluster, ClusterOptions
from couchbase.auth import PasswordAuthenticator

pa = PasswordAuthenticator('username', 'password')
cluster = Cluster('couchbase://127.0.0.1', ClusterOptions(pa))
bucket = cluster.bucket('travel-sample')
collection = bucket.default_collection()

try:
  result = collection.lookup_in('airline_10', [SD.get('country')])
  country = result.content_as[str](0) # "United Kingdom"
  print("Sub-doc before:")
  print("country:", country)

except:
  print("exception:", sys.exc_info()[0])

try:
  collection.mutate_in("airline_10", [SD.upsert("country", "Canada")])

except:
  print("exception:", sys.exc_info()[0])

try:
  result = collection.lookup_in('airline_10', [SD.get('country')])
  country = result.content_as[str](0) # "United Kingdom"
  print("Sub-doc after:")
  print("country:", country)

except:
  print("exception:", sys.exc_info()[0])

Python - Sub-document Mutate

Code Editor

Output