红帽全球峰会此内容没有您所选择的语言版本。
19.9. Cassandra Cache Store
Red Hat JBoss Data Grid allows Apache Cassandra to function as a Cache Store, leveraging their distributed database architecture to provide a virtually unlimited, horizontally scalable persistent store for cache entries.
In order to use the Cassandra Cache Store an appropriate keyspace must first be created on the Cassandra database. This may either be performed automatically or by enabling the
auto-create-keyspace parameter in the cache store configuration. A sample keyspace creation is demonstrated below:
CREATE KEYSPACE IF NOT EXISTS Infinispan WITH replication = {'class':'SimpleStrategy', 'replication_factor':1};
CREATE TABLE Infinispan.InfinispanEntries (key blob PRIMARY KEY, value blob, metadata blob);19.9.1. Enabling the Cassandra Cache Store
复制链接链接已复制到粘贴板!
The Cassandra Cache Store is included based on the downloaded distribution. The following indicates where this is located, and steps to enable it if required:
Library Mode- Theinfinispan-cachestore-cassandra-8.3.0.final-redhat-1-deployable.jaris included in thejboss-datagrid-${jdg-version}-library/directory, and may be added to any projects that are using the Cassandra Cache Store.Remote Client-Server Mode- The Cassandra Cache Store is prepackaged in themodules/directory of the server, and may be used by default with no additional configuration necessary.JBoss Data Grid modules for JBoss EAP- The Cassandra Cache Store is included in the modules distributed, and may be added by using theorg.infinispan.persistence.cassandraas the module name.
In Remote Client-Server mode the Cassandra Cache Store is defined by using the class
org.infinispan.persistence.cassandra.CassandraStore and defining the properties individually within the store.
The following configuration snippet provides an example on how to define a Cassandra Cache Store inside of an xml file:
<local-cache name="cassandracache" start="EAGER">
<locking acquire-timeout="30000" concurrency-level="1000" striping="false"/>
<transaction mode="NONE"/>
<store name="cassstore1"
class="org.infinispan.persistence.cassandra.CassandraStore"
shared="true"
passivation="false">
<property name="autoCreateKeyspace">true</property>
<property name="keyspace">store1</property>
<property name="entryTable">entries1</property>
<property name="consistencyLevel">LOCAL_ONE</property>
<property name="serialConsistencyLevel">SERIAL</property>
<property name="servers">127.0.0.1[9042],127.0.0.1[9041]</property>
<property name="connectionPool.heartbeatIntervalSeconds">30</property>
<property name="connectionPool.idleTimeoutSeconds">120</property>
<property name="connectionPool.poolTimeoutMillis">5</property>
</store>
</local-cache>
In Library Mode the Cassandra Cache Store may be configured using two different methods:
- Option 1: Using the same method discussed for Remote Client-Server Mode, found in Section 19.9.2, “Cassandra Cache Store Sample XML Configuration (Remote Client-Server Mode)”.
- Option 2: Using the
cassandra-storeschema. The following snippet shows an example configuration defining a Cassandra Cache Store:<cache-container default-cache="cassandracache"> <local-cache name="cassandracache"> <persistence passivation="false"> <cassandra-store xmlns="urn:infinispan:config:store:cassandra:8.2" auto-create-keyspace="true" keyspace="Infinispan" entry-table="InfinispanEntries" shared="true"> <cassandra-server host="127.0.0.1" port="9042" /> <connection-pool heartbeat-interval-seconds="30" idle-timeout-seconds="120" pool-timeout-millis="5" /> </cassandra-store> </persistence> </local-cache> </cache-container>
19.9.4. Cassandra Configuration Parameters
复制链接链接已复制到粘贴板!
When defining a backing Cassandra instance in Library Mode one or more Expand
cassandra-server elements may be specified in the configuration. Each of the elements has the following properties:
| Parameter Name | Description | Default Value |
|---|---|---|
host | The hostname or ip address of a Cassandra server. | 127.0.0.1 |
port | The port on which the server is listening. | 9042 |
The following properties may be configured on the Cassandra Cache Store:
Expand
| Parameter Name | Description | Default Value |
|---|---|---|
auto-create-keyspace | Determines whether the keyspace and entry table should be automatically created on startup. | true |
keyspace | Name of the keyspace to use. | Infinispan |
entry-table | Name of the table storing entries. | InfinispanEntries |
consistency-level | Consistency level to use for the queries. | LOCAL_ONE |
serial-consistency-level | Serial consistency level to use for the queries. | SERIAL |
A Expand
connection-pool may also be defined with the following elements:
| Parameter Name | Description | Default Value |
|---|---|---|
pool-timeout-millis | Time that the driver blocks when no connection from hosts pool is available. After this timeout, the driver will try the next host. | 5 |
heartbeat-interval-seconds | Application-side heartbeat to avoid the connections being dropped when no activity is happening. Set to 0 to disable. | 30 |
idle-timeout-seconds | Timeout before an idle connection is removed. | 120 |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}