LBRYCommunity/lbry-rocksdb
1
0
Fork 0
Code Issues 6 Pull requests 2 Packages Projects Releases Wiki Activity

docs

Browse source
This commit is contained in:
Jack Robison 2022-01-17 19:55:20 -05:00
parent cd327c06d9
commit 868edf864d
No known key found for this signature in database
GPG key ID: DF25C68FE0239BB2
3 changed files with 60 additions and 44 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
.github/workflows/build.yml vendored
View file

@ -6,7 +6,6 @@ on:
push: push:
branches: branches:
- master - master
- iterator-api
jobs: jobs:
manylinux: manylinux:
runs-on: ubuntu-latest runs-on: ubuntu-latest

0
docs/.nojekyll Normal file
View file

103
docs/api/database.rst
View file

@ -174,53 +174,70 @@ Database object
:rtype: :py:class:`rocksdb.BaseIterator` :rtype: :py:class:`rocksdb.BaseIterator`
.. py:method:: iterator(start=None, column_family=None, iterate_lower_bound=None, .. py:method:: iterator(start=None, column_family=None, iterate_lower_bound=None, iterate_upper_bound=None, reverse=False, include_key=True, include_value=True, fill_cache=True, prefix_same_as_start=False, auto_prefix_mode=False)
iterate_upper_bound=None, reverse=False, include_key=True,
include_value=True, fill_cache=True, prefix_same_as_start=False, :param start: prefix to seek to
auto_prefix_mode=False) :type start: bytes
:param `rocksdb.ColumnFamilyHandle` column_family: column family handle
:param bytes start: prefix to seek to :param column_family: column family handle
:param bytes iterate_lower_bound: :type column_family: :py:class:`rocksdb.ColumnFamilyHandle`
defines the smallest key at which the backward iterator can return an entry.
Once the bound is passed, Valid() will be false. `iterate_lower_bound` is :param iterate_lower_bound:
inclusive ie the bound value is a valid entry. defines the smallest key at which the backward iterator can return an entry.
If prefix_extractor is not null, the Seek target and `iterate_lower_bound` Once the bound is passed, Valid() will be false. `iterate_lower_bound` is
need to have the same prefix. This is because ordering is not guaranteed inclusive ie the bound value is a valid entry.
outside of prefix domain. If prefix_extractor is not null, the Seek target and `iterate_lower_bound`
:param bytes iterate_upper_bound: need to have the same prefix. This is because ordering is not guaranteed
defines the extent up to which the forward iterator outside of prefix domain.
can returns entries. Once the bound is reached, Valid() will be false. :type iterate_lower_bound: bytes
"iterate_upper_bound" is exclusive ie the bound value is
not a valid entry. If prefix_extractor is not null: :param iterate_upper_bound:
1. If auto_prefix_mode = true, iterate_upper_bound will be used defines the extent up to which the forward iterator
to infer whether prefix iterating (e.g. applying prefix bloom filter) can returns entries. Once the bound is reached, Valid() will be false.
can be used within RocksDB. This is done by comparing "iterate_upper_bound" is exclusive ie the bound value is
iterate_upper_bound with the seek key. not a valid entry. If prefix_extractor is not null:
2. If auto_prefix_mode = false, iterate_upper_bound only takes 1. If auto_prefix_mode = true, iterate_upper_bound will be used
effect if it shares the same prefix as the seek key. If to infer whether prefix iterating (e.g. applying prefix bloom filter)
iterate_upper_bound is outside the prefix of the seek key, then keys can be used within RocksDB. This is done by comparing
returned outside the prefix range will be undefined, just as if iterate_upper_bound with the seek key.
iterate_upper_bound = null. 2. If auto_prefix_mode = false, iterate_upper_bound only takes
If iterate_upper_bound is not null, SeekToLast() will position the iterator effect if it shares the same prefix as the seek key. If
at the first key smaller than iterate_upper_bound. iterate_upper_bound is outside the prefix of the seek key, then keys
:param bool reverse: run the iteration in reverse - using `reversed` is also supported returned outside the prefix range will be undefined, just as if
:param bool include_key: the iterator should include the key in each iteration iterate_upper_bound = null.
:param bool include_value: the iterator should include the value in each iteration If iterate_upper_bound is not null, SeekToLast() will position the iterator
:param bool fill_cache: Should the "data block"/"index block" read for this iteration be placed in at the first key smaller than iterate_upper_bound.
block cache? Callers may wish to set this field to false for bulk scans. :type iterate_upper_bound: bytes
This would help not to the change eviction order of existing items in the
block cache. Default: true :param reverse: run the iteration in reverse - using `reversed` is also supported
:param bool prefix_same_as_start: :type reverse: bool
Enforce that the iterator only iterates over the same prefix as the seek.
This option is effective only for prefix seeks, i.e. prefix_extractor is :param include_key: the iterator should include the key in each iteration
non-null for the column family and total_order_seek is false. Unlike :type include_key: bool
iterate_upper_bound, prefix_same_as_start only works within a prefix
but in both directions. Default: false :param include_value: the iterator should include the value in each iteration
:param bool auto_prefix_mode: When true, by default use total_order_seek = true, and RocksDB can :type include_value: bool
:param fill_cache: Should the "data block"/"index block" read for this iteration be placed in
block cache? Callers may wish to set this field to false for bulk scans.
This would help not to the change eviction order of existing items in the
block cache. Default: true
:type fill_cache: bool
:param bool prefix_same_as_start:
Enforce that the iterator only iterates over the same prefix as the seek.
This option is effective only for prefix seeks, i.e. prefix_extractor is
non-null for the column family and total_order_seek is false. Unlike
iterate_upper_bound, prefix_same_as_start only works within a prefix
but in both directions. Default: false
:type prefix_same_as_start: bool
:param bool auto_prefix_mode: When true, by default use total_order_seek = true, and RocksDB can
selectively enable prefix seek mode if won't generate a different result selectively enable prefix seek mode if won't generate a different result
from total_order_seek, based on seek key, and iterator upper bound. from total_order_seek, based on seek key, and iterator upper bound.
Not supported in ROCKSDB_LITE mode, in the way that even with value true Not supported in ROCKSDB_LITE mode, in the way that even with value true
prefix mode is not used. Default: false prefix mode is not used. Default: false
:type auto_prefix_mode: bool
:returns: :returns:
A iterator object which is valid and ready to begin using. It will be either a key, item or value A iterator object which is valid and ready to begin using. It will be either a key, item or value