本文整理汇总了Python中couchbase._libcouchbase.Connection.set方法的典型用法代码示例。如果您正苦于以下问题:Python Connection.set方法的具体用法?Python Connection.set怎么用?Python Connection.set使用的例子?那么恭喜您, 这里精选的方法代码示例或许可以为您提供帮助。您也可以进一步了解该方法所在类couchbase._libcouchbase.Connection
的用法示例。
在下文中一共展示了Connection.set方法的1个代码示例,这些例子默认根据受欢迎程度排序。您可以为喜欢或者感觉有用的代码点赞,您的评价将有助于系统推荐出更棒的Python代码示例。
示例1: set
# 需要导入模块: from couchbase._libcouchbase import Connection [as 别名]
# 或者: from couchbase._libcouchbase.Connection import set [as 别名]
def set(self, key, value, cas=0, ttl=0, format=None):
"""Unconditionally store the object in Couchbase.
:param key: The key to set the value with. By default, the key must be
either a :class:`bytes` or :class:`str` object encodable as UTF-8.
If a custom `transcoder` class is used (see :meth:`__init__`), then
the key object is passed directly to the transcoder, which may
serialize it how it wishes.
:type key: string or bytes
:param value: The value to set for the key. The type for `value`
follows the same rules as for `key`
:param int cas: The _CAS_ value to use. If supplied, the value will only
be stored if it already exists with the supplied CAS
:param int ttl: If specified, the key will expire after this many
seconds
:param int format: If specified, indicates the `format` to use when
encoding the value. If none is specified, it will use the
`default_format`
For more info see
:attr:`~couchbase.libcouchbase.Connection.default_format`
:raise: :exc:`couchbase.exceptions.ArgumentError` if an
argument is supplied that is not applicable in this context.
For example setting the CAS as a string.
:raise: :exc:`couchbase.exceptions.ConnectError` if the
connection closed
:raise: :exc:`couchbase.exceptions.KeyExistsError` if the key
already exists on the server with a different CAS value.
:raise: :exc:`couchbase.exceptions.ValueFormatError` if the
value cannot be serialized with chosen encoder, e.g. if you
try to store a dictionaty in plain mode.
:return: :class:`~couchbase.libcouchbase.Result`
Simple set::
cb.set('key', 'value')
Force JSON document format for value::
cb.set('foo', {'bar': 'baz'}, format=couchbase.FMT_JSON)
Perform optimistic locking by specifying last known CAS version::
cb.set('foo', 'bar', cas=8835713818674332672)
Several sets at the same time (mutli-set)::
cb.set_multi({'foo': 'bar', 'baz': 'value'})
.. seealso::
:meth:`set_multi`
"""
return _Base.set(self, key, value, cas, ttl, format)