1<!--$Id: btstat.so,v 1.12 2003/10/18 19:16:15 bostic Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB Reference Guide: Release 3.1: DB->stat</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<table width="100%"><tr valign=top> 12<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Upgrading Berkeley DB Applications</dl></b></td> 13<td align=right><a href="../upgrade.3.1/dup.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../upgrade.3.1/sysmem.html"><img src="../../images/next.gif" alt="Next"></a> 14</td></tr></table> 15<p align=center><b>Release 3.1: DB->stat</b></p> 16<p>For Btree database statistics, the <a href="../../api_c/db_stat.html">DB->stat</a> method field 17<b>bt_nrecs</b> has been removed, replaced by two fields: 18<b>bt_nkeys</b> and <b>bt_ndata</b>. The <b>bt_nkeys</b> field returns 19a count of the unique keys in the database. The <b>bt_ndata</b> field 20returns a count of the key/data pairs in the database. Neither exactly 21matches the previous value of the <b>bt_nrecs</b> field, which returned 22a count of keys in the database, but, in the case of Btree databases, 23could overcount as it sometimes counted duplicate data items as unique 24keys. The application should be searched for any uses of the 25<b>bt_nrecs</b> field and the field should be changed to be either 26<b>bt_nkeys</b> or <b>bt_ndata</b>, whichever is more appropriate.</p> 27<p>For Hash database statistics, the <a href="../../api_c/db_stat.html">DB->stat</a> method field 28<b>hash_nrecs</b> has been removed, replaced by two fields: 29<b>hash_nkeys</b> and <b>hash_ndata</b>. The <b>hash_nkeys</b> field 30returns a count of the unique keys in the database. The 31<b>hash_ndata</b> field returns a count of the key/data pairs in the 32database. The new <b>hash_nkeys</b> field exactly matches the previous 33value of the <b>hash_nrecs</b> field. The application should be 34searched for any uses of the <b>hash_nrecs</b> field, and the field 35should be changed to be <b>hash_nkeys</b>.</p> 36<p>For Queue database statistics, the <a href="../../api_c/db_stat.html">DB->stat</a> method field 37<b>qs_nrecs</b> has been removed, replaced by two fields: 38<b>qs_nkeys</b> and <b>qs_ndata</b>. The <b>qs_nkeys</b> field returns 39a count of the unique keys in the database. The <b>qs_ndata</b> field 40returns a count of the key/data pairs in the database. The new 41<b>qs_nkeys</b> field exactly matches the previous value of the 42<b>qs_nrecs</b> field. The application should be searched for any uses 43of the <b>qs_nrecs</b> field, and the field should be changed to be 44<b>qs_nkeys</b>.</p> 45<table width="100%"><tr><td><br></td><td align=right><a href="../upgrade.3.1/dup.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../upgrade.3.1/sysmem.html"><img src="../../images/next.gif" alt="Next"></a> 46</td></tr></table> 47<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 48</body> 49</html> 50