Cassandra-alter-keyspace
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