com.wiredtiger.db.wiredtiger Class Reference

Inherits com.wiredtiger.db.wiredtigerConstants.

Static Public Member Functions
static String	wiredtiger_strerror (int err)
static Connection	open (String home, String config) throws com.wiredtiger.db.WiredTigerException
	Open a connection to a database. More...

Additional Inherited Members
Static Public Attributes inherited from com.wiredtiger.db.wiredtigerConstants
static final int	WIREDTIGER_VERSION_MAJOR
static final int	WIREDTIGER_VERSION_MINOR
static final int	WIREDTIGER_VERSION_PATCH
static final String	WIREDTIGER_VERSION_STRING
static final int	WT_DUPLICATE_KEY
static final int	WT_ERROR
static final int	WT_NOTFOUND
static final int	WT_PANIC
static final int	WT_RESTART
static final int	WT_ROLLBACK
static final int	WT_DEADLOCK
static final int	WT_STAT_CONN_ASYNC_ALLOC_RACE
static final int	WT_STAT_CONN_ASYNC_ALLOC_VIEW
static final int	WT_STAT_CONN_ASYNC_CUR_QUEUE
static final int	WT_STAT_CONN_ASYNC_FLUSH
static final int	WT_STAT_CONN_ASYNC_FULL
static final int	WT_STAT_CONN_ASYNC_MAX_QUEUE
static final int	WT_STAT_CONN_ASYNC_NOWORK
static final int	WT_STAT_CONN_ASYNC_OP_ALLOC
static final int	WT_STAT_CONN_ASYNC_OP_COMPACT
static final int	WT_STAT_CONN_ASYNC_OP_INSERT
static final int	WT_STAT_CONN_ASYNC_OP_REMOVE
static final int	WT_STAT_CONN_ASYNC_OP_SEARCH
static final int	WT_STAT_CONN_ASYNC_OP_UPDATE
static final int	WT_STAT_CONN_BLOCK_BYTE_MAP_READ
static final int	WT_STAT_CONN_BLOCK_BYTE_READ
static final int	WT_STAT_CONN_BLOCK_BYTE_WRITE
static final int	WT_STAT_CONN_BLOCK_MAP_READ
static final int	WT_STAT_CONN_BLOCK_PRELOAD
static final int	WT_STAT_CONN_BLOCK_READ
static final int	WT_STAT_CONN_BLOCK_WRITE
static final int	WT_STAT_CONN_CACHE_BYTES_DIRTY
static final int	WT_STAT_CONN_CACHE_BYTES_INUSE
static final int	WT_STAT_CONN_CACHE_BYTES_MAX
static final int	WT_STAT_CONN_CACHE_BYTES_READ
static final int	WT_STAT_CONN_CACHE_BYTES_WRITE
static final int	WT_STAT_CONN_CACHE_EVICTION_CHECKPOINT
static final int	WT_STAT_CONN_CACHE_EVICTION_CLEAN
static final int	WT_STAT_CONN_CACHE_EVICTION_DEEPEN
static final int	WT_STAT_CONN_CACHE_EVICTION_DIRTY
static final int	WT_STAT_CONN_CACHE_EVICTION_FAIL
static final int	WT_STAT_CONN_CACHE_EVICTION_FORCE
static final int	WT_STAT_CONN_CACHE_EVICTION_FORCE_FAIL
static final int	WT_STAT_CONN_CACHE_EVICTION_HAZARD
static final int	WT_STAT_CONN_CACHE_EVICTION_INTERNAL
static final int	WT_STAT_CONN_CACHE_EVICTION_QUEUE_EMPTY
static final int	WT_STAT_CONN_CACHE_EVICTION_QUEUE_NOT_EMPTY
static final int	WT_STAT_CONN_CACHE_EVICTION_SERVER_EVICTING
static final int	WT_STAT_CONN_CACHE_EVICTION_SERVER_NOT_EVICTING
static final int	WT_STAT_CONN_CACHE_EVICTION_SLOW
static final int	WT_STAT_CONN_CACHE_EVICTION_SPLIT
static final int	WT_STAT_CONN_CACHE_EVICTION_WALK
static final int	WT_STAT_CONN_CACHE_PAGES_DIRTY
static final int	WT_STAT_CONN_CACHE_PAGES_INUSE
static final int	WT_STAT_CONN_CACHE_READ
static final int	WT_STAT_CONN_CACHE_WRITE
static final int	WT_STAT_CONN_COND_WAIT
static final int	WT_STAT_CONN_CURSOR_CREATE
static final int	WT_STAT_CONN_CURSOR_INSERT
static final int	WT_STAT_CONN_CURSOR_NEXT
static final int	WT_STAT_CONN_CURSOR_PREV
static final int	WT_STAT_CONN_CURSOR_REMOVE
static final int	WT_STAT_CONN_CURSOR_RESET
static final int	WT_STAT_CONN_CURSOR_SEARCH
static final int	WT_STAT_CONN_CURSOR_SEARCH_NEAR
static final int	WT_STAT_CONN_CURSOR_UPDATE
static final int	WT_STAT_CONN_DH_SESSION_HANDLES
static final int	WT_STAT_CONN_DH_SESSION_SWEEPS
static final int	WT_STAT_CONN_FILE_OPEN
static final int	WT_STAT_CONN_LOG_BUFFER_GROW
static final int	WT_STAT_CONN_LOG_BUFFER_SIZE
static final int	WT_STAT_CONN_LOG_BYTES_USER
static final int	WT_STAT_CONN_LOG_BYTES_WRITTEN
static final int	WT_STAT_CONN_LOG_CLOSE_YIELDS
static final int	WT_STAT_CONN_LOG_MAX_FILESIZE
static final int	WT_STAT_CONN_LOG_READS
static final int	WT_STAT_CONN_LOG_SCAN_RECORDS
static final int	WT_STAT_CONN_LOG_SCAN_REREADS
static final int	WT_STAT_CONN_LOG_SCANS
static final int	WT_STAT_CONN_LOG_SLOT_CLOSES
static final int	WT_STAT_CONN_LOG_SLOT_CONSOLIDATED
static final int	WT_STAT_CONN_LOG_SLOT_JOINS
static final int	WT_STAT_CONN_LOG_SLOT_RACES
static final int	WT_STAT_CONN_LOG_SLOT_SWITCH_FAILS
static final int	WT_STAT_CONN_LOG_SLOT_TOOBIG
static final int	WT_STAT_CONN_LOG_SLOT_TOOSMALL
static final int	WT_STAT_CONN_LOG_SLOT_TRANSITIONS
static final int	WT_STAT_CONN_LOG_SYNC
static final int	WT_STAT_CONN_LOG_WRITES
static final int	WT_STAT_CONN_LSM_CHECKPOINT_THROTTLE
static final int	WT_STAT_CONN_LSM_MERGE_THROTTLE
static final int	WT_STAT_CONN_LSM_ROWS_MERGED
static final int	WT_STAT_CONN_LSM_WORK_QUEUE_APP
static final int	WT_STAT_CONN_LSM_WORK_QUEUE_MANAGER
static final int	WT_STAT_CONN_LSM_WORK_QUEUE_MAX
static final int	WT_STAT_CONN_LSM_WORK_QUEUE_SWITCH
static final int	WT_STAT_CONN_LSM_WORK_UNITS_CREATED
static final int	WT_STAT_CONN_LSM_WORK_UNITS_DISCARDED
static final int	WT_STAT_CONN_LSM_WORK_UNITS_DONE
static final int	WT_STAT_CONN_MEMORY_ALLOCATION
static final int	WT_STAT_CONN_MEMORY_FREE
static final int	WT_STAT_CONN_MEMORY_GROW
static final int	WT_STAT_CONN_READ_IO
static final int	WT_STAT_CONN_REC_PAGES
static final int	WT_STAT_CONN_REC_PAGES_EVICTION
static final int	WT_STAT_CONN_REC_SPLIT_STASHED_BYTES
static final int	WT_STAT_CONN_REC_SPLIT_STASHED_OBJECTS
static final int	WT_STAT_CONN_RWLOCK_READ
static final int	WT_STAT_CONN_RWLOCK_WRITE
static final int	WT_STAT_CONN_SESSION_CURSOR_OPEN
static final int	WT_STAT_CONN_SESSION_OPEN
static final int	WT_STAT_CONN_TXN_BEGIN
static final int	WT_STAT_CONN_TXN_CHECKPOINT
static final int	WT_STAT_CONN_TXN_CHECKPOINT_RUNNING
static final int	WT_STAT_CONN_TXN_COMMIT
static final int	WT_STAT_CONN_TXN_FAIL_CACHE
static final int	WT_STAT_CONN_TXN_PINNED_RANGE
static final int	WT_STAT_CONN_TXN_ROLLBACK
static final int	WT_STAT_CONN_WRITE_IO
static final int	WT_STAT_DSRC_ALLOCATION_SIZE
static final int	WT_STAT_DSRC_BLOCK_ALLOC
static final int	WT_STAT_DSRC_BLOCK_CHECKPOINT_SIZE
static final int	WT_STAT_DSRC_BLOCK_EXTENSION
static final int	WT_STAT_DSRC_BLOCK_FREE
static final int	WT_STAT_DSRC_BLOCK_MAGIC
static final int	WT_STAT_DSRC_BLOCK_MAJOR
static final int	WT_STAT_DSRC_BLOCK_MINOR
static final int	WT_STAT_DSRC_BLOCK_REUSE_BYTES
static final int	WT_STAT_DSRC_BLOCK_SIZE
static final int	WT_STAT_DSRC_BLOOM_COUNT
static final int	WT_STAT_DSRC_BLOOM_FALSE_POSITIVE
static final int	WT_STAT_DSRC_BLOOM_HIT
static final int	WT_STAT_DSRC_BLOOM_MISS
static final int	WT_STAT_DSRC_BLOOM_PAGE_EVICT
static final int	WT_STAT_DSRC_BLOOM_PAGE_READ
static final int	WT_STAT_DSRC_BLOOM_SIZE
static final int	WT_STAT_DSRC_BTREE_COLUMN_DELETED
static final int	WT_STAT_DSRC_BTREE_COLUMN_FIX
static final int	WT_STAT_DSRC_BTREE_COLUMN_INTERNAL
static final int	WT_STAT_DSRC_BTREE_COLUMN_VARIABLE
static final int	WT_STAT_DSRC_BTREE_COMPACT_REWRITE
static final int	WT_STAT_DSRC_BTREE_ENTRIES
static final int	WT_STAT_DSRC_BTREE_FIXED_LEN
static final int	WT_STAT_DSRC_BTREE_MAXIMUM_DEPTH
static final int	WT_STAT_DSRC_BTREE_MAXINTLITEM
static final int	WT_STAT_DSRC_BTREE_MAXINTLPAGE
static final int	WT_STAT_DSRC_BTREE_MAXLEAFITEM
static final int	WT_STAT_DSRC_BTREE_MAXLEAFPAGE
static final int	WT_STAT_DSRC_BTREE_OVERFLOW
static final int	WT_STAT_DSRC_BTREE_ROW_INTERNAL
static final int	WT_STAT_DSRC_BTREE_ROW_LEAF
static final int	WT_STAT_DSRC_CACHE_BYTES_READ
static final int	WT_STAT_DSRC_CACHE_BYTES_WRITE
static final int	WT_STAT_DSRC_CACHE_EVICTION_CHECKPOINT
static final int	WT_STAT_DSRC_CACHE_EVICTION_CLEAN
static final int	WT_STAT_DSRC_CACHE_EVICTION_DIRTY
static final int	WT_STAT_DSRC_CACHE_EVICTION_FAIL
static final int	WT_STAT_DSRC_CACHE_EVICTION_HAZARD
static final int	WT_STAT_DSRC_CACHE_EVICTION_INTERNAL
static final int	WT_STAT_DSRC_CACHE_OVERFLOW_VALUE
static final int	WT_STAT_DSRC_CACHE_READ
static final int	WT_STAT_DSRC_CACHE_READ_OVERFLOW
static final int	WT_STAT_DSRC_CACHE_WRITE
static final int	WT_STAT_DSRC_COMPRESS_RAW_FAIL
static final int	WT_STAT_DSRC_COMPRESS_RAW_FAIL_TEMPORARY
static final int	WT_STAT_DSRC_COMPRESS_RAW_OK
static final int	WT_STAT_DSRC_COMPRESS_READ
static final int	WT_STAT_DSRC_COMPRESS_WRITE
static final int	WT_STAT_DSRC_COMPRESS_WRITE_FAIL
static final int	WT_STAT_DSRC_COMPRESS_WRITE_TOO_SMALL
static final int	WT_STAT_DSRC_CURSOR_CREATE
static final int	WT_STAT_DSRC_CURSOR_INSERT
static final int	WT_STAT_DSRC_CURSOR_INSERT_BULK
static final int	WT_STAT_DSRC_CURSOR_INSERT_BYTES
static final int	WT_STAT_DSRC_CURSOR_NEXT
static final int	WT_STAT_DSRC_CURSOR_PREV
static final int	WT_STAT_DSRC_CURSOR_REMOVE
static final int	WT_STAT_DSRC_CURSOR_REMOVE_BYTES
static final int	WT_STAT_DSRC_CURSOR_RESET
static final int	WT_STAT_DSRC_CURSOR_SEARCH
static final int	WT_STAT_DSRC_CURSOR_SEARCH_NEAR
static final int	WT_STAT_DSRC_CURSOR_UPDATE
static final int	WT_STAT_DSRC_CURSOR_UPDATE_BYTES
static final int	WT_STAT_DSRC_LSM_CHECKPOINT_THROTTLE
static final int	WT_STAT_DSRC_LSM_CHUNK_COUNT
static final int	WT_STAT_DSRC_LSM_GENERATION_MAX
static final int	WT_STAT_DSRC_LSM_LOOKUP_NO_BLOOM
static final int	WT_STAT_DSRC_LSM_MERGE_THROTTLE
static final int	WT_STAT_DSRC_REC_DICTIONARY
static final int	WT_STAT_DSRC_REC_MULTIBLOCK_INTERNAL
static final int	WT_STAT_DSRC_REC_MULTIBLOCK_LEAF
static final int	WT_STAT_DSRC_REC_MULTIBLOCK_MAX
static final int	WT_STAT_DSRC_REC_OVERFLOW_KEY_INTERNAL
static final int	WT_STAT_DSRC_REC_OVERFLOW_KEY_LEAF
static final int	WT_STAT_DSRC_REC_OVERFLOW_VALUE
static final int	WT_STAT_DSRC_REC_PAGE_DELETE
static final int	WT_STAT_DSRC_REC_PAGE_MATCH
static final int	WT_STAT_DSRC_REC_PAGES
static final int	WT_STAT_DSRC_REC_PAGES_EVICTION
static final int	WT_STAT_DSRC_REC_PREFIX_COMPRESSION
static final int	WT_STAT_DSRC_REC_SUFFIX_COMPRESSION
static final int	WT_STAT_DSRC_SESSION_COMPACT
static final int	WT_STAT_DSRC_SESSION_CURSOR_OPEN
static final int	WT_STAT_DSRC_TXN_UPDATE_CONFLICT
static final int	WT_LOGOP_INVALID
static final int	WT_LOGREC_CHECKPOINT
static final int	WT_LOGREC_COMMIT
static final int	WT_LOGREC_FILE_SYNC
static final int	WT_LOGREC_MESSAGE
static final int	WT_LOGOP_COL_PUT
static final int	WT_LOGOP_COL_REMOVE
static final int	WT_LOGOP_COL_TRUNCATE
static final int	WT_LOGOP_ROW_PUT
static final int	WT_LOGOP_ROW_REMOVE
static final int	WT_LOGOP_ROW_TRUNCATE

Member Function Documentation

static Connection com.wiredtiger.db.wiredtiger.open ( String  home, String  config  ) throws com.wiredtiger.db.WiredTigerException

static

Open a connection to a database.

        ret = wiredtiger_open(home, NULL, "create,cache_size=500M", &conn);

Parameters

	home	The path to the database home directory. See Database Home Directory for more information.
	errhandler	An error handler. If NULL, a builtin error handler is installed that writes error messages to stderr
	config	Configuration string, see Configuration Strings. Permitted values: Name Effect Values async = ( asynchronous operations configuration options. a set of related configuration options defined below.     enabled enable asynchronous operation. a boolean flag; default false.     ops_max maximum number of expected simultaneous asynchronous operations. an integer between 10 and 4096; default 1024.     threads the number of worker threads to service asynchronous requests. an integer between 1 and 20; default 2. ) buffer_alignment in-memory alignment (in bytes) for buffers used for I/O. The default value of -1 indicates a platform-specific alignment value should be used (4KB on Linux systems, zero elsewhere). an integer between -1 and 1MB; default -1. cache_size maximum heap memory to allocate for the cache. A database should configure either a cache_size or a shared_cache not both. an integer between 1MB and 10TB; default 100MB. checkpoint = ( periodically checkpoint the database. a set of related configuration options defined below.     log_size wait for this amount of log record bytes to be written to the log between each checkpoint. A database can configure both log_size and wait to set an upper bound for checkpoints; setting this value above 0 configures periodic checkpoints. an integer between 0 and 2GB; default 0.     name the checkpoint name. a string; default "WiredTigerCheckpoint".     wait seconds to wait between each checkpoint; setting this value above 0 configures periodic checkpoints. an integer between 0 and 100000; default 0. ) checkpoint_sync flush files to stable storage when closing or writing checkpoints. a boolean flag; default true. config_base write the base configuration file if creating the database, see WiredTiger.basecfg file for more information. a boolean flag; default true. create create the database if it does not exist. a boolean flag; default false. direct_io Use O_DIRECT to access files. Options are given as a list, such as "direct_io=[data]". Configuring direct_io requires care, see Direct I/O for important warnings. Including "data" will cause WiredTiger data files to use O_DIRECT, including "log" will cause WiredTiger log files to use O_DIRECT, and including "checkpoint" will cause WiredTiger data files opened at a checkpoint (i.e: read only) to use O_DIRECT. a list, with values chosen from the following options: "checkpoint", "data", "log"; default empty. error_prefix prefix string for error messages. a string; default empty. eviction = ( eviction configuration options. a set of related configuration options defined below.     threads_max maximum number of threads WiredTiger will start to help evict pages from cache. The number of threads started will vary depending on the current eviction load. an integer between 1 and 20; default 1.     threads_min minimum number of threads WiredTiger will start to help evict pages from cache. The number of threads currently running will vary depending on the current eviction load. an integer between 1 and 20; default 1. ) eviction_dirty_target continue evicting until the cache has less dirty memory than the value, as a percentage of the total cache size. Dirty pages will only be evicted if the cache is full enough to trigger eviction. an integer between 10 and 99; default 80. eviction_target continue evicting until the cache has less total memory than the value, as a percentage of the total cache size. Must be less than eviction_trigger. an integer between 10 and 99; default 80. eviction_trigger trigger eviction when the cache is using this much memory, as a percentage of the total cache size. an integer between 10 and 99; default 95. exclusive fail if the database already exists, generally used with the create option. a boolean flag; default false. extensions list of shared library extensions to load (using dlopen). Any values specified to an library extension are passed to WT_CONNECTION::load_extension as the config parameter (for example, extensions=(/path/ext.so={entry=my_entry})). a list of strings; default empty. file_extend file extension configuration. If set, extend files of the set type in allocations of the set size, instead of a block at a time as each new block is written. For example, file_extend=(data=16MB). a list, with values chosen from the following options: "data", "log"; default empty. hazard_max maximum number of simultaneous hazard pointers per session handle. an integer greater than or equal to 15; default 1000. log = ( enable logging. a set of related configuration options defined below.     archive automatically archive unneeded log files. a boolean flag; default true.     enabled enable logging subsystem. a boolean flag; default false.     file_max the maximum size of log files. an integer between 100KB and 2GB; default 100MB.     path the path to a directory into which the log files are written. If the value is not an absolute path name, the files are created relative to the database home. a string; default "". ) lsm_manager = ( configure database wide options for LSM tree management. a set of related configuration options defined below.     merge merge LSM chunks where possible. a boolean flag; default true.     worker_thread_max Configure a set of threads to manage merging LSM trees in the database. an integer between 3 and 20; default 4. ) mmap Use memory mapping to access files when possible. a boolean flag; default true. multiprocess permit sharing between processes (will automatically start an RPC server for primary processes and use RPC for secondary processes). Not yet supported in WiredTiger. a boolean flag; default false. session_max maximum expected number of sessions (including server threads). an integer greater than or equal to 1; default 100. shared_cache = ( shared cache configuration options. A database should configure either a cache_size or a shared_cache not both. a set of related configuration options defined below.     chunk the granularity that a shared cache is redistributed. an integer between 1MB and 10TB; default 10MB.     name name of a cache that is shared between databases. a string; default empty.     reserve amount of cache this database is guaranteed to have available from the shared cache. This setting is per database. Defaults to the chunk size. an integer; default 0.     size maximum memory to allocate for the shared cache. Setting this will update the value if one is already set. an integer between 1MB and 10TB; default 500MB. ) statistics Maintain database statistics, which may impact performance. Choosing "all" maintains all statistics regardless of cost, "fast" maintains a subset of statistics that are relatively inexpensive, "none" turns off all statistics. The "clear" configuration resets statistics after they are gathered, where appropriate (for example, a cache size statistic is not cleared, while the count of cursor insert operations will be cleared). When "clear" is configured for the database, gathered statistics are reset each time a statistics cursor is used to gather statistics, as well as each time statistics are logged using the statistics_log configuration. See Statistics for more information. a list, with values chosen from the following options: "all", "fast", "none", "clear"; default none. statistics_log = ( log any statistics the database is configured to maintain, to a file. See Statistics for more information. a set of related configuration options defined below.     on_close log statistics on database close. a boolean flag; default false.     path the pathname to a file into which the log records are written, may contain ISO C standard strftime conversion specifications. If the value is not an absolute path name, the file is created relative to the database home. a string; default "WiredTigerStat.%d.%H".     sources if non-empty, include statistics for the list of data source URIs, if they are open at the time of the statistics logging. The list may include URIs matching a single data source ("table:mytable"), or a URI matching all data sources of a particular type ("table:"). a list of strings; default empty.     timestamp a timestamp prepended to each log record, may contain strftime conversion specifications. a string; default "%b %d %H:%M:%S".     wait seconds to wait between each write of the log records. an integer between 0 and 100000; default 0. ) transaction_sync = ( how to sync log records when the transaction commits. a set of related configuration options defined below.     enabled whether to sync the log on every commit by default, can be overridden by the sync setting to WT_SESSION::begin_transaction. a boolean flag; default false.     method the method used to ensure log records are stable on disk, see Commit-level durability for more information. a string, chosen from the following options: "dsync", "fsync", "none"; default fsync. ) use_environment_priv use the WIREDTIGER_CONFIG and WIREDTIGER_HOME environment variables regardless of whether or not the process is running with special privileges. See Database Home Directory for more information. a boolean flag; default false. verbose enable messages for various events. Only available if WiredTiger is configured with –enable-verbose. Options are given as a list, such as "verbose=[evictserver,read]". a list, with values chosen from the following options: "api", "block", "checkpoint", "compact", "evict", "evictserver", "fileops", "log", "lsm", "metadata", "mutex", "overflow", "read", "reconcile", "recovery", "salvage", "shared_cache", "split", "temporary", "transaction", "verify", "version", "write"; default empty. Additionally, if files named WiredTiger.config or WiredTiger.basecfg appear in the WiredTiger home directory, they are read for configuration values (see WiredTiger.config file and WiredTiger.basecfg file for details). See Configuration ordering for ordering of the configuration mechanisms.
[out]	connectionp	A pointer to the newly opened connection handle

Returns

zero on success and a non-zero error code on failure. See Error Returns for details.