samba-mirror/summary.c at 35b4ba0193d783d85283b07f520f0af8dc2c1260

mirror of https://github.com/samba-team/samba.git synced 2024-12-25 23:21:54 +03:00

Rusty Russell dd42962878 ntdb: remove hash table trees.

TDB2 started with a top-level hash of 1024 entries, divided into 128
groups of 8 buckets.  When a bucket filled, the 8 bucket group
expanded into pointers into 8 new 64-entry hash tables.  When these
filled, they expanded in turn, etc.

It's a nice idea to automatically expand the hash tables, but it
doesn't pay off.  Remove it for NTDB.

1) It only beats TDB performance when the database is huge and the
   TDB hashsize is small.  We are about 20% slower on medium-size
   databases (1000 to 10000 records), worse on really small ones.
2) Since we're 64 bits, our hash tables are already twice as expensive
   as TDB.
3) Since our hash function is good, it means that all groups tend to
   fill at the same time, meaning the hash enlarges by a factor of 128
   all at once, leading to a very large database at that point.
4) Our efficiency would improve if we enlarged the top level, but
   that makes our minimum db size even worse: it's already over 8k,
   and jumps to 1M after about 1000 entries!
5) Making the sub group size larger gives a shallower tree, which
   performs better, but makes the "hash explosion" problem worse.
6) The code is complicated, having to handle delete and reshuffling
   groups of hash buckets, and expansion of buckets.
7) We have to handle the case where all the records somehow end up with
   the same hash value, which requires special code to chain records for
   that case.

On the other hand, it would be nice if we didn't degrade as badly as
TDB does when the hash chains get long.

This patch removes the hash-growing code, but instead of chaining like
TDB does when a bucket fills, we point the bucket to an array of
record pointers.  Since each on-disk NTDB pointer contains some hash
bits from the record (we steal the upper 8 bits of the offset), 99.5%
of the time we don't need to load the record to determine if it
matches.  This makes an array of offsets much more cache-friendly than
a linked list.

Here are the times (in ns) for tdb_store of N records, tdb_store of N
records the second time, and a fetch of all N records.  I've also
included the final database size and the smbtorture local.[n]tdb_speed
results.

Benchmark details:
1) Compiled with -O2.
2) assert() was disabled in TDB2 and NTDB.
3) The "optimize fetch" patch was applied to NTDB.

10 runs, using tmpfs (otherwise massive swapping as db hits ~30M,
despite plenty of RAM).

				Insert	Re-ins	Fetch	Size	dbspeed
				(nsec)	(nsec)	(nsec)	(Kb)	(ops/sec)
TDB (10000 hashsize):	
	100 records:		 3882	 3320	1609	   53	203204
	1000 records:		 3651	 3281	1571	  115	218021
	10000 records:		 3404	 3326	1595	  880	202874
	100000 records:		 4317	 3825	2097	 8262	126811
	1000000 records:	11568	11578	9320	77005	 25046

TDB2 (1024 hashsize, expandable):
	100 records:		 3867	 3329	1699	   17	187100	
	1000 records:		 4040	 3249	1639	  154	186255
	10000 records:		 4143	 3300	1695	 1226	185110
	100000 records:		 4481	 3425	1800	17848	163483
	1000000 records:	 4055	 3534	1878   106386	160774

NTDB (8192 hashsize)
	100 records:		 4259	 3376	1692	   82	190852
	1000 records:		 3640	 3275	1566	  130	195106
	10000 records:		 4337	 3438	1614	  773	188362
	100000 records:		 4750	 5165	1746	 9001	169197
	1000000 records:	 4897	 5180	2341	83838	121901

Analysis:
	1) TDB wins on small databases, beating TDB2 by ~15%, NTDB by ~10%.
	2) TDB starts to lose when hash chains get 10 long (fetch 10% slower
	   than TDB2/NTDB).
	3) TDB does horribly when hash chains get 100 long (fetch 4x slower
	   than NTDB, 5x slower than TDB2, insert about 2-3x slower).
	4) TDB2 databases are 40% larger than TDB1.  NTDB is about 15% larger
	   than TDB1

2012-06-19 05:38:07 +02:00

322 lines

9.9 KiB

C

Raw Blame History

  /*
    Trivial Database 2: human-readable summary code
    Copyright (C) Rusty Russell 2010
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 3 of the License, or (at your option) any later version.
    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.
    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, see <http://www.gnu.org/licenses/>.
 */
 #include "private.h"
 #include <ccan/tally/tally.h>
 #define SUMMARY_FORMAT \
 	"Size of file/data: %zu/%zu\n" \
 	"Number of records: %zu\n" \
 	"Smallest/average/largest keys: %zu/%zu/%zu\n%s" \
 	"Smallest/average/largest data: %zu/%zu/%zu\n%s" \
 	"Smallest/average/largest padding: %zu/%zu/%zu\n%s" \
 	"Number of free records: %zu\n" \
 	"Smallest/average/largest free records: %zu/%zu/%zu\n%s" \
 	"Number of uncoalesced records: %zu\n" \
 	"Smallest/average/largest uncoalesced runs: %zu/%zu/%zu\n%s" \
 	"Toplevel hash used: %u of %u\n" \
 	"Number of hashes: %zu\n" \
 	"Smallest/average/largest hash chains: %zu/%zu/%zu\n%s" \
 	"Percentage keys/data/padding/free/rechdrs/freehdrs/hashes: %.0f/%.0f/%.0f/%.0f/%.0f/%.0f/%.0f\n"
 #define BUCKET_SUMMARY_FORMAT_A					\
 	"Free bucket %zu: total entries %zu.\n"			\
 	"Smallest/average/largest length: %zu/%zu/%zu\n%s"
 #define BUCKET_SUMMARY_FORMAT_B					\
 	"Free bucket %zu-%zu: total entries %zu.\n"		\
 	"Smallest/average/largest length: %zu/%zu/%zu\n%s"
 #define CAPABILITY_FORMAT					\
 	"Capability %llu%s\n"
 #define HISTO_WIDTH 70
 #define HISTO_HEIGHT 20
 static ntdb_off_t count_hash(struct ntdb_context *ntdb,
 			     ntdb_off_t hash_off,
 			     ntdb_off_t num)
 {
 	const ntdb_off_t *h;
 	ntdb_off_t i, count = 0;
 	h = ntdb_access_read(ntdb, hash_off, sizeof(*h) * num, true);
 	if (NTDB_PTR_IS_ERR(h)) {
 		return NTDB_ERR_TO_OFF(NTDB_PTR_ERR(h));
 	}
 	for (i = 0; i < num; i++)
 		count += (h[i] != 0);
 	ntdb_access_release(ntdb, h);
 	return count;
 }
 static enum NTDB_ERROR summarize(struct ntdb_context *ntdb,
 				struct tally *ftables,
 				struct tally *fr,
 				struct tally *keys,
 				struct tally *data,
 				struct tally *extra,
 				struct tally *uncoal,
 				struct tally *hashes,
 				size_t *num_caps)
 {
 	ntdb_off_t off;
 	ntdb_len_t len;
 	ntdb_len_t unc = 0;
 	for (off = sizeof(struct ntdb_header);
 	     off < ntdb->file->map_size;
 	     off += len) {
 		const union {
 			struct ntdb_used_record u;
 			struct ntdb_free_record f;
 			struct ntdb_recovery_record r;
 		} *p;
 		/* We might not be able to get the whole thing. */
 		p = ntdb_access_read(ntdb, off, sizeof(p->f), true);
 		if (NTDB_PTR_IS_ERR(p)) {
 			return NTDB_PTR_ERR(p);
 		}
 		if (frec_magic(&p->f) != NTDB_FREE_MAGIC) {
 			if (unc > 1) {
 				tally_add(uncoal, unc);
 				unc = 0;
 			}
 		}
 		if (p->r.magic == NTDB_RECOVERY_INVALID_MAGIC
 		    || p->r.magic == NTDB_RECOVERY_MAGIC) {
 			len = sizeof(p->r) + p->r.max_len;
 		} else if (frec_magic(&p->f) == NTDB_FREE_MAGIC) {
 			len = frec_len(&p->f);
 			tally_add(fr, len);
 			len += sizeof(p->u);
 			unc++;
 		} else if (rec_magic(&p->u) == NTDB_USED_MAGIC) {
 			len = sizeof(p->u)
 				+ rec_key_length(&p->u)
 				+ rec_data_length(&p->u)
 				+ rec_extra_padding(&p->u);
 			tally_add(keys, rec_key_length(&p->u));
 			tally_add(data, rec_data_length(&p->u));
 			tally_add(extra, rec_extra_padding(&p->u));
 		} else if (rec_magic(&p->u) == NTDB_HTABLE_MAGIC) {
 			ntdb_off_t count = count_hash(ntdb,
 						      off + sizeof(p->u),
 << ntdb->hash_bits);
 			if (NTDB_OFF_IS_ERR(count)) {
 				return NTDB_OFF_TO_ERR(count);
 			}
 			tally_add(hashes, count);
 			tally_add(extra, rec_extra_padding(&p->u));
 			len = sizeof(p->u)
 				+ rec_data_length(&p->u)
 				+ rec_extra_padding(&p->u);
 		} else if (rec_magic(&p->u) == NTDB_FTABLE_MAGIC) {
 			len = sizeof(p->u)
 				+ rec_data_length(&p->u)
 				+ rec_extra_padding(&p->u);
 			tally_add(ftables, rec_data_length(&p->u));
 			tally_add(extra, rec_extra_padding(&p->u));
 		} else if (rec_magic(&p->u) == NTDB_CHAIN_MAGIC) {
 			len = sizeof(p->u)
 				+ rec_data_length(&p->u)
 				+ rec_extra_padding(&p->u);
 			tally_add(hashes,
 				  rec_data_length(&p->u)/sizeof(ntdb_off_t));
 			tally_add(extra, rec_extra_padding(&p->u));
 		} else if (rec_magic(&p->u) == NTDB_CAP_MAGIC) {
 			len = sizeof(p->u)
 				+ rec_data_length(&p->u)
 				+ rec_extra_padding(&p->u);
 			(*num_caps)++;
 		} else {
 			len = dead_space(ntdb, off);
 			if (NTDB_OFF_IS_ERR(len)) {
 				return NTDB_OFF_TO_ERR(len);
 			}
 		}
 		ntdb_access_release(ntdb, p);
 	}
 	if (unc)
 		tally_add(uncoal, unc);
 	return NTDB_SUCCESS;
 }
 static void add_capabilities(struct ntdb_context *ntdb, char *summary)
 {
 	ntdb_off_t off, next;
 	const struct ntdb_capability *cap;
 	size_t count = 0;
 	/* Append to summary. */
 	summary += strlen(summary);
 	off = ntdb_read_off(ntdb, offsetof(struct ntdb_header, capabilities));
 	if (NTDB_OFF_IS_ERR(off))
 		return;
 	/* Walk capability list. */
 	for (; off; off = next) {
 		cap = ntdb_access_read(ntdb, off, sizeof(*cap), true);
 		if (NTDB_PTR_IS_ERR(cap)) {
 			break;
 		}
 		count++;
 		sprintf(summary, CAPABILITY_FORMAT,
 			cap->type & NTDB_CAP_TYPE_MASK,
 			/* Noopen?  How did we get here? */
 			(cap->type & NTDB_CAP_NOOPEN) ? " (unopenable)"
 			: ((cap->type & NTDB_CAP_NOWRITE)
 			   && (cap->type & NTDB_CAP_NOCHECK)) ? " (uncheckable,read-only)"
 			: (cap->type & NTDB_CAP_NOWRITE) ? " (read-only)"
 			: (cap->type & NTDB_CAP_NOCHECK) ? " (uncheckable)"
 			: "");
 		summary += strlen(summary);
 		next = cap->next;
 		ntdb_access_release(ntdb, cap);
 	}
 }
 _PUBLIC_ enum NTDB_ERROR ntdb_summary(struct ntdb_context *ntdb,
 			   enum ntdb_summary_flags flags,
 			   char **summary)
 {
 	ntdb_len_t len;
 	size_t num_caps = 0;
 	struct tally *ftables, *freet, *keys, *data, *extra, *uncoal, *hashes;
 	char *freeg, *keysg, *datag, *extrag, *uncoalg, *hashesg;
 	enum NTDB_ERROR ecode;
 	freeg = keysg = datag = extrag = uncoalg = hashesg = NULL;
 	ecode = ntdb_allrecord_lock(ntdb, F_RDLCK, NTDB_LOCK_WAIT, false);
 	if (ecode != NTDB_SUCCESS) {
 		return ecode;
 	}
 	ecode = ntdb_lock_expand(ntdb, F_RDLCK);
 	if (ecode != NTDB_SUCCESS) {
 		ntdb_allrecord_unlock(ntdb, F_RDLCK);
 		return ecode;
 	}
 	/* Start stats off empty. */
 	ftables = tally_new(HISTO_HEIGHT);
 	freet = tally_new(HISTO_HEIGHT);
 	keys = tally_new(HISTO_HEIGHT);
 	data = tally_new(HISTO_HEIGHT);
 	extra = tally_new(HISTO_HEIGHT);
 	uncoal = tally_new(HISTO_HEIGHT);
 	hashes = tally_new(HISTO_HEIGHT);
 	if (!ftables || !freet || !keys || !data || !extra
 	    || !uncoal || !hashes) {
 		ecode = ntdb_logerr(ntdb, NTDB_ERR_OOM, NTDB_LOG_ERROR,
 				   "ntdb_summary: failed to allocate"
 				   " tally structures");
 		goto unlock;
 	}
 	ecode = summarize(ntdb, ftables, freet, keys, data, extra,
 			  uncoal, hashes, &num_caps);
 	if (ecode != NTDB_SUCCESS) {
 		goto unlock;
 	}
 	if (flags & NTDB_SUMMARY_HISTOGRAMS) {
 		freeg = tally_histogram(freet, HISTO_WIDTH, HISTO_HEIGHT);
 		keysg = tally_histogram(keys, HISTO_WIDTH, HISTO_HEIGHT);
 		datag = tally_histogram(data, HISTO_WIDTH, HISTO_HEIGHT);
 		extrag = tally_histogram(extra, HISTO_WIDTH, HISTO_HEIGHT);
 		uncoalg = tally_histogram(uncoal, HISTO_WIDTH, HISTO_HEIGHT);
 		hashesg = tally_histogram(hashes, HISTO_WIDTH, HISTO_HEIGHT);
 	}
 	/* 20 is max length of a %llu. */
 	len = strlen(SUMMARY_FORMAT) + 33*20 + 1
 		+ (freeg ? strlen(freeg) : 0)
 		+ (keysg ? strlen(keysg) : 0)
 		+ (datag ? strlen(datag) : 0)
 		+ (extrag ? strlen(extrag) : 0)
 		+ (uncoalg ? strlen(uncoalg) : 0)
 		+ (hashesg ? strlen(hashesg) : 0)
 		+ num_caps * (strlen(CAPABILITY_FORMAT) + 20
 			      + strlen(" (uncheckable,read-only)"));
 	*summary = ntdb->alloc_fn(ntdb, len, ntdb->alloc_data);
 	if (!*summary) {
 		ecode = ntdb_logerr(ntdb, NTDB_ERR_OOM, NTDB_LOG_ERROR,
 				   "ntdb_summary: failed to allocate string");
 		goto unlock;
 	}
 	sprintf(*summary, SUMMARY_FORMAT,
 		(size_t)ntdb->file->map_size,
 		tally_total(keys, NULL) + tally_total(data, NULL),
 		tally_num(keys),
 		tally_min(keys), tally_mean(keys), tally_max(keys),
 		keysg ? keysg : "",
 		tally_min(data), tally_mean(data), tally_max(data),
 		datag ? datag : "",
 		tally_min(extra), tally_mean(extra), tally_max(extra),
 		extrag ? extrag : "",
 		tally_num(freet),
 		tally_min(freet), tally_mean(freet), tally_max(freet),
 		freeg ? freeg : "",
 		tally_total(uncoal, NULL),
 		tally_min(uncoal), tally_mean(uncoal), tally_max(uncoal),
 		uncoalg ? uncoalg : "",
 		(unsigned)count_hash(ntdb, sizeof(struct ntdb_header),
 << ntdb->hash_bits),
 << ntdb->hash_bits,
 		tally_num(hashes),
 		tally_min(hashes), tally_mean(hashes), tally_max(hashes),
 		hashesg ? hashesg : "",
 		tally_total(keys, NULL) * 100.0 / ntdb->file->map_size,
 		tally_total(data, NULL) * 100.0 / ntdb->file->map_size,
 		tally_total(extra, NULL) * 100.0 / ntdb->file->map_size,
 		tally_total(freet, NULL) * 100.0 / ntdb->file->map_size,
 		(tally_num(keys) + tally_num(freet) + tally_num(hashes))
 		* sizeof(struct ntdb_used_record) * 100.0 / ntdb->file->map_size,
 		tally_num(ftables) * sizeof(struct ntdb_freetable)
 		* 100.0 / ntdb->file->map_size,
 		(tally_total(hashes, NULL) * sizeof(ntdb_off_t)
 		 + (sizeof(ntdb_off_t) << ntdb->hash_bits))
 		* 100.0 / ntdb->file->map_size);
 	add_capabilities(ntdb, *summary);
 unlock:
 	ntdb->free_fn(freeg, ntdb->alloc_data);
 	ntdb->free_fn(keysg, ntdb->alloc_data);
 	ntdb->free_fn(datag, ntdb->alloc_data);
 	ntdb->free_fn(extrag, ntdb->alloc_data);
 	ntdb->free_fn(uncoalg, ntdb->alloc_data);
 	ntdb->free_fn(hashesg, ntdb->alloc_data);
 	ntdb->free_fn(freet, ntdb->alloc_data);
 	ntdb->free_fn(keys, ntdb->alloc_data);
 	ntdb->free_fn(data, ntdb->alloc_data);
 	ntdb->free_fn(extra, ntdb->alloc_data);
 	ntdb->free_fn(uncoal, ntdb->alloc_data);
 	ntdb->free_fn(ftables, ntdb->alloc_data);
 	ntdb->free_fn(hashes, ntdb->alloc_data);
 	ntdb_allrecord_unlock(ntdb, F_RDLCK);
 	ntdb_unlock_expand(ntdb, F_RDLCK);
 	return ecode;
 }

322 lines 9.9 KiB C Raw Blame History

322 lines

9.9 KiB

C

Raw Blame History