Cassandra - 创建键空间


使用 Cqlsh 创建键空间

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

句法

CREATE KEYSPACE <identifier> WITH <properties>

IE

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

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

AND durable_writes = ‘Boolean value’;

CREATE KEYSPACE 语句有两个属性:replicationDurable_writes

复制

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

策略名称 描述
简单的策略' 为集群指定一个简单的复制因子。
网络拓扑策略 使用此选项,您可以独立设置每个数据中心的复制因子。
旧网络拓扑策略 这是传统的复制策略。

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

例子

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

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

  • 我们使用第一个副本放置策略,即Simple Strategy

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

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

确认

您可以使用命令Describe来验证该表是否已创建。如果您在键空间上使用此命令,它将显示创建的所有键空间,如下所示。

cqlsh> DESCRIBE keyspaces;

tutorialspoint system system_traces 

在这里您可以观察新创建的KeySpace教程点。

持久写入

默认情况下,表的 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。

使用键空间

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

Syntax:USE <identifier>

例子

在以下示例中,我们使用 KeySpace教程点。

cqlsh> USE tutorialspoint;
cqlsh:tutorialspoint>

使用 Java API 创建密钥空间

您可以使用Session类的execute()方法创建一个Keyspace 。按照下面给出的步骤使用 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 的 KeySpace。我们使用第一个副本放置策略,即简单策略,并且我们选择复制因子为 1 个副本。

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

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

第四步:使用KeySpace

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

execute(“ USE tp ” );

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

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

public class Create_KeySpace {

   public static void main(String args[]){

      //Query
      String query = "CREATE KEYSPACE tp WITH replication "
         + "= {'class':'SimpleStrategy', 'replication_factor':1};";
                    
      //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);
     
      //using the KeySpace
      session.execute("USE tp");
      System.out.println("Keyspace created"); 
   }
}

使用类名后跟 .java 保存上述程序,浏览到保存它的位置。编译并执行程序,如下所示。

$javac Create_KeySpace.java
$java Create_KeySpace

在正常情况下,它将产生以下输出 -

Keyspace created