Cassandra - 创建键空间

---

---

使用 cqlsh 创建键空间

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

语法

CREATE KEYSPACE <identifier> WITH <properties>

例如

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 语句有两个属性：replication 和 durable_writes。

复制

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

使用此选项，您可以指示 Cassandra 是否对当前 KeySpace 的更新使用commitlog。此选项不是必需的，默认情况下设置为 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 tutorialspoint。

Durable_writes

默认情况下，表的 durable_writes 属性设置为true，但可以设置为 false。您不能将此属性设置为simplex strategy。

示例

以下是演示 durable_writes 属性用法的示例。

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

验证

您可以通过查询 System Keyspace 来验证 test 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)

在这里您可以看到 test KeySpace 的 durable_writes 属性设置为 false。

使用键空间

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

Syntax:USE <identifier>

示例

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

cqlsh> USE tutorialspoint;
cqlsh:tutorialspoint>

使用 Java API 创建键空间

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

步骤 1：创建 Cluster 对象

首先，创建一个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" );

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

//Building a cluster
Cluster cluster = builder.build();

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

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

步骤 2：创建 Session 对象

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

Session session = cluster.connect( );

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

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

步骤 3：执行查询

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

在此示例中，我们创建一个名为tp的 KeySpace。我们使用第一个副本放置策略，即 Simple Strategy，并将复制因子选择为 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 中创建和使用键空间的完整程序。

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