Cassandra - 修改 Keyspace

Alter Keyspace

ALTER KEYSPACE 可用于Alter Keyspace 的副本数和 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。

Replication

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

Durable_writes

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

示例

下面给出了Alter Keyspace 的示例。

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

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

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

更改 Durable_writes

您还可以Alter Keyspace 的 durable_writes 属性。下面给出了 test 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 更改Keyspace

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

步骤 1：创建 Cluster 对象

首先，创建 com.datastax.driver.core 包的 Cluster.builder 类的实例，如下所示。

//创建 Cluster.Builder 对象
Cluster.Builder builder1 = Cluster.builder();

使用 Cluster.Builder 对象的 addContactPoint() 方法添加联系点（节点的 IP 地址）。此方法返回 Cluster.Builder。

//将联系点添加到 Cluster.Builder 对象
Cluster.Builder builder2 = build.addContactPoint( "127.0.0.1" );

使用新的构建器对象创建一个集群对象。为此，您在 Cluster.Builder 类中有一个名为 build() 的方法。以下代码显示如何创建集群对象。

//构建集群

Cluster cluster = builder.build();

您可以使用一行代码构建集群对象，如下所示。

Cluster cluster = Cluster.builder().addContactPoint("127.0.0.1").build();

步骤 2：创建 Session 对象

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

Session session = cluster.connect( );

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

Session session = cluster.connect(" 您的Keyspace名称 " );

步骤 3：执行查询

您可以使用 Session 类的 execute() 方法执行 CQL 查询。将查询以字符串格式或 Statement 类对象的形式传递给 execute() 方法。以字符串格式传递给此方法的任何内容都将在 cqlsh 上执行。

在此示例中，

• 我们正在更改名为 tp 的Keyspace。我们正在将复制选项从简单策略更改为网络拓扑策略。

• 我们正在将 durable_writes 更改为 false

您必须将查询存储在字符串变量中并将其传递给 execute() 方法，如下所示。

//查询
String query = "ALTER KEYSPACE tp WITH replication " + "= {'class':'NetworkTopologyStrategy', 'datacenter1':3}" +" AND DURABLE_WRITES = false;";
session.execute(query);

下面给出了使用 Java API 在 Cassandra 中创建和使用Keyspace的完整程序。

import com.datastax.driver.core.Cluster;
import com.datastax.driver.core.Session;

public class Alter_KeySpace {
   public static void main(String args[]){

        //查询
        String query = "ALTER KEYSPACE tp WITH replication " + "= {'class':'NetworkTopologyStrategy', 'datacenter1':3}"
        + "AND DURABLE_WRITES = false;";
        
        //创建 Cluster 对象
        Cluster cluster = Cluster.builder().addContactPoint("127.0.0.1").build();
        
        //创建 Session 对象
        Session session = cluster.connect();
        
        //执行查询
      	session.execute(query);
 
      	System.out.println("Keyspace altered");
   }
}

将上述程序以类名后跟 .java 的形式保存，浏览到保存位置。编译并执行该程序，如下所示。

$javac Alter_KeySpace.java
$java Alter_KeySpace

在正常情况下，它会产生以下输出 −

Keyspace Altered