MySQL NDB Cluster API Developer Guide
Constants used in the ClusterJ project.
public interface Constants {
// Public Static Fieldspublic static final String DEFAULT_PROPERTY_CLUSTER_BYTE_BUFFER_POOL_SIZES = "256, 10240, 102400, 1048576";
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_BATCH_SIZE = 10;
public static final long DEFAULT_PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_START = 1L;
public static final long DEFAULT_PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_STEP = 1L;
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_DELAY = 5;
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_RETRIES = 4;
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_TIMEOUT_AFTER = 20;
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_TIMEOUT_BEFORE = 30;
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_TIMEOUT_MGM = 30000;
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_VERBOSE = 0;
public static final String DEFAULT_PROPERTY_CLUSTER_DATABASE = "test";
public static final int DEFAULT_PROPERTY_CLUSTER_MAX_CACHED_SESSIONS = 100;
public static final int DEFAULT_PROPERTY_CLUSTER_MAX_TRANSACTIONS = 4;
public static final String DEFAULT_PROPERTY_CLUSTER_MULTI_DB = "false";
public static final int DEFAULT_PROPERTY_CONNECTION_POOL_RECV_THREAD_ACTIVATION_THRESHOLD = 8;
public static final int DEFAULT_PROPERTY_CONNECTION_POOL_SIZE = 1;
public static final int DEFAULT_PROPERTY_CONNECTION_RECONNECT_TIMEOUT = 0;
public static final int DEFAULT_PROPERTY_MGM_STRICT_TLS = 0;
public static final int DEFAULT_PROPERTY_TABLE_WAIT_MSEC = 50;
public static final String DEFAULT_PROPERTY_TLS_SEARCH_PATH = "$HOME/ndb-tls";
public static final String ENV_CLUSTERJ_LOGGER_FACTORY_NAME = "CLUSTERJ_LOGGER_FACTORY";
public static final String PROPERTY_CLUSTER_BYTE_BUFFER_POOL_SIZES = "com.mysql.clusterj.byte.buffer.pool.sizes";
public static final String PROPERTY_CLUSTER_CONNECTION_SERVICE = "com.mysql.clusterj.connection.service";
public static final String PROPERTY_CLUSTER_CONNECTSTRING = "com.mysql.clusterj.connectstring";
public static final String PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_BATCH_SIZE = "com.mysql.clusterj.connect.autoincrement.batchsize";
public static final String PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_START = "com.mysql.clusterj.connect.autoincrement.offset";
public static final String PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_STEP = "com.mysql.clusterj.connect.autoincrement.increment";
public static final String PROPERTY_CLUSTER_CONNECT_DELAY = "com.mysql.clusterj.connect.delay";
public static final String PROPERTY_CLUSTER_CONNECT_RETRIES = "com.mysql.clusterj.connect.retries";
public static final String PROPERTY_CLUSTER_CONNECT_TIMEOUT_AFTER = "com.mysql.clusterj.connect.timeout.after";
public static final String PROPERTY_CLUSTER_CONNECT_TIMEOUT_BEFORE = "com.mysql.clusterj.connect.timeout.before";
public static final String PROPERTY_CLUSTER_CONNECT_TIMEOUT_MGM = "com.mysql.clusterj.connect.timeout.mgm";
public static final String PROPERTY_CLUSTER_CONNECT_VERBOSE = "com.mysql.clusterj.connect.verbose";
public static final String PROPERTY_CLUSTER_DATABASE = "com.mysql.clusterj.database";
public static final String PROPERTY_CLUSTER_MAX_CACHED_SESSIONS = "com.mysql.clusterj.max.cached.sessions";
public static final String PROPERTY_CLUSTER_MAX_TRANSACTIONS = "com.mysql.clusterj.max.transactions";
public static final String PROPERTY_CLUSTER_MULTI_DB = "com.mysql.clusterj.multi.database";
public static final String PROPERTY_CONNECTION_POOL_NODEIDS = "com.mysql.clusterj.connection.pool.nodeids";
public static final String PROPERTY_CONNECTION_POOL_RECV_THREAD_ACTIVATION_THRESHOLD = "com.mysql.clusterj.connection.pool.recv.thread.activation.threshold";
public static final String PROPERTY_CONNECTION_POOL_RECV_THREAD_CPUIDS = "com.mysql.clusterj.connection.pool.recv.thread.cpuids";
public static final String PROPERTY_CONNECTION_POOL_SIZE = "com.mysql.clusterj.connection.pool.size";
public static final String PROPERTY_CONNECTION_RECONNECT_TIMEOUT = "com.mysql.clusterj.connection.reconnect.timeout";
public static final String PROPERTY_DEFER_CHANGES = "com.mysql.clusterj.defer.changes";
public static final String PROPERTY_JDBC_DRIVER_NAME = "com.mysql.clusterj.jdbc.driver";
public static final String PROPERTY_JDBC_PASSWORD = "com.mysql.clusterj.jdbc.password";
public static final String PROPERTY_JDBC_URL = "com.mysql.clusterj.jdbc.url";
public static final String PROPERTY_JDBC_USERNAME = "com.mysql.clusterj.jdbc.username";
public static final String PROPERTY_MGM_STRICT_TLS = "com.mysql.clusterj.tls.strict";
public static final String PROPERTY_TABLE_WAIT_MSEC = "com.mysql.clusterj.table.wait.msec";
public static final String PROPERTY_TLS_SEARCH_PATH = "com.mysql.clusterj.tls.path";
public static final String SESSION_FACTORY_SERVICE_CLASS_NAME = "com.mysql.clusterj.SessionFactoryService";
public static final String SESSION_FACTORY_SERVICE_FILE_NAME = "META-INF/services/com.mysql.clusterj.SessionFactoryService";
}
public static final String DEFAULT_PROPERTY_CLUSTER_BYTE_BUFFER_POOL_SIZES = "256, 10240, 102400, 1048576";
The default value of the byte buffer pool sizes property: 256, 10K, 100K, 1M
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_BATCH_SIZE = 10;
The default value of the connection autoincrement batch size property
public static final long DEFAULT_PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_START = 1L;
The default value of the connection autoincrement start property
public static final long DEFAULT_PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_STEP = 1L;
The default value of the connection autoincrement step property
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_DELAY = 5;
The default value of the connection delay property
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_RETRIES = 4;
The default value of the connection retries property
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_TIMEOUT_AFTER = 20;
The default value of the connection timeout after property
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_TIMEOUT_BEFORE = 30;
The default value of the connection timeout before property
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_TIMEOUT_MGM = 30000;
The default value of the connection timeout mgm property
public static final int DEFAULT_PROPERTY_CLUSTER_CONNECT_VERBOSE = 0;
The default value of the connection verbose property
public static final String DEFAULT_PROPERTY_CLUSTER_DATABASE = "test";
The default value of the database property
public static final int DEFAULT_PROPERTY_CLUSTER_MAX_CACHED_SESSIONS = 100;
The default size of the global session cache.
public static final int DEFAULT_PROPERTY_CLUSTER_MAX_TRANSACTIONS = 4;
The default value of the maximum number of transactions property
public static final String DEFAULT_PROPERTY_CLUSTER_MULTI_DB = "false";
The default value of the MultiDB property
public static final int DEFAULT_PROPERTY_CONNECTION_POOL_RECV_THREAD_ACTIVATION_THRESHOLD = 8;
The default value of the receive thread activation threshold
public static final int DEFAULT_PROPERTY_CONNECTION_POOL_SIZE = 1;
The default value of the connection pool size property
public static final int DEFAULT_PROPERTY_CONNECTION_RECONNECT_TIMEOUT = 0;
7.5.7
The default value of the connection reconnect timeout property. The default means that the automatic reconnection due to network failures is disabled.
public static final int DEFAULT_PROPERTY_MGM_STRICT_TLS = 0;
The default value of the MGM TLS level property
public static final int DEFAULT_PROPERTY_TABLE_WAIT_MSEC = 50;
The default value of the table wait retry time property.
public static final String DEFAULT_PROPERTY_TLS_SEARCH_PATH = "$HOME/ndb-tls";
The default value of the TLS Search Path property.
public static final String ENV_CLUSTERJ_LOGGER_FACTORY_NAME = "CLUSTERJ_LOGGER_FACTORY";
The name of the environment variable to set the logger factory
public static final String PROPERTY_CLUSTER_BYTE_BUFFER_POOL_SIZES = "com.mysql.clusterj.byte.buffer.pool.sizes";
The name of the byte buffer pool sizes property. To disable buffer pooling for blob objects, set the value of this property to "1". With this setting, buffers will be allocated and freed (and cleaned if possible) immediately after being used for blob data transfer.
public static final String PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_BATCH_SIZE = "com.mysql.clusterj.connect.autoincrement.batchsize";
The name of the connection autoincrement batch size property.
public static final String PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_START = "com.mysql.clusterj.connect.autoincrement.offset";
The name of the connection autoincrement start property.
public static final String PROPERTY_CLUSTER_CONNECT_AUTO_INCREMENT_STEP = "com.mysql.clusterj.connect.autoincrement.increment";
The name of the connection autoincrement step property.
public static final String PROPERTY_CLUSTER_CONNECT_DELAY = "com.mysql.clusterj.connect.delay";
The name of the connection delay property. For details, see Ndb_cluster_connection::connect()
public static final String PROPERTY_CLUSTER_CONNECT_RETRIES = "com.mysql.clusterj.connect.retries";
The name of the connection retries property. For details, see Ndb_cluster_connection::connect()
public static final String PROPERTY_CLUSTER_CONNECT_TIMEOUT_AFTER = "com.mysql.clusterj.connect.timeout.after";
The name of the connection timeout after property. For details, see Ndb_cluster_connection::wait_until_ready()
public static final String PROPERTY_CLUSTER_CONNECT_TIMEOUT_BEFORE = "com.mysql.clusterj.connect.timeout.before";
The name of the connection timeout before property. For details, see Ndb_cluster_connection::wait_until_ready()
public static final String PROPERTY_CLUSTER_CONNECT_TIMEOUT_MGM = "com.mysql.clusterj.connect.timeout.mgm";
The name of the initial timeout for cluster connection to connect to MGM before connecting to data nodes Ndb_cluster_connection::set_timeout()
public static final String PROPERTY_CLUSTER_CONNECT_VERBOSE = "com.mysql.clusterj.connect.verbose";
The name of the connection verbose property. For details, see Ndb_cluster_connection::connect()
public static final String PROPERTY_CLUSTER_CONNECTION_SERVICE = "com.mysql.clusterj.connection.service";
The name of the connection service property
public static final String PROPERTY_CLUSTER_CONNECTSTRING = "com.mysql.clusterj.connectstring";
The name of the connection string property. For details, see Ndb_cluster_connection constructor
public static final String PROPERTY_CLUSTER_DATABASE = "com.mysql.clusterj.database";
The name of the database property. For details, see the catalogName parameter in the Ndb constructor. Ndb constructor
public static final String PROPERTY_CLUSTER_MAX_CACHED_SESSIONS = "com.mysql.clusterj.max.cached.sessions";
9.4.0
Each Cluster/J session uses an Ndb object that holds a connection record. Obtaining these objects requires a network round-trip between the Cluster/J application and an NDB data node. To eliminate that network overhead in getSession(), these Ndb objects can be cached. Each cached object, in addition to a small amount of memory used inside Cluster/J, also consumes about 1KB of memory on each data node. This SessionFactory property is used to determine the size and behavior of the cache. If set to zero, the session cache will not be enabled for this SessionFactory. If set to some value greater than zero, the session cache will be enabled, with its size limited to the value given. Users should generally not expect the cache in a SessionFactory to grow to this maximum size, but rather to remain roughly equal to the number of threads using the SessionFactory. The total size of all session caches will not exceed the largest size requested for any one SessionFactory.
public static final String PROPERTY_CLUSTER_MAX_TRANSACTIONS = "com.mysql.clusterj.max.transactions";
The name of the maximum number of transactions property. For details, see Ndb::init()
public static final String PROPERTY_CONNECTION_POOL_NODEIDS = "com.mysql.clusterj.connection.pool.nodeids";
The name of the connection pool node ids property. There is no default. This is the list of node ids to force the connections to be assigned to specific node ids. If this property is specified and connection pool size is not the default, the number of node ids of the list must match the connection pool size, or the number of node ids must be 1 and node ids will be assigned to connections starting with the specified node id.
public static final String PROPERTY_CONNECTION_POOL_RECV_THREAD_ACTIVATION_THRESHOLD = "com.mysql.clusterj.connection.pool.recv.thread.activation.threshold";
The receive thread activation threshold for all connections in the connection pool. The default is no activation threshold.
public static final String PROPERTY_CONNECTION_POOL_RECV_THREAD_CPUIDS = "com.mysql.clusterj.connection.pool.recv.thread.cpuids";
The cpu binding of the receive threads for the connections in the connection pool. The default is no cpu binding for receive threads. If this property is specified, the number of cpu ids in the list must be equal to : a) the connection pool size if the connection pooling is not disabled (i.e. connection pool size > 0) (or) b) 1 if the connection pooling is disabled.
public static final String PROPERTY_CONNECTION_POOL_SIZE = "com.mysql.clusterj.connection.pool.size";
The name of the connection pool size property. This is the number of connections to create in the connection pool. The default is 1 (all sessions share the same connection; all requests for a SessionFactory with the same connect string and database will share a single SessionFactory). A setting of 0 disables pooling; each request for a SessionFactory will receive its own unique SessionFactory.
public static final String PROPERTY_CONNECTION_RECONNECT_TIMEOUT = "com.mysql.clusterj.connection.reconnect.timeout";
7.5.7
The number of seconds to wait for all sessions to be closed when reconnecting a SessionFactory due to network failures. The default, 0, indicates that the automatic reconnection to the cluster due to network failures is disabled. Reconnection can be enabled by using the method SessionFactory.reconnect(int timeout) and specifying a new timeout value.
public static final String PROPERTY_DEFER_CHANGES = "com.mysql.clusterj.defer.changes";
The flag for deferred inserts, deletes, and updates
public static final String PROPERTY_JDBC_DRIVER_NAME = "com.mysql.clusterj.jdbc.driver";
The name of the jdbc driver
public static final String PROPERTY_JDBC_PASSWORD = "com.mysql.clusterj.jdbc.password";
The jdbc password
public static final String PROPERTY_JDBC_USERNAME = "com.mysql.clusterj.jdbc.username";
The jdbc username
public static final String PROPERTY_MGM_STRICT_TLS = "com.mysql.clusterj.tls.strict";
The name of the boolean strict MGM TLS property.
public static final String PROPERTY_TABLE_WAIT_MSEC = "com.mysql.clusterj.table.wait.msec";
9.4.0
The name of the table wait retry time property. The property denotes a value from 0 to 1000 milliseconds, and specifies the behavior whenever Cluster/J attempts to open a table and the table is not found. If non-zero, it will try again to open the table, waiting up to the configured maximum number of milliseconds. If set to 0, it will immediately give up, and throw ClusterJTableException.
public static final String PROPERTY_TLS_SEARCH_PATH = "com.mysql.clusterj.tls.path";
The name of the TLS Search Path property.