Cassandra 简明教程

Cassandra - Alter Keyspace

Altering a KeySpace

ALTER KEYSPACE 可用于更改诸如 KeySpace 的副本数和 durable_writes 等属性。以下是此命令的语法。

Syntax

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 在当前 KeySpace 上的更新中是否使用提交日志。此选项不是必需的，默认情况下将其设置为 true。

Example

下面是一个更改 KeySpace 的示例。

此处我们正在更改一个名为 TutorialsPoint 的 KeySpace。
我们正在将复制因子从 1 更改为 3。

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

Altering Durable_writes

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

同样，如果您验证 KeySpace 的属性，它将产生以下输出。

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)

Altering a Keyspace using Java API

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

Step1: Create a Cluster Object

首先，像下面显示的那样创建 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();

Step 2: Create a Session Object

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

Session session = cluster.connect( );

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

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

Step 3: Execute Query

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

在此示例中，

我们正在更改一个名为 tp 的键空间。我们正在将复制选项从 Simple Strategy 更改为 Network Topology Strategy。
我们正在将 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 中创建和使用 keyspace 的完整程序。

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