Cassandra-キースペースの変更

キースペースの変更

ALTER KEYSPACEを使用して、レプリカの数やKeySpaceのpermanent_writesなどのプロパティを変更できます。以下に、このコマンドの構文を示します。

構文

ALTER KEYSPACE <identifier> WITH <properties>

i.e.

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

*ALTER KEYSPACE* のプロパティはCREATE KEYSPACEと同じです。 *replication* と *durable_writes* の2つのプロパティがあります。

複製

複製オプションは、レプリカ配置戦略と必要なレプリカの数を指定します。

Durable_writes

このオプションを使用すると、現在のKeySpaceの更新にcommitlogを使用するかどうかをCassandraに指示できます。このオプションは必須ではなく、デフォルトではtrueに設定されています。

例

以下は、KeySpaceを変更する例です。

ここでは、 finddevguides という名前のKeySpaceを変更しています。
複製係数を1から3に変更しています。

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

Durable_writesの変更

KeySpaceのpermanent_writesプロパティを変更することもできます。以下に示すのは、 test KeySpaceのpermanent_writesプロパティです。

SELECT *FROM system.schema_keyspaces;

  keyspace_name | durable_writes |                                       strategy_class | strategy_options
----------------+----------------+------------------------------------------------------+----------------------------
           test |          False | org.apache.cassandra.locator.NetworkTopologyStrategy | {"datacenter1":"3"}

 finddevguides |           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;

ここでも、KeySpacesのプロパティを確認すると、次の出力が生成されます。

SELECT* FROM system.schema_keyspaces;
  keyspace_name | durable_writes |                                       strategy_class | strategy_options
----------------+----------------+------------------------------------------------------+----------------------------
           test |           True | org.apache.cassandra.locator.NetworkTopologyStrategy | {"datacenter1":"3"}

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

Java APIを使用してキースペースを変更する

*Session* クラスの* execute（）*メソッドを使用してキースペースを変更できます。 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();

以下に示すように、1行のコードを使用してクラスターオブジェクトを構築できます。

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 という名前のキースペースを変更しています。レプリケーションオプションを単純戦略からネットワークトポロジ戦略に変更しています。
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でキースペースを作成および使用するための完全なプログラムです。

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

Cassandra-alter-keyspace