Cassandra でテーブルを表示する: CQL でテーブル一覧を取得する方法

Apache Cassandra は、単一障害点なしに多数の汎用サーバーにまたがって大量のデータを扱えるよう設計された分散型 NoSQL データベースです。Cassandra を使い始める際の最初のステップの一つが、キースペース内のテーブル一覧を確認することです。このチュートリアルでは、CQL (Cassandra Query Language) を使って Cassandra のテーブルを表示する方法を解説します。

前提条件

始める前に、以下を用意してください:

• Apache Cassandra がインストールされ、起動していること。
• CQL コマンドを実行するための cqlsh (Cassandra Query Language Shell) が利用できること。

cqlsh で Cassandra に接続する

まず cqlsh シェルを起動します。ターミナルを開いて次のように入力してください:

cqlsh

Cassandra に接続したことを示すプロンプトが表示されます:

Connected to Test Cluster at 127.0.0.1:9042.
[cqlsh 6.0.0 | Cassandra 4.0.0 | CQL spec 3.4.5 | Native protocol v4]
Use HELP for help.
cqlsh>

キースペースの一覧を表示する

テーブルを一覧表示する前に、どのキースペースが存在するかを把握しておくと便利です。キースペースは、リレーショナルデータベースにおけるデータベースに相当するものです。すべてのキースペースを一覧表示するには、次のコマンドを使います:

DESCRIBE KEYSPACES;

出力は次のようになります (実際のキースペースは環境によって異なります):

system
system_auth
system_distributed
system_schema
system_traces
my_keyspace

目的のキースペースに切り替える

一覧表示したいテーブルを含むキースペースに切り替える必要があります。この例では、my_keyspace という名前のキースペースがあるものとします。次のコマンドで切り替えます:

USE my_keyspace;

キースペース内のテーブルを一覧表示する

現在のキースペース内のすべてのテーブルを表示するには、次のコマンドを使います:

DESCRIBE TABLES;

このコマンドはキースペース内のすべてのテーブルを一覧表示します。出力例は次のとおりです:

users
products
orders

テーブルの詳細情報

スキーマなど特定のテーブルの詳細情報を取得するには、DESCRIBE コマンドに続けてテーブル名を指定します:

DESCRIBE TABLE users;

出力は次のようになります:

CREATE TABLE my_keyspace.users (
    user_id uuid PRIMARY KEY,
    first_name text,
    last_name text,
    email text
) WITH ...

この出力には、テーブルを作成するための完全な CQL コマンドとそのプロパティが含まれています。

まとめ

Apache Cassandra でテーブルを一覧表示するのは簡単です。このガイドに従えば、CQL コマンドを使ってキースペースをすばやく移動し、テーブル情報を取得できます。この基礎知識は、Cassandra に保存されたデータを管理・操作するうえで欠かせません。快適なクエリライフを！