AWS Schema Conversion Tool 使用のベストプラクティス - AWS Schema Conversion Tool
追加メモリの構成既定のプロジェクトフォルダデータ移行の速度向上ログ情報の増加

AWS Schema Conversion Tool 使用のベストプラクティス

AWS Schema Conversion Tool (AWS SCT) を使用するためのベストプラクティスとオプションに関する情報が見つかります。

追加メモリの構成

3,500 のストアドプロシージャを含むデータベースなどの大規模なデータベーススキーマを変換するには、AWS Schema Conversion Tool で使用可能なメモリの量を構成できます。

AWS SCT が消費するメモリの量を変更するには

  1. [設定]メニューで[グローバル設定] を選択し、[JVM オプション] を選択します。

  2. [設定ファイルを編集] を選択し、テキストエディタを選択して設定ファイルを開きます。

  3. 利用可能なメモリの最小値と最大値を設定するには、JavaOptions セクションを編集します。次の例では、最小値を 4 GB に、最大値を 40 GB に設定しています。

    [JavaOptions]
-Xmx40960M
-Xms4096M

    使用可能な最小メモリのサイズは 4 GB 以上に設定することをお勧めします。

  4. 設定ファイルを保存し、[OK] を選択し、AWS SCT を再起動して変更を適用します。

既定のプロジェクトフォルダを設定します。

AWS SCT は、プロジェクトフォルダを使用して、プロジェクトファイルの保存、評価レポートの保存、変換されたコードの保存を行います。デフォルトでは、AWS SCT はすべてのファイルをアプリケーションフォルダに保存します。別のフォルダを既定のプロジェクトフォルダとして指定できます。

既定のプロジェクトフォルダを変更するには

  1. [設定] メニューで [グローバル設定] を選択し、[ファイルパス] を選択します。

  2. [既定のプロジェクトファイルパス] には、既定のプロジェクトフォルダへのパスを入力します。

  3. [適用]、[OK] の順に選択します。

データ移行の速度向上

1 TB を超えるデータを含む一連のテーブルなど、大きなデータセットを移行する場合は、移行速度を上げることが必要になる場合があります。データ抽出エージェントを使用する場合、データ移行の速度はさまざまな要因によって決まります。これらの要因には、ターゲット Amazon Redshift クラスターのスライスの数、移行タスクのチャンクファイルのサイズ、データ抽出エージェントを実行する PC で使用可能な RAM などが含まれます。

データ移行速度を上げるために、本番データの小さなデータセットでテスト移行セッションを複数回実行することをお勧めします。また、データ抽出エージェントは 500 GB 以上の SSD を搭載した PC で実行することをお勧めします。これらのテストセッションでは、さまざまな移行パラメーターを変更し、ディスクの使用状況を監視して、データ移行速度が最大になる構成を見つけます。次に、この構成を使用してデータセット全体を移行します。

ログ情報の増加

AWS SCT を使用して、データベース、スクリプト、アプリケーション SQL を変換する際に生成されるロギング情報を増やすことができます。ログ情報を増やすと、変換が遅くなる可能性がありますが、変更することで、エラーが発生した場合に AWS Support に確実な情報が提供されます。

AWS SCT は、ローカル環境にログを保存します。これらのログファイルを表示し、トラブルシューティングのために AWS Support または AWS SCT 開発者と共有できます。

ログ設定の変更

  1. [設定] メニューを開き、[グローバル設定]、[ログ記録] を選択します。

  2. [ログフォルダパス] には、ユーザーインターフェイスからログを保存するフォルダを入力します。

  3. [コンソールログフォルダパス] には、AWS SCT コマンドラインインターフェイス (CLI) のログを保存するフォルダを入力します。

  4. [最大ログファイルサイズ (MB)] には、1 つのログファイルのサイズ (MB) を入力します。ファイルがこの制限に達すると、AWS SCT は新しいログファイルを作成します。

  5. [ログファイルの最大数] には、保存するログファイルの数を入力します。フォルダー内のログファイル数がこの制限に達すると、AWS SCT は最も古いログファイルを削除します。

  6. [エクストラクタログのダウンロードパス] には、データ抽出エージェントのログを格納するフォルダを入力します。

  7. [Cassandra エクストラクタログのパス] には、Apache Cassandra データ抽出エージェントのログを保存するフォルダを入力します。

  8. AWS SCT がデータ抽出エージェントを使用するたびにログの保存場所を確認するようにするには、[ロードする前にパスを確認する] を選択します。

  9. [デバッグモード] では、[True] を選択します。このオプションを使用すると、標準の AWS SCT ログに問題がない場合に追加情報を記録できます。

  10. 主要なアプリケーションを選択して、ログ情報を増やします。以下のアプリケーションモジュールのログ情報を増やすことができます。

    • [全般]

    • [ローダー]

    • [パーサー]

    • [プリン タ]

    • [リゾルバ]

    • [Telemetry]

    • [コンバータ]

    • [型のマッピング]

    • [ユーザーインターフェイス]

    • [コントローラ]

    • [スキーマの比較]

    • [クローンデータセンター]

    • [アプリケーションアナライザ]

    前述のアプリケーションモジュールごとに、以下のログ記録レベルのいずれかを選択します。

    • [トレース] — 最も詳細な情報。

    • [デバッグ] — システム内のフローに関する詳細情報。

    • [情報] — スタートアップやシャットダウンなどのランタイムイベント。

    • [警告] — 非推奨の API の使用、API の不適切な使用、その他望ましくない、または予期しないランタイムの状況。

    • [エラー] — ランタイムエラーまたは予期しない状況。

    • [重大] — アプリケーションのシャットダウンにつながるエラー。

    • [必須] — 発生する可能性のある最高レベルのエラー。

    デフォルトでは、[デバッグモード] をオンにすると、AWS SCT ですべてのアプリケーションモジュールの [情報] ログレベルが設定されます。

    例えば、変換中の主な問題領域をサポートするには、[パーサー]、[型のマッピング]、および [ユーザーインターフェイス] を [トレース] に設定します。

ログがストリーミングされているファイルシステムに対して情報が冗長になりすぎた場合は、ログをキャプチャするのに十分なスペースがある場所に変更してください。

AWS Support にログをに送信するには、ログが格納されているディレクトリに移動し、すべてのファイルを管理可能な単一の .zip ファイルに圧縮します。次に、サポートケースとともに .zip ファイルをアップロードします。最初の分析が完了し、進行中の開発が再開されたら、[Debug mode] (デバッグモード) を [false] に戻して冗長なログを削除してください。その後、変換速度を上げます。

ヒント

ログサイズを管理し、問題の報告を合理化するには、変換が成功した後にログを削除するか、別の場所に移動します。このタスクの実行により、関連するエラーと情報のみが AWS Support に送信され、ログファイルシステムがいっぱいにならないようにします。