はじめに
今年、2023年６月１日に、Cassandra Dayが日本でも開催されます。
Cassandra Dayは、昨年、ベルリン、ロンドン、アムステルダム、ハノイ、ジャカルタ、ヒューストン、サンタクララ、シアトル、シンガポールでも開催されました。
今回の東京での開催に向けて、Apache Cassandraに関する記事を発表していきます。
Apache Cassandraについて
Apache Cassandraとは、一言でいうなら、オープンソースの分散データベース管理システムです。
他の分散データベース管理システム同様、複数の汎用サーバーを用いて、ひとつのデータベースを構築します（開発などの目的のため、一つのサーバーのみで構成することも可能です）。
ここでは、詳しい説明は割愛し、興味のある方へのご紹介の役割は、公式サイトやWikipediaに譲ります。
Cassandra学習環境を準備する
コンテナテクノロジーの登場によって、分散アーキテクチャーを持つシステムを試験的に利用する環境の構築は、以前に比べて格段に容易になりました。
Apache Cassandraについて、Docker Official Imageが公開されています。
Dockerが利用可能になっている（インストールされ、起動されている）ことを前提として、Cassandraの利用方法を見ていきます。
※ここでは、M1 Mac(macOS Monterey 12.6.2)とDocker Desktop(4.17.0)を使った確認結果を紹介します。
コンソールから、以下のコマンドを入力します。
docker run -d --name my-cassandra cassandra
次のような出力が確認されるはずです。
% docker run -d --name my-cassandra cassandra
f83b7d143ba22bd3f95f9c447894f9aee1276366dea327e60c69474648db9657
この時点で、Docker Desktopでは、以下のような画面が確認できるでしょう。
起動状況をログで確認します。コンソール上で、以下のコマンドを入力します。
docker logs -f my-cassandra
すると、こんな感じの出力が確認できるはずです。
INFO [main] 2023-05-01 01:08:41,106 CassandraDaemon.java:769 - Startup complete
INFO [CompactionExecutor:1] 2023-05-01 01:08:41,120 CompactionTask.java:247 - Compacted (b5f16f00-e7bc-11ed-92d1-dd560259ddea) 6 sstables to [/var/lib/cassandra/data/system/local-7ad54392bcdd35a684174e047860b377/nb-7-big,] to level=0. 0.810KiB to 0.659KiB (~81% of original) in 39ms. Read Throughput = 20.432KiB/s, Write Throughput = 16.637KiB/s, Row Throughput = ~2/s. 6 total partitions merged to 1. Partition merge counts were {6:1, }. Time spent writing keys = 21ms
INFO [NonPeriodicTasks:1] 2023-05-01 01:08:41,121 SSTable.java:127 - Deleting sstable: /var/lib/cassandra/data/system/local-7ad54392bcdd35a684174e047860b377/nb-6-big
INFO [NonPeriodicTasks:1] 2023-05-01 01:08:41,122 SSTable.java:127 - Deleting sstable: /var/lib/cassandra/data/system/local-7ad54392bcdd35a684174e047860b377/nb-3-big
INFO [NonPeriodicTasks:1] 2023-05-01 01:08:41,123 SSTable.java:127 - Deleting sstable: /var/lib/cassandra/data/system/local-7ad54392bcdd35a684174e047860b377/nb-2-big
INFO [NonPeriodicTasks:1] 2023-05-01 01:08:41,124 SSTable.java:127 - Deleting sstable: /var/lib/cassandra/data/system/local-7ad54392bcdd35a684174e047860b377/nb-4-big
INFO [NonPeriodicTasks:1] 2023-05-01 01:08:41,124 SSTable.java:127 - Deleting sstable: /var/lib/cassandra/data/system/local-7ad54392bcdd35a684174e047860b377/nb-5-big
INFO [NonPeriodicTasks:1] 2023-05-01 01:08:41,125 SSTable.java:127 - Deleting sstable: /var/lib/cassandra/data/system/local-7ad54392bcdd35a684174e047860b377/nb-1-big
INFO [OptionalTasks:1] 2023-05-01 01:08:51,196 CassandraRoleManager.java:354 - Created default superuser role 'cassandra'
上記引用１行目のように、Startup completeという文言が出力されているのを確認します。
そしたら、次に以下のコマンドを実行します（その前に、Ctrl+Cを入力してログ出力を止めるか、別のコンソールを利用します）。
docker exec -it my-cassandra cqlsh
以下のような、コマンドプロンプトが出力されます。
% docker exec -it my-cassandra cqlsh
Connected to Test Cluster at 127.0.0.1:9042
[cqlsh 6.1.0 | Cassandra 4.1.0 | CQL spec 3.4.6 | Native protocol v5]
Use HELP for help.
cqlsh>
この段階で、データベースは初期状態ですが、次のコマンドでデフォルトの状態を確認してみます。
desc keyspaces
次のように、システム関連の出力が確認できます。
cqlsh> desc keyspaces
system system_distributed system_traces system_virtual_schema
system_auth system_schema system_views
cqlsh>
cqlshコマンドプロンプトから抜けるには、exitサブコマンドを実行します。
cqlsh> exit
%
最後に
これで、（本稿タイトルである）「Cassandra学習環境を準備する」ことができました。
（今回は説明抜きに手順のみ提示したCQLの利用方法など）さらに学習を進めるための情報、そして、そもそもApache Cassandraとはどんなデータベースなのか、あるいは、（今回は最も単純な形で環境を準備しましたが）より実践的な環境構築の方法など、今後、別の記事として発表していきたいと思います。