Skip to content

Commit 0587c99

Browse files
committed
gh-1413 bloom_fpr => vinyl_bloom_fpr, page_size => vinyl_page_size
1 parent cf68c07 commit 0587c99

File tree

6 files changed

+24
-23
lines changed

6 files changed

+24
-23
lines changed

doc/book/box/engines/vinyl.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -567,7 +567,7 @@ simultaneously occurring in all of the bit arrays is infinitesimal.
567567

568568
The key advantage of Bloom filters in Tarantool is that they’re easily
569569
configurable. The only parameter that can be specified separately for each index
570-
is called ``bloom_fpr`` (FPR stands for "false positive ratio") and it has the
570+
is called ``vinyl_bloom_fpr`` (FPR stands for "false positive ratio") and it has the
571571
default value of 0.05, which translates to a 5% FPR. Based on this parameter,
572572
Tarantool automatically creates Bloom filters of the optimal size for partial-
573573
key and full-key searches. The Bloom filters are stored in the `.index` file,

doc/reference/reference_lua/box_stat.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -177,8 +177,8 @@ We can expect that "L0 = 0" immediately after a dump.
177177
``box.stat.vinyl().memory.page_index`` and ``box.stat.vinyl().memory.bloom_filter``
178178
have the current amount being used for index-related structures.
179179
The size is a function of the number and size of keys,
180-
plus :ref:`page_size <cfg_storage-vinyl_page_size>`,
181-
plus :ref:`bloom_fpr <cfg_storage-vinyl_bloom_fpr>`.
180+
plus :ref:`vinyl_page_size <cfg_storage-vinyl_page_size>`,
181+
plus :ref:`vinyl_bloom_fpr <cfg_storage-vinyl_bloom_fpr>`.
182182
This is not a count of bloom filter "hits"
183183
(the number of reads that could be avoided because the
184184
bloom filter predicts their presence in a run file) --

locale/book/box/engines/index.pot

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -395,7 +395,7 @@ msgstr ""
395395
msgid "To minimize the number of disk reads, especially for nonexistent data, nearly all LSM trees use probabilistic data structures, and Tarantool is no exception. A classical Bloom filter is made up of several (usually 3-to-5) bit arrays. When data is written, several hash functions are calculated for each key in order to get corresponding array positions. The bits at these positions are then set to 1. Due to possible hash collisions, some bits might be set to 1 twice. We’re most interested in the bits that remain 0 after all keys have been added. When looking for an element within a run, the same hash functions are applied to produce bit positions in the arrays. If any of the bits at these positions is 0, then the element is definitely not in the run. The probability of a false positive in a Bloom filter is calculated using Bayes’ theorem: each hash function is an independent random variable, so the probability of a collision simultaneously occurring in all of the bit arrays is infinitesimal."
396396
msgstr ""
397397

398-
msgid "The key advantage of Bloom filters in Tarantool is that they’re easily configurable. The only parameter that can be specified separately for each index is called ``bloom_fpr`` (FPR stands for \"false positive ratio\") and it has the default value of 0.05, which translates to a 5% FPR. Based on this parameter, Tarantool automatically creates Bloom filters of the optimal size for partial- key and full-key searches. The Bloom filters are stored in the `.index` file, along with the page index, and are cached in RAM."
398+
msgid "The key advantage of Bloom filters in Tarantool is that they’re easily configurable. The only parameter that can be specified separately for each index is called ``vinyl_bloom_fpr`` (FPR stands for \"false positive ratio\") and it has the default value of 0.05, which translates to a 5% FPR. Based on this parameter, Tarantool automatically creates Bloom filters of the optimal size for partial- key and full-key searches. The Bloom filters are stored in the `.index` file, along with the page index, and are cached in RAM."
399399
msgstr ""
400400

401401
msgid "Caching"

locale/reference/reference_lua/box_stat.pot

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@ msgstr ""
123123
msgid "``box.stat.vinyl().memory.level0`` is the \"level0\" memory area, sometimes abbreviated \"L0\", which is the area that vinyl can use for in-memory storage of an LSM tree."
124124
msgstr ""
125125

126-
msgid "Therefore we can say that \"L0 is becoming full\" when the amount in ``memory.level0`` is close to the maximum, which is :ref:`regulator.dump_watermark <box_introspection-box_stat_vinyl_regulator>`. We can expect that \"L0 = 0\" immediately after a dump. ``box.stat.vinyl().memory.page_index`` and ``box.stat.vinyl().memory.bloom_filter`` have the current amount being used for index-related structures. The size is a function of the number and size of keys, plus :ref:`page_size <cfg_storage-vinyl_page_size>`, plus :ref:`bloom_fpr <cfg_storage-vinyl_bloom_fpr>`. This is not a count of bloom filter \"hits\" (the number of reads that could be avoided because the bloom filter predicts their presence in a run file) -- that statistic can be found with :ref:`index_object:stat() <box_index-stat>`."
126+
msgid "Therefore we can say that \"L0 is becoming full\" when the amount in ``memory.level0`` is close to the maximum, which is :ref:`regulator.dump_watermark <box_introspection-box_stat_vinyl_regulator>`. We can expect that \"L0 = 0\" immediately after a dump. ``box.stat.vinyl().memory.page_index`` and ``box.stat.vinyl().memory.bloom_filter`` have the current amount being used for index-related structures. The size is a function of the number and size of keys, plus :ref:`vinyl_page_size <cfg_storage-vinyl_page_size>`, plus :ref:`vinyl_bloom_fpr <cfg_storage-vinyl_bloom_fpr>`. This is not a count of bloom filter \"hits\" (the number of reads that could be avoided because the bloom filter predicts their presence in a run file) -- that statistic can be found with :ref:`index_object:stat() <box_index-stat>`."
127127
msgstr ""
128128

129129
msgid "**Details about box.stat.vinyl().tx:** This is about requests that affect transactional activity (\"tx\" is used here as an abbreviation for \"transaction\"):"

locale/ru/LC_MESSAGES/book/box/engines/index.po

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1223,21 +1223,21 @@ msgstr ""
12231223
msgid ""
12241224
"The key advantage of Bloom filters in Tarantool is that they’re easily "
12251225
"configurable. The only parameter that can be specified separately for "
1226-
"each index is called ``bloom_fpr`` (FPR stands for \"false positive "
1227-
"ratio\") and it has the default value of 0.05, which translates to a 5% "
1226+
"each index is called ``vinyl_bloom_fpr`` (FPR stands for \"false positive"
1227+
" ratio\") and it has the default value of 0.05, which translates to a 5% "
12281228
"FPR. Based on this parameter, Tarantool automatically creates Bloom "
12291229
"filters of the optimal size for partial- key and full-key searches. The "
12301230
"Bloom filters are stored in the `.index` file, along with the page index,"
12311231
" and are cached in RAM."
12321232
msgstr ""
12331233
"Ключевым преимуществом реализации фильтров Блума в Tarantool'е является "
12341234
"простота настройки. Единственный параметр, который можно менять "
1235-
"независимо для каждого индекса, называется ``bloom_fpr`` (FPR в данном "
1236-
"случае означает сокращение от \"false positive ratio\" -- коэффициент "
1237-
"ложноположительного срабатывания), который по умолчанию равен 0,05, или "
1238-
"5%. На основе этого параметра Tarantool автоматически строит фильтры "
1239-
"Блума оптимального размера для поиска как по полному ключу, так и по "
1240-
"компонентам ключа. Сами фильтры Блума хранятся вместе с постраничным "
1235+
"независимо для каждого индекса, называется ``vinyl_bloom_fpr`` (FPR в "
1236+
"данном случае означает сокращение от \"false positive ratio\" -- "
1237+
"коэффициент ложноположительного срабатывания), который по умолчанию равен"
1238+
" 0,05, или 5%. На основе этого параметра Tarantool автоматически строит "
1239+
"фильтры Блума оптимального размера для поиска как по полному ключу, так и"
1240+
" по компонентам ключа. Сами фильтры Блума хранятся вместе с постраничным "
12411241
"индексом в файле `.index` и кэшируются в оперативной памяти."
12421242

12431243
msgid "Caching"

locale/ru/LC_MESSAGES/reference/reference_lua/box_stat.po

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -336,11 +336,12 @@ msgid ""
336336
"after a dump. ``box.stat.vinyl().memory.page_index`` and "
337337
"``box.stat.vinyl().memory.bloom_filter`` have the current amount being "
338338
"used for index-related structures. The size is a function of the number "
339-
"and size of keys, plus :ref:`page_size <cfg_storage-vinyl_page_size>`, "
340-
"plus :ref:`bloom_fpr <cfg_storage-vinyl_bloom_fpr>`. This is not a count "
341-
"of bloom filter \"hits\" (the number of reads that could be avoided "
342-
"because the bloom filter predicts their presence in a run file) -- that "
343-
"statistic can be found with :ref:`index_object:stat() <box_index-stat>`."
339+
"and size of keys, plus :ref:`vinyl_page_size <cfg_storage-"
340+
"vinyl_page_size>`, plus :ref:`vinyl_bloom_fpr <cfg_storage-"
341+
"vinyl_bloom_fpr>`. This is not a count of bloom filter \"hits\" (the "
342+
"number of reads that could be avoided because the bloom filter predicts "
343+
"their presence in a run file) -- that statistic can be found with "
344+
":ref:`index_object:stat() <box_index-stat>`."
344345
msgstr ""
345346
"Таким образом, можно сказать, что \"L0 заполняется\", когда объем данных "
346347
"в ``memory.level0`` приближается к максимальному, а именно "
@@ -349,11 +350,11 @@ msgstr ""
349350
"создания дампа. Текущий объем в ``box.stat.vinyl().memory.page_index`` и"
350351
" ``box.stat.vinyl().memory.bloom_filter`` используется для структур, "
351352
"связанных с индексами. Размер -- это количество и размер ключей плюс "
352-
":ref:`page_size <cfg_storage-vinyl_page_size>` плюс :ref:`bloom_fpr "
353-
"<cfg_storage-vinyl_bloom_fpr>`. Это не счетчик совпадений по фильтру "
354-
"Блума (количество чтений, которых можно избежать, поскольку фильтра Блума"
355-
" предсказывает их наличие в файле типа run) -- эта статистика указана в "
356-
":ref:`index_object:stat() <box_index-stat>`."
353+
":ref:`vinyl_page_size <cfg_storage-vinyl_page_size>` плюс "
354+
":ref:`vinyl_bloom_fpr <cfg_storage-vinyl_bloom_fpr>`. Это не счетчик "
355+
"совпадений по фильтру Блума (количество чтений, которых можно избежать, "
356+
"поскольку фильтра Блума предсказывает их наличие в файле типа run) -- эта"
357+
" статистика указана в :ref:`index_object:stat() <box_index-stat>`."
357358

358359
msgid ""
359360
"**Details about box.stat.vinyl().tx:** This is about requests that affect"

0 commit comments

Comments
 (0)