~ubuntu-branches/ubuntu/edgy/rpm/edgy

« back to all changes in this revision

Viewing changes to db/docs/ref/am_conf/extentsize.html

  • Committer: Bazaar Package Importer
  • Author(s): Joey Hess
  • Date: 2002-01-22 20:56:57 UTC
  • Revision ID: james.westby@ubuntu.com-20020122205657-l74j50mr9z8ofcl5
Tags: upstream-4.0.3
ImportĀ upstreamĀ versionĀ 4.0.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!--$Id: extentsize.so,v 1.3 2001/05/02 15:53:22 bostic Exp $-->
 
2
<!--Copyright 1997-2001 by Sleepycat Software, Inc.-->
 
3
<!--All rights reserved.-->
 
4
<html>
 
5
<head>
 
6
<title>Berkeley DB Reference Guide: Selecting a Queue extent size</title>
 
7
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
 
8
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
 
9
</head>
 
10
<body bgcolor=white>
 
11
<a name="2"><!--meow--></a>
 
12
<table width="100%"><tr valign=top>
 
13
<td><h3><dl><dt>Berkeley DB Reference Guide:<dd>Access Methods</dl></h3></td>
 
14
<td align=right><a href="../../ref/am_conf/recno.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/am_conf/re_source.html"><img src="../../images/next.gif" alt="Next"></a>
 
15
</td></tr></table>
 
16
<p>
 
17
<h1 align=center>Selecting a Queue extent size</h1>
 
18
<p>In Queue databases, records are allocated sequentially and directly
 
19
mapped to an offset within the file storage for the database.  As
 
20
records are deleted from the Queue, pages will become empty and will
 
21
not be reused in normal queue operations.  To facilitate the reclamation
 
22
of disk space a Queue may be partitioned into extents.  Each extent is
 
23
kept in a separate physical file.
 
24
<p>Extent files are automatically created as needed and marked for deletion
 
25
when the head of the queue moves off the extent.  The extent will not
 
26
be deleted until all processes close the extent.  In addition, Berkeley DB
 
27
caches a small number of extents that have been recently used; this may
 
28
delay when an extent will be deleted. The number of extents left open
 
29
depends on queue activity.
 
30
<p>The extent size specifies the number of pages that make up each extent.
 
31
By default, if no extent size is specified, the Queue resides in a
 
32
single file and disk space is not reclaimed.  In choosing an extent size
 
33
there is a tradeoff between the amount of disk space used and the
 
34
overhead of creating and deleting files.  If the extent size is too
 
35
small, the system will pay a performance penalty, creating and deleting
 
36
files frequently.  In addition, if the active part of the queue spans
 
37
many files, all those files will need to be open at the same time,
 
38
consuming system and process file resources.
 
39
<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/am_conf/recno.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/am_conf/re_source.html"><img src="../../images/next.gif" alt="Next"></a>
 
40
</td></tr></table>
 
41
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>
 
42
</body>
 
43
</html>