15.3.2. JdbcMixedStore Configuration (Library Mode)

Procedure 15.9. Configure JdbcMixedStore in Library Mode

1. The mixedKeyedJdbcStore Element

   The mixedKeyedJdbcStore element uses the following parameters to configure the cache store:
   1. The fetchPersistentState parameter determines whether the persistent state is fetched when joining a cluster. Set this to true if using a replication and invalidation in a clustered environment. Additionally, if multiple cache stores are chained, only one cache store can have this property enabled. If a shared cache store is used, the cache does not allow a persistent state transfer despite this property being set to true. The fetchPersistentState parameter is false by default.
   2. The ignoreModifications parameter determines whether operations that modify the cache (for example put, remove, clear, store, etc.) do not affect the cache store. As a result, the cache store can become out of sync with the cache.
   3. The purgeOnStartup parameter specifies whether the cache is purged when initially started.
   4. The key2StringMapper parameter specifies the class name of the Key2StringMapper used to map keys to strings for the database tables.

   <infinispan
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="urn:infinispan:config:6.0 http://www.infinispan.org/schemas/infinispan-config-6.0.xsd
               urn:infinispan:config:jdbc:6.0 http://www.infinispan.org/schemas/infinispan-cachestore-jdbc-config-6.0.xsd"
           xmlns="urn:infinispan:config:6.0">
           ...
   <persistence>
   	<mixedKeyedJdbcStore xmlns="urn:infinispan:config:jdbc:6.0"
   	                      fetchPersistentState="false"
   			      ignoreModifications="false" 
   			      purgeOnStartup="false"
   			      key2StringMapper="org.infinispan.persistence.keymappers.DefaultTwoWayKey2StringMapper">
   

   Copy to Clipboard Toggle word wrap

2. The binaryKeyedTable and stringKeyedTable Elements

   The binaryKeyedTable and the stringKeyedTable element defines the table that stores cache entries. Each uses the following parameters to configure the cache store:
   1. The dropOnExit parameter specifies whether the database tables are dropped upon shutdown.
   2. The createOnStart parameter specifies whether the database tables are created by the store on startup.
   3. The prefix parameter defines the string prepended to name of the target cache when composing the name of the cache bucket table.

   <infinispan
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="urn:infinispan:config:6.0 http://www.infinispan.org/schemas/infinispan-config-6.0.xsd
               urn:infinispan:config:jdbc:6.0 http://www.infinispan.org/schemas/infinispan-cachestore-jdbc-config-6.0.xsd"
           xmlns="urn:infinispan:config:6.0">
           ...
   <persistence>
   	<mixedKeyedJdbcStore xmlns="urn:infinispan:config:jdbc:6.0"
   	                      fetchPersistentState="false"
   			      ignoreModifications="false" 
   			      purgeOnStartup="false"
   			      key2StringMapper="org.infinispan.persistence.keymappers.DefaultTwoWayKey2StringMapper">
   		<connectionPool connectionUrl="jdbc:h2:mem:infinispan_binary_based;DB_CLOSE_DELAY=-1" 
   				username="sa" 
   				driverClass="org.h2.Driver"/>
   		<binaryKeyedTable dropOnExit="true" 
   				  createOnStart="true" 
   				  prefix="ISPN_BUCKET_TABLE_BINARY">
   

   Copy to Clipboard Toggle word wrap

3. The idColumn Element

   The idColumn element defines the column where the cache key or bucket ID is stored. It uses the following parameters:
   1. Use the name parameter to specify the name of the column used.
   2. Use the type parameter to specify the type of the column used.

   <infinispan
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="urn:infinispan:config:6.0 http://www.infinispan.org/schemas/infinispan-config-6.0.xsd
               urn:infinispan:config:jdbc:6.0 http://www.infinispan.org/schemas/infinispan-cachestore-jdbc-config-6.0.xsd"
           xmlns="urn:infinispan:config:6.0">
           ...
   			<persistence>
   	<mixedKeyedJdbcStore xmlns="urn:infinispan:config:jdbc:6.0"
   	                      fetchPersistentState="false"
   			      ignoreModifications="false" 
   			      purgeOnStartup="false"
   			      key2StringMapper="org.infinispan.persistence.keymappers.DefaultTwoWayKey2StringMapper">
   		<connectionPool connectionUrl="jdbc:h2:mem:infinispan_binary_based;DB_CLOSE_DELAY=-1" 
   				username="sa" 
   				driverClass="org.h2.Driver"/>
   		<binaryKeyedTable dropOnExit="true" 
   				  createOnStart="true" 
   				  prefix="ISPN_BUCKET_TABLE_BINARY">
   			<idColumn name="ID_COLUMN" 
   				  type="VARCHAR(255)" />
   

   Copy to Clipboard Toggle word wrap

4. The dataColumn Element

   The dataColumn element specifies the column where the cache entry or bucket is stored.
   1. Use the name parameter to specify the name of the column used.
   2. Use the type parameter to specify the type of the column used.

   <infinispan
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="urn:infinispan:config:6.0 http://www.infinispan.org/schemas/infinispan-config-6.0.xsd
               urn:infinispan:config:jdbc:6.0 http://www.infinispan.org/schemas/infinispan-cachestore-jdbc-config-6.0.xsd"
           xmlns="urn:infinispan:config:6.0">
           ...
   <persistence>
   	<mixedKeyedJdbcStore xmlns="urn:infinispan:config:jdbc:6.0"
   	                      fetchPersistentState="false"
   			      ignoreModifications="false" 
   			      purgeOnStartup="false"
   			      key2StringMapper="org.infinispan.persistence.keymappers.DefaultTwoWayKey2StringMapper">
   		<connectionPool connectionUrl="jdbc:h2:mem:infinispan_binary_based;DB_CLOSE_DELAY=-1" 
   				username="sa" 
   				driverClass="org.h2.Driver"/>
   		<binaryKeyedTable dropOnExit="true" 
   				  createOnStart="true" 
   				  prefix="ISPN_BUCKET_TABLE_BINARY">
   			<idColumn name="ID_COLUMN" 
   				  type="VARCHAR(255)" />
   			<dataColumn name="DATA_COLUMN" 
   				    type="BINARY" />
   

   Copy to Clipboard Toggle word wrap

5. The timestampColumn Element

   The timestampColumn element specifies the column where the time stamp of the cache entry or bucket is stored.
   1. Use the name parameter to specify the name of the column used.
   2. Use the type parameter to specify the type of the column used.

   <infinispan
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="urn:infinispan:config:6.0 http://www.infinispan.org/schemas/infinispan-config-6.0.xsd
               urn:infinispan:config:jdbc:6.0 http://www.infinispan.org/schemas/infinispan-cachestore-jdbc-config-6.0.xsd"
           xmlns="urn:infinispan:config:6.0">
           ...
   <persistence>
   	<mixedKeyedJdbcStore xmlns="urn:infinispan:config:jdbc:6.0"
   	                      fetchPersistentState="false"
   			      ignoreModifications="false" 
   			      purgeOnStartup="false"
   			      key2StringMapper="org.infinispan.persistence.keymappers.DefaultTwoWayKey2StringMapper">
   		<connectionPool connectionUrl="jdbc:h2:mem:infinispan_binary_based;DB_CLOSE_DELAY=-1" 
   				username="sa" 
   				driverClass="org.h2.Driver"/>
   		<binaryKeyedTable dropOnExit="true" 
   				  createOnStart="true" 
   				  prefix="ISPN_BUCKET_TABLE_BINARY">
   			<idColumn name="ID_COLUMN" 
   				  type="VARCHAR(255)" />
   			<dataColumn name="DATA_COLUMN" 
   				    type="BINARY" />
   			<timestampColumn name="TIMESTAMP_COLUMN" 
   					 type="BIGINT" />
   		</binaryKeyedTable>
   

   Copy to Clipboard Toggle word wrap

6. The string-keyed-table Element

   The string-keyed-table element specifies information about the database table used to store string based cache entries.
   1. The prefix parameter specifies a prefix string for the database table name.

   <infinispan
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="urn:infinispan:config:6.0 http://www.infinispan.org/schemas/infinispan-config-6.0.xsd
               urn:infinispan:config:jdbc:6.0 http://www.infinispan.org/schemas/infinispan-cachestore-jdbc-config-6.0.xsd"
           xmlns="urn:infinispan:config:6.0">
           ...
   <persistence>
   	<mixedKeyedJdbcStore xmlns="urn:infinispan:config:jdbc:6.0"
                             fetchPersistentState="false"
   			      ignoreModifications="false" 
   			      purgeOnStartup="false"
   			      key2StringMapper="org.infinispan.persistence.keymappers.DefaultTwoWayKey2StringMapper">
   		<connectionPool connectionUrl="jdbc:h2:mem:infinispan_binary_based;DB_CLOSE_DELAY=-1" 
   				username="sa" 
   				driverClass="org.h2.Driver"/>
   		<binaryKeyedTable dropOnExit="true" 
   				  createOnStart="true" 
   				  prefix="ISPN_BUCKET_TABLE_BINARY">
   			<idColumn name="ID_COLUMN" 
   				  type="VARCHAR(255)" />
   			<dataColumn name="DATA_COLUMN" 
   				    type="BINARY" />
   			<timestampColumn name="TIMESTAMP_COLUMN" 
   					 type="BIGINT" />
   		</binaryKeyedTable>
   		<stringKeyedTable dropOnExit="true" 
   				  createOnStart="true" 
   				  prefix="ISPN_BUCKET_TABLE_STRING">
   			<idColumn name="ID_COLUMN" 
   				  type="VARCHAR(255)" />
   			<dataColumn name="DATA_COLUMN" 
   				    type="BINARY" />
   			<timestampColumn name="TIMESTAMP_COLUMN" 
   					 type="BIGINT" />
   		</stringKeyedTable>
   	</mixedKeyedJdbcStore>
   </persistence>
   

   Copy to Clipboard Toggle word wrap