> Apache Cassandra中文手册 > Cassandra 创建键空间

使用Cqlsh创建一个Keyspace

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。

复制

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

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

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

示例

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

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

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

  • 我们选择复制因子为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策略

示例

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

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

验证

您可以通过查询系统键空间来验证test KeySpace的durable_writes属性是否设置为false。此查询提供了所有KeySpaces及其属性。

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。其语法如下:

Syntax:USE <identifier>

示例

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

cqlsh> USE tutorialspoint;
cqlsh:tutorialspoint>

使用Java API创建一个Keyspace

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

第1步:创建一个集群对象

首先,创建一个名为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