Cassandra - 更改键空间


改变KeySpace

ALTER KEYSPACE 可用于更改 KeySpace 的属性,例如副本数和持久写入数。下面给出了该命令的语法。

句法

ALTER KEYSPACE <identifier> WITH <properties>

IE

ALTER KEYSPACE “KeySpace Name”
WITH replication = {'class': ‘Strategy name’, 'replication_factor' : ‘No.Of  replicas’};

ALTER KEYSPACE的属性与 CREATE KEYSPACE 相同。它有两个属性:replicationDurable_writes

复制

复制选项指定副本放置策略和所需副本的数量。

持久写入

使用此选项,您可以指示 Cassandra 是否使用 commitlog 来更新当前 KeySpace。此选项不是强制性的,默认情况下,它设置为 true。

例子

下面给出了更改 KeySpace 的示例。

  • 在这里,我们正在更改名为TutorialsPoint的 KeySpace 。

  • 我们将复制因子从 1 更改为 3。

cqlsh.> ALTER KEYSPACE tutorialspoint
WITH replication = {'class':'NetworkTopologyStrategy', 'replication_factor' : 3};

改变 Durable_writes

您还可以更改 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)

使用 Java API 更改键空间

您可以使用Session类的execute()方法更改键空间。按照下面给出的步骤使用 Java API 更改键空间

Step1:创建集群对象

首先,创建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();

第 2 步:创建会话对象

使用Cluster类的connect()方法创建Session对象的实例,如下所示。

Session session = cluster.connect( );

此方法创建一个新会话并对其进行初始化。如果您已经有一个键空间,则可以通过将字符串格式的键空间名称传递给此方法来将其设置为现有的键空间,如下所示。

Session session = cluster.connect(“ Your keyspace name ” );

第3步:执行查询

您可以使用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