DMS Schema Conversion のメタデータモデル

DMS Schema Conversion を使用する場合、サービスはデータベーススキーマを階層ツリーとして表します。このツリーはメタデータツリーと呼ばれ、ソーススキーマとターゲットスキーマの両方に適用されます。ルート要素 (「サーバー」) を含むツリー内の各要素はメタデータモデルです。

メタデータツリーには 2 種類の要素が含まれています。

オブジェクト — テーブル、関数、ビュー、シーケンス、インデックスなどの実際のデータベースオブジェクトを表します。DescribeMetadataModel リクエストを使用して、オブジェクトの SQL 定義を取得できます。
カテゴリ — 「スキーマ」、「テーブル」、「機能」、「インデックス」などの仮想グループ化コンテナ。カテゴリは、ナビゲーションのためにツリー内のオブジェクトを整理しますが、SQL 定義自体はありません。

メタデータツリーは、リクエストした場合にのみデータをロードします。このアプローチはオンデマンドロード (遅延ロードとも呼ばれます) と呼ばれます。つまり、DMS Schema Conversion は必要に応じてデータベースからデータを取得します。インポートオペレーションを使用してメタデータをロードします。特定のメタデータモデルを更新するか、サブツリー全体を一度にインポートします。評価や変換などのオペレーションでも、メタデータツリーが自動的にロードされます。

メタデータモデルの仕組み

DMS Schema Conversion のメタデータモデルは、オペレーションのライフサイクルに従います。メタデータツリーを変更するオペレーション (インポートや変換など) は非同期です。これらのオペレーションのリクエストを開始し、バックグラウンドで実行されます。対応する describe API を呼び出して、リクエストのステータスを確認します。ツリーを読み取るオペレーション (子や定義の記述など) は同期されます。

注記

DMS Schema Conversion では、オペレーションとリクエストという用語は同じ意味で使用されます。

一般的なワークフローには、以下のステップが含まれます。

インポート — ソースデータベースまたはターゲットデータベースからメタデータツリーにメタデータをロードします。初期メタデータモデルをロードするか、データベースから既存のモデルを再ロードできます。詳細については、「ツリーを移動する」を参照してください。API リファレンスについては、StartMetadataModelImport」を参照してください。
評価 — 選択したソースメタデータモデルを分析して、変換の複雑さと潜在的な問題を特定します。詳細については、「DMS Schema Conversion でのデータベース移行評価レポートの作成」を参照してください。
変換 — 選択したソースメタデータモデルをターゲット互換形式に変換します。変換された定義は、ターゲットメタデータツリーの一部として保存されます。詳細については、「DMS Schema Conversion でのデータベーススキーマの変換: step-by-stepガイド」を参照してください。
エクスポート — メタデータ定義を保存します。ソースメタデータとターゲットメタデータの両方を SQL スクリプトとして Amazon S3 バケットにエクスポートできます。非仮想ターゲットの場合、変換されたオブジェクトをターゲットデータベースに直接適用することもできます。仮想ターゲットの詳細については、「」を参照してください仮想データプロバイダー。変換されたオブジェクトの適用の詳細については、「」を参照してください変換したコードの適用。

ソースメタデータモデルを評価または変換したら、評価レポートを生成して結果を確認できます。詳細については、「DMS Schema Conversion でのデータベース移行評価レポートの作成」を参照してください。

サポートされている移行ペアについては、StartMetadataModelCreation を使用して SQL 定義からカスタムステートメントメタデータモデルを作成することもできます。詳細については、「ステートメントモデルを作成する」を参照してください。

メタデータモデルツリーを操作する

メタデータツリーは、次の API リクエストを使用してナビゲートできます。

DescribeMetadataModelChildren — 特定のメタデータモデルの子を返します。各子には、次の呼び出しに渡すことができる選択ルール (特定のメタデータモデルを識別するフィルター) が含まれており、より深く掘り下げることができます。
DescribeMetadataModel — 特定のメタデータモデルの名前、タイプ、SQL 定義を返します。

どちらのリクエストにも Originパラメータ (SOURCE または TARGET) が必要で、選択ルールを使用してメタデータモデルを識別します。ナビゲーションパターンは、ソースツリーとターゲットツリーの両方で同じです。選択ルールの形式の詳細については、「」を参照してくださいDMS Schema Conversion の選択ルール。

任意のインターフェイスを選択して、ナビゲーション手順を表示します。

AWS Management Console

スキーマ変換プロジェクトを開くと、ソースメタデータツリーとターゲットメタデータツリーの両方を参照できます。プロジェクトを開く方法の詳細については、「」を参照してくださいDMS Schema Conversion でのデータベーススキーマの変換: step-by-stepガイド。

コンソールには、左側にソースツリー、右側にターゲットツリーの 2 つのツリーパネルが表示されます。各パネルは、データベースエンジン、アクションメニュー、メタデータツリー自体を示すヘッダーで構成されます。

Actions メニューはコンテキストに依存します。すべてのメタデータモデルがすべてのアクションを利用できるわけではありません。ソースツリーとターゲットツリーには、異なるアクションリストがあります。

メタデータモデルの SQL 定義とプロパティを表示するには、ツリーで選択します。中央パネルには、ソース SQL タブとターゲット SQL タブに定義が表示され、プロパティタブにメタデータ属性が表示されます。メタデータモデルタイプによっては、テーブルとビューの列やルーチンのパラメータなど、追加のタブが表示される場合があります。

メタデータモデルの子を展開するには、その横の展開アイコン (黒い三角形) を選択します。展開アイコンまたはメタデータモデル名のいずれかを選択して、子を自動的にロードします。

変換されたソースメタデータモデルを選択すると、対応するターゲットメタデータモデルがターゲットツリーパネルで自動的に選択されます。

メタデータツリーを参照する

次のチュートリアルでは、メタデータツリーを参照してメタデータモデル定義を表示する方法を示します。

ツリーパネルで、サーバーの横にある展開アイコンを選択すると、データベースエンジンに応じてデータベースやスキーマなどの最上位カテゴリが表示されます。
カテゴリを展開して、探索するメタデータモデルに移動します。たとえば、データベース、特定のデータベース、スキーマ、スキーマ名、テーブル、ビュー、プロシージャなどのカテゴリを展開します。一部のデータベースエンジンにはデータベースレベルがありません。その場合、スキーマを直接展開します。
メタデータモデルを選択して、中央パネルにその SQL 定義を表示します。ソース SQL タブにはソース定義が表示され、メタデータモデルが変換されている場合はターゲット SQL タブには変換された定義が表示されます。

AWS CLI

メタデータツリーを参照する

メタデータツリーを参照するには、繰り返しパターンに従います。レベルでメタデータをインポートし、そのレベルで子を記述します。このプロセスを繰り返して、ツリーを深く掘り下げます。

まず、最上位メタデータモデルを識別する選択ルールを使用して start-metadata-model-import を呼び出します。server-name と最上位 category-name (データベースエンジンに応じて SchemasDatabasesまたは ) をに含めますobject-locator。選択ルール構造の詳細については、「」を参照してくださいDMS Schema Conversion の選択ルール。


aws dms start-metadata-model-import \
    --migration-project-identifier "my-migration-project" \
    --origin SOURCE \
    --refresh \
    --selection-rules '{"rules":[{"rule-type":"selection","rule-id":"1",
      "rule-name":"1","object-locator":{"server-name":"my-server","category-name":"top-level-category"},"rule-action":"explicit"}]}'

インポートリクエストは非同期です。describe-metadata-model-imports を使用して、ブラウジング前にステータスを確認します。特定のインポートを見つけるstart-metadata-model-importには、によって返されたRequestIdentifier値で request-id フィルターを使用します。


aws dms describe-metadata-model-imports \
    --migration-project-identifier "my-migration-project" \
    --filters Name=request-id,Values=request-identifier

インポートが完了したら、describe-metadata-model-children を呼び出して、そのレベルで子を取得します。


aws dms describe-metadata-model-children \
    --migration-project-identifier "my-migration-project" \
    --origin SOURCE \
    --selection-rules '{"rules":[{"rule-type":"selection","rule-id":"1",
      "rule-name":"1","object-locator":{"server-name":"my-server"},
      "rule-action":"explicit"}]}'

レスポンスの各子には SelectionRulesフィールドが含まれます。これらの選択ルールを次のインポートに渡し、より深く掘り下げるための呼び出しを記述します。


{
    "MetadataModelChildren": [
        {
            "MetadataModelName": "Schemas",
            "SelectionRules": "{\"rules\":[{\"rule-type\":\"selection\",\"rule-id\":\"1\",\"rule-name\":\"1\",\"object-locator\":{\"server-name\":\"src-database-server\",\"category-name\":\"Schemas\"},\"rule-action\":\"explicit\"}]}"
        }
    ]
}

次のレベルにドリルダウンするには、前のdescribe-metadata-model-children呼び出しから返された選択ルールを使用してそのレベルでをインポートし、その子を記述します。


aws dms start-metadata-model-import \
    --migration-project-identifier "my-migration-project" \
    --origin SOURCE \
    --refresh \
    --selection-rules 'selection-rules-from-previous-response'

子を記述する前に、でステータスを確認してインポートが完了していることを確認しますdescribe-metadata-model-imports。次に、を呼び出しますdescribe-metadata-model-children。


aws dms describe-metadata-model-children \
    --migration-project-identifier "my-migration-project" \
    --origin SOURCE \
    --selection-rules 'selection-rules-from-previous-response'

レスポンスは、それぞれ独自の選択ルールを持つ、そのレベルの子を返します。これらの選択ルールを次のインポートに渡し、呼び出しを記述して、ツリーをより深く掘り下げます。


{
    "MetadataModelChildren": [
        {
            "MetadataModelName": "child-name",
            "SelectionRules": "selection-rules-JSON-string"
        }
    ]
}

フルインポートと比較した --refresh の使用

を使用して--refresh、データベースから特定のメタデータモデルを再ロードします。これにより、直接の子の名前もロードされます。これらの子はを使用して一覧表示できますがdescribe-metadata-model-children、さらに記述または参照するには、子レベルで別のインポートを実行する必要があります。

サブツリー全体 (スキーマ、データベース、テーブルやプロシージャなどの特定のカテゴリ内のすべてのオブジェクトなど) をロードするには、 --refreshフラグを省略し、選択ルールincludeで rule-action に変更します。


aws dms start-metadata-model-import \
    --migration-project-identifier "my-migration-project" \
    --origin SOURCE \
    --selection-rules '{"rules":[{"rule-type":"selection","rule-id":"1",
      "rule-name":"1","object-locator":{...},
      "rule-action":"include"}]}'

完全なサブツリーをロードするには、大きなスキーマに数分または数時間かかり、データベースに負荷がかかることがあります。インタラクティブな探索では、必要に応じて特定のブランチを使用--refreshおよびドリルダウンします。

メタデータモデルの定義を取得する

メタデータモデルの SQL 定義を取得するには、describe-metadata-model を使用します。前のdescribe-metadata-model-childrenレスポンスから特定のメタデータモデルを識別する選択ルールを渡します。


aws dms describe-metadata-model \
    --migration-project-identifier "my-migration-project" \
    --origin SOURCE \
    --selection-rules 'selection-rules-for-target-object'

レスポンスには、メタデータモデル名、タイプ、SQL 定義が含まれます。


{
    "MetadataModelName": "employees",
    "MetadataModelType": "table",
    "Definition": "CREATE TABLE hr.employees(\n    id integer NOT NULL,\n    name varchar(100),\n    department_id integer\n);"
}

注記

スキーマやカテゴリなど、一部のメタデータモデルでは、 Definition フィールドが入力されない場合があります。

変換された定義を表示する

ソースメタデータモデルを変換すると、変換された定義がターゲットツリーで使用できます。これらを取得するには 3 つの方法があります。

ソースレスポンスからのターゲット選択ルールの使用

変換後にソースメタデータモデルを記述する場合、レスポンスにはターゲット選択ルールを含むTargetMetadataModelsフィールドが含まれます。


{
    "MetadataModelName": "employees",
    "MetadataModelType": "table",
    "TargetMetadataModels": [
        {
            "MetadataModelName": "employees",
            "SelectionRules": "{\"rules\":[{\"rule-type\":\"selection\",\"rule-id\":\"1\",\"rule-name\":\"1\",\"object-locator\":{\"server-name\":\"tgt-database-server\",\"schema-name\":\"hr\",\"table-name\":\"employees\",\"table-type\":\"table\"},\"rule-action\":\"explicit\"}]}"
        }
    ],
    "Definition": "CREATE TABLE hr.employees(\n    id integer NOT NULL,\n    name varchar(100),\n    department_id integer\n);"
}

を使用して、選択ルールをから TargetMetadataModelsに渡describe-metadata-modelします--origin TARGET。


aws dms describe-metadata-model \
    --migration-project-identifier "my-migration-project" \
    --origin TARGET \
    --selection-rules 'selection-rules-from-TargetMetadataModels'

レスポンスには、変換された SQL 定義がターゲットエンジン構文に含まれます。


{
    "MetadataModelName": "employees",
    "MetadataModelType": "table",
    "Definition": "CREATE TABLE hr.employees (\nid INT NOT NULL,\nname VARCHAR(100) DEFAULT NULL,\ndepartment_id INT DEFAULT NULL,\nPRIMARY KEY (id)\n);"
}

get-target-selection-rules の使用

get-target-selection-rules を使用すると、ソースdescribe-metadata-modelで最初にを呼び出すことなく、ソース選択ルールをターゲットの対応するルールに直接変換できます。


aws dms get-target-selection-rules \
    --migration-project-identifier "my-migration-project" \
    --selection-rules 'source-selection-rules'

ターゲットツリーを直接ナビゲートする

を使用して、ソースツリーと同じ方法でターゲットツリーを参照することもできます--origin TARGET。これは、ソースから開始せずに変換されたすべてのオブジェクトを探索する場合に便利です。

ステートメントメタデータモデルを作成する

注記

ステートメントの作成は現在、SQL Server から Aurora PostgreSQL へ、または SQL Server から Amazon RDS for PostgreSQL への指示のみをサポートしています。

StartMetadataModelCreation を使用して、SQL 定義からステートメントメタデータモデルを作成できます。これは、アプリケーションクエリやアドホック SQL コードなど、ソースデータベースにオブジェクトとして存在しない SQL ステートメントを変換する場合に便利です。

ドキュメントの表記規則

概念

選択ルール