本文へスキップ

Cassandra・ScyllaDB クライアント

Cassandra、ScyllaDB、Amazon Keyspaces でキースペースを参照し、CQL を実行し、主キーで行を編集できます。

概要

クエリ言語
CQL
ドライバー
初回使用時にダウンロードScyllaDB と共有
接続方法
ホストとポート, SSH トンネル, SSL/TLS, AWS IAM
既定のポート
9042
最低バージョン
3.0
Cassandra に接続した Mac の TablePro。CQL クエリとその結果を表示しています。

接続

接続先、ポート、必要な認証情報を入力してキースペースを選ぶか、パスにキースペースを含む cassandra://・cql:// URL をインポートします。切り替えても開いているタブは元のキースペースを維持します。新しい接続では TLS は無効です。ドライバーに日和見 TLS がないため、Preferred と Required は証明書を検証せずに暗号化します。Verify CA と Verify Identity は CA 証明書ファイルが必須で、システムのルート証明書には戻りません。相互 TLS では、クライアント証明書、その鍵、鍵のパスフレーズを追加します。

Amazon Keyspaces はパスワードではなく SigV4 でログインします。ポート 9142 の cassandra.us-east-1.amazonaws.com など地域エンドポイントを指定し、AWS IAM 方式 (英語)を選び、ユーザー名とパスワードは空欄のまま TLS を有効にします。

閲覧と CQL 実行

グリッドはコレクション、ユーザー定義型、期間、ベクトル、blob を表示します。エディターの結果は読み取り専用なので、行の編集はサイドバーから開いたテーブルで行います。CQL に OFFSET はないため、ページは最初の行から前方向に読み、遠いページへのジャンプはそれ以前のページをすべて読みます。行はトークン順に届き、列ヘッダーでは並べ替えません。Count Exactly は SELECT COUNT(*) を実行し、すべてのパーティションを読みます。

フィルターは ALLOW FILTERING を付けるため、パーティションキー全体を指定しなければサーバーは全パーティションを読みます。含む、前方一致、後方一致には SASI または SAI インデックスが必要で、CQL に OR がないため条件は AND でのみ結合します。編集内容は CQL 型として検証し、完全な主キーで書き込みます。Add Row は INSERT … IF NOT EXISTS を使い、キーの変更は行を削除して再挿入します。カウンター列はエディターで UPDATE … SET c = c + 1 を使います。

キースペースとテーブル

Structure タブは各列の CQL 型を示し、パーティション列とクラスタリング列を主キーとして表示し、セカンダリインデックスを示します。列の追加と削除に対応し、それ以外の変更は CQL 文で行います。DDL タブは列から CREATE TABLE を再構築し、compaction やクラスタリング順序は含まないため、完全な定義は cqlsh の DESCRIBE TABLE で確認してください。

このページでは Cassandra 固有の内容を扱います。Safe Mode、AI アシスタント、MCP サーバーなど TablePro のその他の機能は機能ページで紹介しています。

ScyllaDB

ScyllaDB は独自の接続タイプを持ち、同じ CQL ネイティブプロトコルで Cassandra ドライバーを使います。そのため接続、閲覧、編集と Cassandra の制限は上記のとおり適用されます。scylladb:// や scylla:// URL は ScyllaDB 接続を作成します。

違いはフィルターバーに一つあります。Cassandra では SASI または SAI インデックスが必要な含む、前方一致、後方一致を、ScyllaDB は任意の列で受け付けます。設定は Cassandra セットアップガイド (英語)に従ってください。

既定のポート
9042

その他

  • データの移動

    テーブルや CQL の結果を CSV、JSON、SQL、XLSX、Markdown、HTML と XML でエクスポートできます。

  • 制限

    • グリッドで編集できるのはスカラーカラムのみです。コレクション、タプル、ユーザー定義型、期間型はエディターの UPDATE で変更してください。
    • 整合性レベルの設定はありません。文はドライバーの初期設定 LOCAL_ONE で実行します。
    • セキュア接続バンドルを読み込めないため、DataStax Astra DB には接続できません。
    • マテリアライズドビューとユーザー定義型はサイドバーに表示しません。
  • ノードやリングの状態を表示しますか?

    表示しません。Cassandra と ScyllaDB に Server Dashboard はありません。ノードは nodetool status で確認し、TablePro はキースペース、テーブル、CQL に使ってください。

  • マテリアライズドビューやユーザー定義型を見るには?

    CQL エディターで system_schema キースペースを問い合わせます。例えば SELECT * FROM system_schema.views や system_schema.types です。

  • Cassandra 2.x に接続できますか?

    できません。ドライバーは Cassandra 2.x にない system_schema からスキーマを読むため、接続に失敗します。

TablePro を入手

このページの機能はすべて無料です。