AWS Schema Conversion Tool
ユーザーガイド (Version 1.0)

AWS Schema Conversion Tool ユーザーインターフェイスの使用

以下のセクションは、AWS SCT ユーザーインターフェイスの操作に役立ちます。AWS SCT のインストールの詳細については、「AWS Schema Conversion Tool のインストール、検証、更新」を参照してください。

AWS SCT プロジェクトウィンドウ

以下の図に示しているのは、スキーマ移行プロジェクトを作成してスキーマを変換するときに使用する、AWS SCT のセクションです。

  1. 左のパネルでは、ソースデータベースのスキーマがツリービューで表示されます。データベーススキーマは "遅延ロード" されます。 つまり、ツリービューから項目を選択すると、AWS SCT では、ソースデータベースの現在のスキーマが取得されて表示されます。

  2. 上中央のパネルでは、ターゲットデータベースエンジンに自動変換できなかったソースデータベースエンジンのスキーマ要素について、アクション項目が表示されます。

  3. 右のパネルでは、ターゲット DB インスタンスのスキーマがツリービューで表示されます。データベーススキーマは "遅延ロード" されます。 つまり、ツリービューから項目を選択した時点で、AWS SCT では、ターゲットデータベースの現在のスキーマが取得されて表示されます。


                AWS SCT プロジェクトウィンドウ
  1. 左下のパネルでは、スキーマ要素を選択すると、ソーススキーマ要素を定義するプロパティと、ソースデータベースでその要素を作成する SQL コマンドが表示されます。

  2. 右下のパネルでは、スキーマ要素を選択すると、ターゲットスキーマ要素を定義するプロパティと、ターゲットデータベースでその要素を作成する SQL コマンドが表示されます。この SQL コマンドを編集し、更新したコマンドをプロジェクトで保存できます。

AWS Schema Conversion Tool での AWS のサービスプロファイルの使用

AWS Schema Conversion Tool に AWS 認証情報を保存できます。AWS SCT では、AWS のサービスと統合されている機能を使用するときに、認証情報を使用します。たとえば、AWS SCT が Amazon S3、AWS Lambda、Amazon Relational Database Service、および AWS Database Migration Service と統合されています。

認証情報が必要な機能にアクセスすると、AWS SCT より AWS 認証情報を求められます。認証情報はグローバルアプリケーション設定で保存できます。保存された認証情報は、AWS SCT の認証情報入力画面で選択できます。

グローバルアプリケーション設定では、別の組み合わせの AWS 認証情報を保存することもできます。たとえば、テストシナリオで使用する認証情報とは別に、運用シナリオで使用する認証情報を保存できます。また、AWS リージョンごとに異なる認証情報を保存することもできます。

AWS 認証情報を保存する

AWS 認証情報をグローバルに保存するには、以下の手順を行います。

AWS 認証情報を保存するには

  1. AWS Schema Conversion Tool を開始します。

  2. [Settings Menu] を開き、[Global Settings] を選択します。[Global Settings] ダイアログボックスが表示されます。

    次に示すように、[AWS Service Profiles] を選択します。

    
                            [AWS Service Profiles (AWS サービスプロファイル)] タブが選択された [Global Settings (グローバル設定)] ダイアログボックス
  3. [Add new AWS Service Profile] を選択します。

  4. 次のように AWS 情報を入力します。

    AWS SCT オプション

    アクション

    Schema/Database Name

    フィルタするスキーマやデータベースの名前を選択します。スキーマ名として「%」と入力すると、すべてのスキーマを選択できます。

    1. [Profile name] に、プロファイルの名前を入力します。

    2. [AWS Access Key] に、AWS アクセスキーを入力します。

    3. [AWS Secret Key] に、AWS シークレットキーを入力します。

    4. [Region] で、プロファイルのリージョンを選択します。

    5. [S3 Bucket (S3 バケット)] で、プロファイルの Amazon S3 バケットを選択します。S3 に接続する機能を使用する場合に限り、バケットを指定する必要があります。

    6. 連邦情報処理標準 (FIPS) のセキュリティ要件に準拠する場合は、[Use FIPS endpoint for S3] を選択します。FIPS エンドポイントは、以下の AWS リージョンで利用できます。

      • 米国東部 (バージニア北部) リージョン

      • 米国東部 (オハイオ) リージョン

      • 米国西部 (北カリフォルニア) リージョン

      • 米国西部 (オレゴン) リージョン

  5. [Test Connection] を選択して、認証情報が正しくアクティブであることを確認します。

    [Test Connection] ダイアログボックスが表示されます。プロファイルに接続されたサービスのそれぞれについて、ステータスを確認できます。[Pass] は、プロファイルが正常にサービスにアクセスできることを示します。

    
                            [AWS Service Profiles (AWS サービスプロファイル)] タブが選択された [Global Settings (グローバル設定)] ダイアログボックス
  6. プロファイルを設定したら、[Save] を選択してプロファイルを保存します。変更をキャンセルする場合は、[Cancel] を選択します。

  7. [OK] を選択し、[Global Settings] ダイアログボックスを閉じます。

プロジェクトのデフォルトプロファイルを設定する

AWS SCT プロジェクトのデフォルトプロファイルを設定できます。この設定を行うと、プロファイルに保存されている AWS 認証情報がプロジェクトに関連付けられます。プロジェクトが開いたら、次の手順でデフォルトプロファイルを設定します。

プロジェクトのデフォルトプロファイルを設定するには

  1. AWS Schema Conversion Tool を開始します。

  2. [Settings Menu] を開き、[Project Settings] を選択します。[Current project settings] ダイアログボックスが表示されます。

  3. [Project Environment] タブを選択します。

  4. [AWS Service Profile] で、プロジェクトと関連付けるプロファイルを選択します。

  5. [OK] を選択し、[Current project settings] ダイアログボックスを閉じます。変更をキャンセルする場合は、[Cancel] を選択します。

データベースパスワードの保存

データベースパスワードまたは SSL 証明書を AWS SCT キャッシュに保存できます。パスワードを保存するには、接続の作成時に [Store Password (パスワードの保存)] を選択します。

パスワードは、ランダムに生成されたトークンを使用して seed.dat ファイルに暗号化されます。次に、パスワードはユーザー名と共にキャッシュファイルに保存されます。seed.dat ファイルを失うか、破損した場合、データベースパスワードの暗号化が正しく解除されない可能性があります。この場合、接続は失敗します。

パーティション分割されたテーブルでプロジェクトの Union All ビューを使用する

ソーステーブルがパーティション分割されている場合、AWS SCT は、ターゲットテーブルを n 個作成します。ここで、n は、ソーステーブル上のパーティションの数を表します。AWS SCT は、ターゲットテーブルの上部に UNION ALL を作成してソーステーブルを表します。AWS SCT データ抽出プログラムを使用してデータを移行すると、ソーステーブルのパーティションが抽出され、個々のサブタスクによって並列にロードされます。

プロジェクトで Union All ビューを使用するには

  1. AWS SCT を起動します。データウェアハウス (OLAP) プロジェクトを選択します。

  2. [Settings (設定)] を選択し、[Project settings (プロジェクト設定)] を選択します。[Current project settings] ダイアログボックスが表示されます。

  3. [Use Union all view (Union All ビューを使用する)] を選択します。

  4. [OK] を選択して設定を保存し、[Current project settings (現在のプロジェクト設定)] ダイアログボックスを閉じます。

AWS SCT ツリーフィルタの使用

AWS SCT は、ソースからターゲットにデータを移行する場合、すべてのメタデータをソースおよびターゲットデータベースからツリー構造内にロードします。この構造は、AWS SCT のメインプロジェクトウィンドウにツリービューとして表示されます。

一部のデータベースは、ツリー構造内のオブジェクト数が非常に多くなる場合があります。AWS SCT のツリーフィルタを使用すると、ソースおよびターゲットツリー構造内のオブジェクトを検索できます。ツリーフィルタでは、オブジェクトは変更されません。データベースの変換に伴ってオブジェクトが変換される場合とは異なります。フィルタにより、ツリー内の表示が変更されるのみです。

ツリーフィルタは、AWS SCT でロード済みのオブジェクトを対象とします。つまり、検索中は AWS SCT でデータベースからオブジェクトがロードされません。そのため、通常、ツリー構造内のオブジェクト数はデータベース内のオブジェクト数より少なくなります。

ツリーフィルタについては、以下の点に注意してください。

  • フィルタのデフォルトは ANY です。このフィルタでは、名前の検索を使用してオブジェクトを見つけます。

  • オブジェクトタイプを選択すると、選択したタイプのオブジェクトのみが表示されます。

  • フィルタマスクを使用すると、さまざまなタイプの記号 (Unicode、スペース、特殊文字など) を表示できます。「%」文字は、あらゆる記号のワイルドカードです。

  • フィルタを適用すると、フィルタしたオブジェクトの数のみがカウントに表示されます。

ツリーフィルタを作成するには

  1. 既存の AWS SCT プロジェクトを開きます。

  2. ツリーフィルタの適用先のデータベースに接続します。

  3. フィルタアイコンを選択します。

    注記

    フィルタを元に戻すアイコンは、現在適用されているフィルタがないため、灰色で表示されます。

    
                スキーマツリーのフィルタアイコン
  4. [Tree Filter] ダイアログボックスで、以下の情報を入力します。ダイアログボックスのオプションは、データベースエンジンごとに異なります。

    
                        スキーマツリーのフィルタアイコン

    AWS SCT オプション

    アクション

    Schema/Database Name

    フィルタするスキーマやデータベースの名前を選択します。スキーマ名として「%」と入力すると、すべてのスキーマを選択できます。

    オブジェクト名

    オブジェクト名で検索する場合は、オブジェクト名を選択します。

    Tree States

    テーブルの状態を選択します。オプションは以下のとおりです。

    • [Any (すべて)] – すべてのテーブルを表示します。

    • [Converted (変換済み)] – 変換済みのテーブルのみを表示します。

    • [Not Converted (変換なし)] – 未変換のテーブルのみを表示します。

    • [Has Actions (アクションあり)] – アクションが保留中のテーブルを表示します。

    オブジェクトタイプのリスト

    フィルタ対象のオブジェクトタイプのリストからオブジェクトを選択します。ツリーノードを展開し、追加のオブジェクトをオブジェクトタイプリストにロードします。

  5. [Apply] を選択します。[Apply] を選択すると、フィルタを元に戻すアイコン (フィルタアイコンの横) が有効になります。適用したフィルタを削除する場合は、このアイコンを使用します。

  6. [Close] を選択してダイアログボックスを閉じます。

ツリーに表示されるスキーマをフィルタリングする場合、スキーマを変換するときに変換されるオブジェクトは変更されません。フィルタにより、ツリー内の表示が変更されるのみです。

ツリーフィルタのファイルリストのインポート

ツリーフィルタで使用する名前や値を含むファイルをインポートできます。このファイルでは、次の命名規則が使用されます。

  • Object は、検索するオブジェクトのタイプです。

  • Database は、このオブジェクトがあるデータベースの名前です。

  • Schema は、このオブジェクトがあるスキーマの名前です。

  • Name は、オブジェクト名です。

インポートするファイルは次の形式であることが必要です。

  • Object;Database;Schema;Name – この形式は Microsoft SQL Server、SQL データウェアハウス、および SQL の Netezza ダイアレクトに必須です。

  • Object;Schema;Name – この形式は他の SQL ダイアレクトに使用します。

ツリーフィルタのファイルリストをインポートするには

  1. 既存の AWS SCT プロジェクトを開き、ツリーフィルタの適用先のデータベースに接続して、フィルタアイコンを選択します。

    
                            スキーマツリーのフィルタアイコン
  2. [Import File List] タブを選択します。

  3. [Import File] を選択します。

  4. インポートするファイルを選択し、[Open] を選択します。

  5. [Apply]、[Close] の順に選択します。

AWS SCT ツリービューのスキーマの非表示

ツリービューの設定では、AWS SCT ツリービューに表示するスキーマとデータベースを指定します。空のスキーマ、空のデータベース、システムデータベース、ユーザー定義のデータベースやスキーマは、非表示にすることができます。

ツリービューのデータベースやスキーマを非表示にするには

  1. AWS SCT プロジェクトを開きます。

  2. ツリービューで表示するデータストアに接続します。

  3. [Settings]、[Global Settings]、[Tree View] の順に選択します。

    
                        [Global Settings (グローバル設定)] ダイアログボックスの [Tree View Settings (ツリービューの設定)] セクション
  4. [Tree View Settings] セクションで、以下の操作を行います。

    • [Hide System Databases/Schemas] で、非表示にするシステムデータベースやスキーマの名前を選択します。

    • [Hide User Defined Databases/Schemas] で、非表示にするユーザー定義のスキーマやデータベースの名前を入力し、[Add] を選択します。名前の大文字と小文字は区別されません。

    • [Reset to Default] を選択すると、ツリービューはデフォルト設定にリセットされます。

  5. [OK] を選択します。

AWS SCT のキーボードショートカット

AWS SCT で使用できるキーボードショートカットは次のとおりです。

キーボードショートカット 説明

Ctrl+N

新しいプロジェクトを作成する.

Ctrl+O

既存のプロジェクトを開きます。

Ctrl+S

開いているプロジェクトを保存します。

Ctrl+W

ウィザードを使用して新しいプロジェクトを作成します。

Ctrl+L

ソースデータベースに接続する。

Ctrl+R

ターゲットデータベースに接続します。

データベース移行評価レポートの作成と確認

データベース移行評価レポートには、ターゲット Amazon RDS DB インスタンスのエンジン用に自動変換できないスキーマに対するすべてのアクション項目が、要約されて表示されます。また、ターゲット DB インスタンス用の同等のコードを記述するのにかかる推定労力も示されます。

以下の手順を使用して、プロジェクトでデータベース移行評価レポートをいつでも作成(または更新)できます。

データベース移行評価レポートを作成および表示するには

  1. ソースデータベースのスキーマを表示する左のパネルで、評価レポートを作成するスキーマオブジェクトを選択します。オブジェクトのコンテキスト (右クリック) メニューを開き、[Create Report] を選択します。

    
                        データベース移行評価レポートの作成

    評価レポートビューが開きます。

  2. [Action Items] タブを選択します。

    [Action Items] タブには、自動変換できないスキーマについて説明する項目のリストが表示されます。リストからいずれかのアクション項目を選択します。アクション項目が適用されるスキーマが AWS SCT によってハイライトされます。

    
                        [Action Items (アクション項目)] タブ
  3. [Summary] タブを選択します。

    [Summary] タブには、データベース移行評価レポートの要約が表示されます。そのタブには、自動変換された項目の数と自動変換されなかった項目の数が示されます。要約には、ターゲット DB インスタンスで、ソースデータベースのものと同等のスキーマを作成するのにかかる推定時間も示されます。

    License Evaluation and Cloud Support (ライセンス評価およびクラウドサポート) セクションには、同エンジンを実行する Amazon RDS DB インスタンスへの既存のオンプレミスのデータベーススキーマの移動に関する情報が含まれます。たとえば、ライセンスのタイプを変更する場合は、このレポートセクションを確認することで、現在のデータベースから削除する必要のある機能を見極めることができます。

    評価レポートの要約のサンプルを以下に表示します。

    
                        評価レポートの要約
  4. [Summary] タブ、[Save to PDF] の順に選択します。データベース移行評価レポートは PDF ファイルとして保存されます。PDF ファイルには、要約とアクション項目の情報の両方が含まれます。

    [Save to CSV] を選択して、レポートをカンマ区切り値 (CSV) ファイルとして保存することもできます。CSV ファイルには、アクション項目の情報のみが含まれます。

    
                        データベース移行評価レポート

AWS Schema Conversion Tool を開始中

AWS Schema Conversion Tool を開始するには、次に示すように、オペレーティングシステムの手順を使用します。

オペレーティングシステム Instructions

Fedora Linux

次のコマンドを実行します。

/opt/AWSSchemaConversionTool/AWSSchemaConversionTool

Microsoft Windows

アプリケーションのアイコンをダブルクリックします。

Ubuntu Linux

次のコマンドを実行します。

/opt/AWSSchemaConversionTool/AWSSchemaConversionTool

AWS Schema Conversion Tool プロジェクトの作成

以下の手順では、AWS Schema Conversion Tool プロジェクトの作成方法を示しています。

プロジェクトを作成するには

  1. AWS Schema Conversion Tool を開始します。

  2. [File] メニューから [New Project] を選択します。[New Project] ダイアログボックスが表示されます。

    
                        [New Project (新しいプロジェクト)] ダイアログボックス
  3. 以下の予備的なプロジェクト情報を追加します。

    パラメータ 操作
    プロジェクト名

    コンピューターにローカルに保存されているプロジェクトの名前を入力します。

    場所

    ローカルプロジェクトファイルの場所を入力します。

    [Transactional Database (OLTP)] または [Data Warehouse (OLAP)] を選択します。
    Source DB Engine

    (OLTP) [Microsoft SQL Server]、[MySQL]、[Oracle]、または [PostgreSQL] を選択します。

    (OLAP) [Amazon Redshift]、[Greenplum]、[Microsoft SQL Server DW]、[Netezza]、[Oracle DW]、[Teradata]、または [Vertica] を選択します。

    Target DB Engine

    (OLTP) [Amazon Aurora (MySQL 互換)]、[Amazon Aurora (PostgreSQL 互換)]、[Amazon RDS for Microsoft SQL Server]、[Amazon RDS for MySQL]、[Amazon RDS for Oracle]、または [Amazon RDS for PostgreSQL] を選択します。

    (OLAP)[Amazon Redshift] を選択します。

  4. [OK] を選択して、AWS SCT プロジェクトを作成します。

スキーマの変換

以下の手順を使用して、スキーマを変換します。

スキーマを変換するには

  1. [View]、[Main View] の順に選択します。

    
                        メインビューの選択
  2. ソースデータベースのスキーマを表示する左のパネルで、変換するスキーマオブジェクトを選択します。オブジェクトのコンテキスト (右クリック) メニューを開き、[Convert schema] を選択します。

    
                        スキーマの変換
  3. AWS SCT でスキーマの変換が終了すると、プロジェクトの右のパネルでスキーマの候補が表示されます。

    この時点で、スキーマはターゲット Amazon RDS DB インスタンスには適用されていません。計画したスキーマはプロジェクトの一部です。変換されたスキーマ項目を選択すると、ターゲット Amazon RDS DB インスタンスの下中央のパネルに、計画したスキーマコマンドが表示されます。

    このウィンドウでスキーマを編集できます。変換されたスキーマの適用を選択すると、編集したスキーマはプロジェクトの一部として保存され、ターゲット DB インスタンスに書き込まれます。

    
                        変換されたスキーマの表示

ターゲット DB インスタンスへの変換されたスキーマの適用

変換されたデータベーススキーマをターゲット Amazon RDS DB インスタンスに適用できます。スキーマがターゲット DB インスタンスに適用されたら、データベース移行評価レポートのアクション項目に基づいてスキーマを更新できます。

警告

この手順により、既存のターゲットスキーマは上書きされます。意図せずスキーマを上書きしないように注意してください。ターゲット DB インスタンスのスキーマに変更を加えている場合、その変更も上書きされます。

変換されたデータベーススキーマをターゲット Amazon RDS DB インスタンスに適用するには

  1. ターゲット DB インスタンスに計画したスキーマを表示するスキーマ要素を、プロジェクトの右パネルで選択します。

  2. スキーマ要素のコンテキスト (右クリック) メニューを開き、[Apply to database] を選択します。

    
                        [Apply to database (データベースに適用)]

    変換されたスキーマがターゲット DB インスタンスに適用されます。