Oracle Berkeley DB XML Programmer's Reference Guide 12c Release 1 Library Version 12.1.6.0 Legal Notice This documentation is distributed under an open source license. You may review the terms of this license at: http:// www.oracle.com/technetwork/database/berkeleydb/downloads/xmloslicense-086890.html Oracle, Berkeley DB, Berkeley DB XML and Sleepycat are trademarks or registered trademarks of Oracle. All rights to these marks are reserved. No third-party use is permitted without the express prior written consent of Oracle. Other names may be trademarks of their respective owners. To obtain a copy of this document's original source code, please submit a request to the Oracle Technology Network forum at: https://community.oracle.com/community/database/high_availability/berkeley_db_family/berkeley_db_xml Published 7/10/2015 Table of Contents Preface ...................................................................................................... ix Conventions Used in this Book .................................................................... ix For More Information ............................................................................... ix Contact Us ...................................................................................... x 1. Introduction to Berkeley DB XML .................................................................... 1 Architecture .......................................................................................... 1 Document Storage ............................................................................ 3 2. Building Berkeley DB XML for UNIX/POSIX systems ............................................... 4 Using the buildall.sh Script ........................................................................ 4 Preparing to build ............................................................................. 4 Building Berkeley DB XML and third-party libraries ..................................... 5 Configuring Berkeley DB XML and third-party libraries ................................. 5 Advanced Building and Troubleshooting ................................................... 8 Building Individual Berkeley DB XML Libraries for UNIX ..................................... 8 Building Individual Libraries ................................................................. 8 Berkeley DB .............................................................................. 8 Xerces .................................................................................... 9 XQilla ..................................................................................... 9 Configuring and building Berkeley DB XML ................................................ 9 Building the Java API ....................................................................... 10 Configuring Berkeley DB XML ..................................................................... 10 Changing compilation and link options ....................................................... 12 Installing Berkeley DB XML ..................................................................... 13 Dynamic shared libraries ....................................................................... 14 Building and Using Berkeley DB XML Applications on UNIX/POSIX Systems .............. 15 Building C++ Applications .................................................................. 16 Building Java Applications ................................................................. 16 Architecture Independent Build FAQ .......................................................... 17 AIX Build Notes ..................................................................................... 17 Solaris Build Notes ................................................................................. 18 FreeBSD Build Notes ............................................................................... 18 Mac OS X Build Notes ............................................................................. 19 Cygwin Build Notes ................................................................................ 19 3. Building Berkeley DB XML for Windows ........................................................... 21 Third Party Libraries ............................................................................... 21 Building with Microsoft Visual Studio 2010 and 2012 ......................................... 21 Building with Microsoft Visual Studio 2008 and Express Edition ............................ 22 Building with Microsoft Visual Studio 2005 ..................................................... 22 Building with Microsoft Visual C++ 2005 Express Edition ..................................... 23 Running C++ Examples ............................................................................. 23 Building the Java API with Visual Studio ....................................................... 23 Building the Tcl API ................................................................................ 24 Building Tcl with Visual Studio ................................................................... 24 Disabling default compression ................................................................... 25 Using Berkeley DB XML on Windows .......................................................... 25 Berkeley DB XML Include File Locations ................................................. 25 7/10/2015 Programmer's Reference Guide Page iii Berkeley DB XML Include File Locations ................................................. 25 Berkeley DB XML DLL Names and Locations ............................................. 26 Berkeley DB XML Binaries on Windows ....................................................... 26 Windows Installer Options .................................................................. 26 Installation Layout ........................................................................... 27 General Note on Using Windows Binaries ................................................ 28 Using C++ Runtime Libraries and Programs .............................................. 28 Using Java Binaries .......................................................................... 28 Installing and Using Python Binaries ...................................................... 28 Installing and Using Perl Binaries ......................................................... 29 Troubleshooting on Windows ................................................................... 29 Compiling Errors ............................................................................. 29 Linking Errors ................................................................................. 30 Execution Errors ............................................................................. 30 4. Berkeley DB XML XQuery Extension Functions ................................................... 32 fn:collection() .................................................................................... 32 Parameters .................................................................................... 32 $arg ...................................................................................... 32 URI Resolution in Berkeley DB XML ....................................................... 32 dbxml:contains() ................................................................................. 33 fn:doc() ............................................................................................ 33 dbxml:lookup*() .................................................................................. 33 dbxml:metadata() ................................................................................ 34 dbxml:node*() .................................................................................... 34 5. Upgrading Berkeley DB XML ........................................................................ 35 Library Version Information ...................................................................... 35 Upgrading Berkeley DB XML Applications to 2.3 ............................................ 35 Upgrading 2.x-based Containers ........................................................... 35 Upgrading Berkeley DB XML Applications to 2.2 ............................................ 36 Upgrading 2.0- or 2.1-based Containers ................................................. 36 Change in dbxml shell default container type .......................................... 36 Upgrading Berkeley DB XML Applications to 2.1 ............................................ 37 Upgrading existing containers ............................................................. 37 Upgrading Berkeley DB XML 1.2.X applications to Berkeley DB XML 2.0 ................. 37 New and Changed Features in 2.0 ...................................................... 37 Migrating Berkeley DB XML C++ Applications .......................................... 38 XmlManager ............................................................................ 38 XmlContainer Management .......................................................... 38 XmlManager and Berkeley DB DbEnv ............................................... 39 Queries .................................................................................. 39 Transactions ............................................................................ 40 Migrating Berkeley DB XML Java Applications ......................................... 41 XmlManager and Environment ....................................................... 42 Configuration Object ................................................................