AWS Glue を使用して Apache Cassandra ワークロードを Amazon Keyspaces に移行する

ターゲットのキースペースとテーブルを作成します。

カサンドラに接続するようにカサンドラドライバーを設定します。

次の設定スクリプトを使用します。

Datastax-java-driver {
  basic.request.consistency = "LOCAL_QUORUM"
  basic.contact-points = ["127.0.0.1:9042"]
   advanced.reconnect-on-init = true
   basic.load-balancing-policy {
        local-datacenter = "datacenter1"
}
advanced.auth-provider = {
       class = PlainTextAuthProvider
       username = "user-at-sample"
       password = "S@MPLE=PASSWORD="
}
}

Amazon Keyspaces に接続するように Cassandra ドライバーを設定します。

次の設定スクリプトを使用します。

datastax-java-driver {
basic {
  load-balancing-policy {
    local-datacenter = us-west-2
        }
  contact-points = [
            "cassandra.us-west-2.amazonaws.com:9142"
        ]
  request {
  page-size = 2500
  timeout = 360 seconds
  consistency = LOCAL_QUORUM
        }
    }
advanced {
 control-connection {
  timeout = 360 seconds
        }
 session-leak.threshold = 6
 connection {
 connect-timeout = 360 seconds
 init-query-timeout = 360 seconds
 warn-on-init-error = false
        }
 auth-provider = {
  class = software.aws.mcs.auth.SigV4AuthProvider
  aws-region = us-west-2
 }

 ssl-engine-factory {
  class = DefaultSslEngineFactory
        }
    }
}

AWS Glue ジョブ用に IAM ロールを作成します。

信頼できるエンティティとして AWS Glue 用の glue-cassandra-migration という名前の新しい AWS サービスロールを作成します。

AWS CloudShell で CQLReplicator をダウンロードします。

次のコマンドを実行して、プロジェクトをホームフォルダにダウンロードします。

git clone https://github.com/aws-samples/cql-replicator.git
cd cql-replicator/glue
# Only for AWS CloudShell, the bc package includes bc and dc. Bc is an arbitrary precision numeric processing arithmetic language
sudo yum install bc -y

参照設定ファイルを変更します。

プロジェクトフォルダの ../glue/conf ディレクトリに CassandraConnector.conf と KeyspacesConnector.conf をコピーします。

移行プロセスを開始します。

次のコマンドは、CQLReplicator 環境を初期化します。初期化には、.jar アーティファクトのコピーと、AWS Glue コネクタ、S3 バケット、AWS Glue ジョブ、migration キースペース、ledger テーブルの作成が含まれます。

cd cql-replicator/glue/bin
./cqlreplicator --state init --sg '"sg-1","sg-2"' \ 
                --subnet "subnet-XXXXXXXXXXXX" \ 
                --az us-west-2a --region us-west-2 \ 
                --glue-iam-role glue-cassandra-migration \ 
                --landing-zone s3://cql-replicator-1234567890-us-west-2

このスクリプトには次のパラメータが含まれます。

デプロイを検証する。

上記のコマンドを実行した後、AWS アカウントには以下が含まれている必要があります。

移行プロセスを開始します。

AWS Glue で CQLReplicator を操作するには、--state run コマンドに続けて一連のパラメータを使用する必要があります。これらのパラメータの正確な設定は、主に、固有の移行要件によって決まります。例えば、有効期限 (TTL) の値と更新をレプリケートすることを選択した場合や、1 MB を超えるオブジェクトを Amazon S3 にオフロードする場合、これらの設定は異なる場合があります。

Cassandra クラスターから Amazon Keyspaces にワークロードをレプリケートするには、次のコマンドを実行します。

./cqlreplicator --state run --tiles 8  \
                --landing-zone s3://cql-replicator-1234567890-us-west-2 \ 
                --region us-west-2 \                              
                --src-keyspace source_keyspace \ 
                --src-table source_table \  
                --trg-keyspace taget_keyspace \
                --writetime-column column_name \
                --trg-table target_table --inc-traffic

ソースキースペースとテーブルは、Cassandra クラスターの source_keyspace.source_table です。ターゲットキースペースとテーブルは、Amazon Keyspaces の target_keyspace.target_table です。パラメータ --inc-traffic は、多数のリクエストによる増分トラフィックで Cassandra クラスターと Amazon Keyspaces が過負荷になるのを防ぐのに役立ちます。

更新をレプリケートするには、コマンドラインに --writetime-column regular_column_name を追加します。通常の列は、書き込みタイムスタンプのソースとして使用されます。

過去の移行フェーズ中に移行された Cassandra 行を検証します。

バックフィルフェーズ中にレプリケートされた行数を取得するには、次のコマンドを実行します。

./cqlreplicator --state stats \
                --landing-zone s3://cql-replicator-1234567890-us-west-2 \  
                --src-keyspace source_keyspace --src-table source_table --region us-west-2

cqlreplicator コマンドまたは AWS Glue コンソールを使用します。

移行プロセスを適切に停止するには、次のコマンドを実行します。

./cqlreplicator --state request-stop --tiles 8 \                         
                --landing-zone s3://cql-replicator-1234567890-us-west-2 \     
                --region us-west-2 \                     
                --src-keyspace source_keyspace --src-table source_table

移行プロセスをすぐに停止するには、AWS Glue コンソールを使用します。

デプロイされたリソースを削除します。

次のコマンドは、AWS Glue ジョブ、コネクタ、S3 バケット、および Keyspaces テーブル ledger を削除します。

./cqlreplicator --state cleanup --landing-zone s3://cql-replicator-1234567890-us-west-2