Cassandra - 创建 Keyspace

使用 Cqlsh 创建 Keyspace

Cassandra 中的密钥空间是定义节点上数据复制的命名空间。集群每个节点包含一个密钥空间。下面给出了使用语句 CREATE KEYSPACE 创建 Keyspace 的语法。

语法

CREATE KEYSPACE <identifier> WITH <properties>

即

CREATE KEYSPACE "密钥空间名称"
WITH replication = {'class': '策略名称', 'replication_factor' : '副本数'};

CREATE KEYSPACE "KeySpace Name"
WITH replication = {'class': '策略名称', 'replication_factor' : '副本数'}

AND durable_writes = '布尔值';

CREATE KEYSPACE 语句有两个属性：replication 和 durable_writes。

Replication

replication 选项用于指定副本放置策略和所需的副本数。下表列出了所有副本放置策略。

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

示例

下面给出了创建 KeySpace 的示例。

• 这里我们创建一个名为 TutorialsPoint 的 KeySpace。

• 我们使用第一个副本放置策略，即 简单策略。

• 我们选择复制因子为 1 个副本。

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

验证

您可以使用命令 Describe 验证表是否已创建。如果您在Keyspace上使用此命令，它将显示所有创建的Keyspace，如下所示。

cqlsh> DESCRIBE keyspaces;

tutorialspoint system system_traces

在这里您可以观察新创建的 KeySpace tutorialspoint。

Durable_writes

默认情况下，表的 durable_writes 属性设置为 true，但可以将其设置为 false。您不能将此属性设置为单纯形策略

示例

下面给出了演示持久写入属性用法的示例。

cqlsh> CREATE KEYSPACE test
... WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'datacenter1' : 3 }
... AND DURABLE_WRITES = false;

验证

您可以通过查询系统Keyspace来验证测试Keyspace的 durable_writes 属性是否设置为 false。此查询为您提供所有Keyspace及其属性。

cqlsh> 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)

在这里您可以观察到测试 KeySpace 的 durable_writes 属性被设置为 false。

使用 Keyspace

您可以使用关键字 USE 使用创建的 KeySpace。其语法如下 −

语法：USE <identifier>

示例

在下面的示例中，我们使用 KeySpace tutorialspoint。

cqlsh> USE tutorialspoint;
cqlsh:tutorialspoint>

使用 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。我们使用第一个副本放置策略，即简单策略，并且我们选择复制因子为 1 个副本。

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

String query = "CREATE KEYSPACE tp WITH replication "
+ "= {'class':'SimpleStrategy', 'replication_factor':1}; ";
session.execute(query);

步骤 4：使用 KeySpace

您可以使用 execute() 方法使用创建的 KeySpace，如下所示。

execute(" USE tp " );

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

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

public class Create_KeySpace {

   public static void main(String args[]){

        //查询
        String query = "CREATE KEYSPACE tp WITH replication "
        + "= {'class':'SimpleStrategy', 'replication_factor':1};";
        
        //创建 Cluster 对象
        Cluster cluster = Cluster.builder().addContactPoint("127.0.0.1").build();
        
        //创建 Session 对象
        Session session = cluster.connect();
        
        //执行查询
        session.execute(query);
        
        //使用 KeySpace
      	session.execute("USE tp");
      	System.out.println("Keyspace created"); 
   }
}

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

$javac Create_KeySpace.java
$java Create_KeySpace

Under normal conditions, it will produce the following output −

Keyspace created