本文へスキップ

毎日 TablePro をお使いですか?ライセンスで有料機能が使え、次のリリースを支えられます。 ライセンスを購入ライセンスで TablePro を支援

Mac 用 Cassandra・ScyllaDB クライアント

キースペースとテーブルを閲覧し、エディタで CQL を実行して、完全な主キーで書き戻す行を編集します。同じドライバーで ScyllaDB と Amazon Keyspaces にも接続できます。

Mac で使用可能初めて Cassandra を選ぶとドライバーをダウンロード

サイドバーからデータグリッドに開いた Cassandra テーブル。変更した status 値は保存まで保留中と示され、set 列はコレクションとして表示されています。

概要

クエリ言語
CQL
ドライバー
初回使用時にダウンロードScyllaDB と共有
接続方法
ホストとポート, SSH トンネル, SSL/TLS, AWS IAM
既定のポート
9042
最低バージョン
3.0、文書に記載
iPhone と iPad
開けない

接続

コンタクトポイントとポートを指定し、クラスタに認証機構が設定されていればユーザー名とパスワードも入力します。キースペース欄はなく、接続後サイドバーで選ぶか、cassandra:// または cql:// URL のパスに入れてインポートします。キースペースはその場で切り替え、システム用は一覧から除きます。開いたタブはそれぞれのキースペースを保持します。

新しい接続では TLS は無効です。ドライバーに日和見 TLS がないため、Preferred と Required はどちらも証明書を検証せず暗号化します。Verify CA と Verify Identity は CA 証明書ファイルが必須で、システムのルート証明書には戻りません。相互 TLS はクライアント証明書、鍵とそのパスフレーズを追加します。プライベートネットワークのクラスタには SSH トンネル で接続します。

Amazon Keyspaces はパスワードではなく SigV4 でログインします。ポート 9142 の cassandra.us-east-1.amazonaws.com など地域エンドポイントを指定し、Authentication を AWS IAM 方式 (英語)(アクセスキー、プロファイルや AWS IAM Identity Center)にします。ユーザー名とパスワードは空欄にし、平文を拒否するため TLS を有効にします。

閲覧と CQL 実行

サイドバーからテーブルを開き、データグリッドで読みます。リスト、セット、マップとタプルはコレクション、ユーザー定義型はフィールド、duration は 1d2h30m、ベクトルは数値リスト、blob は十六進数で表示します。CQL エディタの結果は読み取り専用なので、行はサイドバーで開いたテーブルから変更します。

CQL に OFFSET はないため、最初の行から前方向にページを読みます。表示済みの Next と Previous は一回の読み取り、遠いページへのジャンプはそれ以前をすべて読みます。行はトークン順で、CQL は一つのパーティション内のクラスタリングカラムでしか並べ替えないため、ヘッダーで再ソートしません。開く時に件数は数えず、Count Exactly の SELECT COUNT(*) はすべてのパーティションを読みます。

フィルター は ALLOW FILTERING を付けるため、完全なパーティションキーを指定しなければ全パーティションを読みます。含む、前方一致と後方一致は LIKE として送り、Cassandra は SASI または SAI インデックスのあるカラムだけで受け付けます。不等号や is NULL など CQL で表せない演算子は名前を示して拒否し、OR がないため条件は AND のみです。

編集した値 はカラムの CQL 型で送り、解析できない値は保存全体を止めます。各行は完全な主キーを指定する個別の文で書きます。Add Row は INSERT … IF NOT EXISTS で、同じキーの行を上書きしません。キーのカラムはその場で変更できないため、行を削除して追加し直してください。

カウンターカラムは CQL エディタの UPDATE … SET c = c + 1 が必要で、グリッドの単純な UPDATE はサーバーが拒否します。接続タイムアウトは接続の Options で設定しますが、CQL リクエストはドライバー固有の固定タイムアウトを使い、アプリのクエリタイムアウトは影響しません。

キースペースとテーブル

Structure タブ は各カラムの CQL 型を示し、パーティションキーもクラスタリングカラムも主キーと表示し、セカンダリインデックスを示します。カラムの追加・削除に対応します。それ以外はインデックスも含め、エディタで CQL 文を実行します。

DDL タブはカラム一覧から CREATE TABLE を再構築するため、compaction などのテーブルオプション、クラスタリング順序とパーティション・クラスタリングキーの区別は省きます。完全な定義は cqlsh の DESCRIBE TABLE で確認します。ユーザー定義関数と集約は Functions に表示します。

データの移動

TablePro は Cassandra や ScyllaDB のインポートに対応しません。テーブルや CQL の結果を CSV、JSON、SQL、XLSX、Markdown、HTMLとXML で エクスポート できます。

iPhone と iPad

iPhone と iPad アプリには Cassandra ドライバーがありません。Mac から同期した Cassandra 接続は一覧に表示しますが、開けません。

制限

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

ScyllaDB

既定のポート 9042初回使用時にダウンロードiPhone と iPad: 開けない

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

フィルターバーに一つ違いがあります。ScyllaDB は含む、前方一致と後方一致が送る LIKE を任意のカラムで受け付けますが、Cassandra は SASI または SAI インデックスが必要です。ScyllaDB の設定は Cassandra 設定ガイド (英語) に従います。

ScyllaDB セットアップガイド (英語)

Cassandra に関する質問

ノードやリングの状態を表示しますか?

表示しません。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 を入手

Mac アプリは無料でダウンロードして使えます。Starter や Team プランは任意の機能を追加します。
Mac 版をダウンロード

macOS 13 Ventura 以降 が必要です