ALTER KEYSPACE可用于更改属性,例如,一个KeySpace的replicas和durable_writes的数量。下面给出了此命令的语法。
ALTER KEYSPACE <identifier> WITH <properties>
即:
ALTER KEYSPACE “KeySpace Name” WITH replication = {'class': ‘Strategy name’, 'replication_factor' : ‘No.Of replicas’};
ALTER KEYSPACE的属性与CREATE KEYSPACE相同。它有两个属性:replication和durable_writes。
使用此选项,您可以指示Cassandra是否对当前KeySpace的更新使用commitlog。此选项不是强制性的,默认情况下,它设置为true。
下面给出一个修改KeySpace的例子。
这里我们改变一个名为TutorialsPoint的KeySpace。
我们将复制因子从1更改为3。
cqlsh.> ALTER KEYSPACE tutorialspoint WITH replication = {'class':'NetworkTopologyStrategy', 'replication_factor' : 3};
您还可以修改KeySpace的durable_writes属性。下面给出测试KeySpace的durable_writes属性。
SELECT * FROM system.schema_keyspaces; keyspace_name | durable_writes | strategy_class | strategy_options ----------------+----------------+------------------------------------------------------+---------------------------- test | False | org.apache.cassandra.locator.NetworkTopologyStrategy | {"datacenter1":"3"} tutorialspoint | True | org.apache.cassandra.locator.SimpleStrategy | {"replication_factor":"4"} system | True | org.apache.cassandra.locator.LocalStrategy | { } system_traces | True | org.apache.cassandra.locator.SimpleStrategy | {"replication_factor":"2"} (4 rows)
ALTER KEYSPACE test WITH REPLICATION = {'class' : 'NetworkTopologyStrategy', 'datacenter1' : 3} AND DURABLE_WRITES = true;
再次,如果您验证KeySpaces的属性,它将产生以下输出。
SELECT * FROM system.schema_keyspaces; keyspace_name | durable_writes | strategy_class | strategy_options ----------------+----------------+------------------------------------------------------+---------------------------- test | True | org.apache.cassandra.locator.NetworkTopologyStrategy | {"datacenter1":"3"} tutorialspoint | True | org.apache.cassandra.locator.SimpleStrategy | {"replication_factor":"4"} system | True | org.apache.cassandra.locator.LocalStrategy | { } system_traces | True | org.apache.cassandra.locator.SimpleStrategy | {"replication_factor":"2"} (4 rows)
您可以使用Session类的execute()方法来更改键空间。按照以下步骤使用Java API更改键空间
首先,创建一个名为com.datastax.driver.core的Cluster.builder类的实例,如下所示。
//Creating Cluster.Builder object Cluster.Builder builder1 = Cluster.builder();
使用Cluster.Builder对象的addContactPoint()方法添加联系点(节点的IP地址)。此方法返回Cluster.Builder。
//Adding contact point to the Cluster.Builder object Cluster.Builder builder2 = build.addContactPoint( "127.0.0.1" );
使用新的构建器对象,创建一个集群对象。为此,在Cluster.Builder类中有一个名为build()的方法。以下代码显示如何创建集群对象。
//Building a cluster Cluster cluster = builder.build();
您可以使用单行代码构建集群对象,如下所示。
Cluster cluster = Cluster.builder().addContactPoint("127.0.0.1").build();
使用Clusterclass的connect()方法创建一个Session对象的实例,如下所示。
Session session = cluster.connect( );
此方法创建一个新会话并初始化它。如果已经有一个键空间,可以通过将字符串格式的键空间名称传递给这个方法来将其设置为现有键空间,如下所示。
Session session = cluster.connect(“ Your keyspace name ” );
您可以使用Session类的execute()方法执行CQL查询。将查询以字符串格式或Statement类对象传递给execute()方法。无论您以字符串格式传递给此方法将在cqlsh上执行。
在这个例子中,
我们正在改变一个名为tp的键空间。我们正在将复制选项从简单策略更改为网络拓扑策略。
我们正在将durable_writes更改为false
您必须将查询存储在字符串变量中,并将其传递给execute()方法,如下所示。
//Query String query = "ALTER KEYSPACE tp WITH replication " + "= {'class':'NetworkTopologyStrategy', 'datacenter1':3}" +" AND DURABLE_WRITES = false;"; session.execute(query);
下面给出了使用Java API在Cassandra中创建和使用键空间的完整程序。
import com.datastax.driver.core.Cluster; import com.datastax.driver.core.Session; public class Alter_KeySpace { public static void main(String args[]){ //Query String query = "ALTER KEYSPACE tp WITH replication " + "= {'class':'NetworkTopologyStrategy', 'datacenter1':3}" + "AND DURABLE_WRITES = false;"; //Creating Cluster object Cluster cluster = Cluster.builder().addContactPoint("127.0.0.1").build(); //Creating Session object Session session = cluster.connect(); //Executing the query session.execute(query); System.out.println("Keyspace altered"); } }
使用类名称和.java保存上述程序,浏览到保存位置。编译并执行程序如下图所示。
$javac Alter_KeySpace.java $java Alter_KeySpace
在正常条件下,它产生以下输出:
Keyspace Altered