mirror of
https://github.com/postgres/postgres.git
synced 2025-10-29 22:49:41 +03:00
Add Bloom filter implementation.
A Bloom filter is a space-efficient, probabilistic data structure that can be used to test set membership. Callers will sometimes incur false positives, but never false negatives. The rate of false positives is a function of the total number of elements and the amount of memory available for the Bloom filter. Two classic applications of Bloom filters are cache filtering, and data synchronization testing. Any user of Bloom filters must accept the possibility of false positives as a cost worth paying for the benefit in space efficiency. This commit adds a test harness extension module, test_bloomfilter. It can be used to get a sense of how the Bloom filter implementation performs under varying conditions. This is infrastructure for the upcoming "heapallindexed" amcheck patch, which verifies the consistency of a heap relation against one of its indexes. Author: Peter Geoghegan Reviewed-By: Andrey Borodin, Michael Paquier, Thomas Munro, Andres Freund Discussion: https://postgr.es/m/CAH2-Wzm5VmG7cu1N-H=nnS57wZThoSDQU+F5dewx3o84M+jY=g@mail.gmail.com
This commit is contained in:
27
src/include/lib/bloomfilter.h
Normal file
27
src/include/lib/bloomfilter.h
Normal file
@@ -0,0 +1,27 @@
|
||||
/*-------------------------------------------------------------------------
|
||||
*
|
||||
* bloomfilter.h
|
||||
* Space-efficient set membership testing
|
||||
*
|
||||
* Copyright (c) 2018, PostgreSQL Global Development Group
|
||||
*
|
||||
* IDENTIFICATION
|
||||
* src/include/lib/bloomfilter.h
|
||||
*
|
||||
*-------------------------------------------------------------------------
|
||||
*/
|
||||
#ifndef BLOOMFILTER_H
|
||||
#define BLOOMFILTER_H
|
||||
|
||||
typedef struct bloom_filter bloom_filter;
|
||||
|
||||
extern bloom_filter *bloom_create(int64 total_elems, int bloom_work_mem,
|
||||
uint64 seed);
|
||||
extern void bloom_free(bloom_filter *filter);
|
||||
extern void bloom_add_element(bloom_filter *filter, unsigned char *elem,
|
||||
size_t len);
|
||||
extern bool bloom_lacks_element(bloom_filter *filter, unsigned char *elem,
|
||||
size_t len);
|
||||
extern double bloom_prop_bits_set(bloom_filter *filter);
|
||||
|
||||
#endif /* BLOOMFILTER_H */
|
||||
Reference in New Issue
Block a user