View a markdown version of this page

DMS Schema Conversion を使用した変換評価レポート - AWS データベース移行サービス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

DMS Schema Conversion を使用した変換評価レポート

スキーマの変換をサポートするために生成されるレポートは、DMS Schema Conversion の重要な部分です。この変換評価レポートは、ソーススキーマ内のデータベースオブジェクトを分析し、DMS Schema Conversion が自動的に変換できるオブジェクトと、手動アクションが必要なオブジェクトを特定します。 AWS DMS コンソールでレポートを表示するか、PDF またはカンマ区切り値 (CSV) ファイルとしてコピーを保存できます。

変換評価レポートには以下が含まれます。

  • エグゼクティブサマリー

  • 手動アクションを必要とするデータベースオブジェクトの変換に関する推奨事項

DMS Schema Conversion が自動的に変換できないデータベースオブジェクトがある場合、レポートには、ターゲット DB インスタンスの同等のコードを記述するために必要な労力を示す推定値が表示されます。

DMS Schema Conversion を使用した変換評価レポートの評価の実行

移行プロジェクトを作成したら、次のいずれかの方法を使用して、変換の複雑さの評価を実行します。

AWS Management Console
評価を実行して変換評価レポートを生成するには
  1. にサインイン AWS マネジメントコンソール し、https://console.aws.amazon.com/dms/v2/ で AWS DMS コンソールを開きます。

  2. [移行プロジェクト] を選択します。[移行プロジェクト] ページが開きます。

  3. [移行プロジェクト]、[スキーマ変換] の順に選択します。

  4. [スキーマ変換を起動] をクリックします。[スキーマ変換] ページが開きます。

  5. ソースデータベースペインで、評価するノードを選択します。評価アクションは、データベースノード、個々のデータベースノード、および dbo などのスキーマノードで使用できます。テーブルやプロシージャなどの個々のオブジェクトノードでは使用できません。

  6. ソースデータベースペインで少なくとも 1 つの親ノードを選択します。Actions メニューは、親ノードが選択されている場合にのみ使用できます。

  7. アクションメニューを開き、評価を選択します。確認のダイアログボックスが表示されます。

  8. ダイアログボックスの [評価] をクリックして、この選択を確定します。

AWS CLI

次の例では、start-metadata-model-assessment を使用して、ExampleSchema スキーマ内のすべてのオブジェクトの変換の複雑さの評価をキューに入れます。

aws dms start-metadata-model-assessment \ --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \ --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "source-server", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}'
注記

--selection-rules パラメータは、評価に含めるデータベースオブジェクトを指定する JSON 文字列を取得します。完全な選択ルールの JSON 構造については、「」を参照してくださいDMS Schema Conversion の選択ルール

レスポンスには、評価リクエストRequestIdentifierを識別する が含まれます。

{ "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

評価は非同期的に実行されるため、続行する前に評価が完了するまで aws dms wait metadata-model-assessed を使用してブロックします。

aws dms wait metadata-model-assessed \ --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"

コマンドは 30 秒ごとにポーリングし、評価が終了状態になると を返します。360 回のチェック (約 3 時間) 後に評価が完了しない場合、リターンコード 255 で終了します。

評価を開始しても、毎回ゼロからまったく新しいレポートが生成されません。変換評価レポートには移行プロジェクトの現在の状態が反映されるため、これまでに評価または変換したものに対するアクション項目と生成 AI 候補が含まれます。詳細については、「変換評価レポートのメトリクスについて」を参照してください。

DMS Schema Conversion の変換評価レポートを保存する

評価または変換を実行したら、変換評価レポートのコピーを PDF ファイルまたはカンマ区切り値 (CSV) ファイルとして保存できます。

AWS Management Console
PDF レポート
変換評価レポートを PDF ファイルとして保存するには
  1. [エクスポート] をクリックして、[PDF] を選択します。ダイアログボックスを確認して、[PDF にエクスポート] を選択します。

  2. DMS Schema Conversion は、移行プロジェクトの Amazon S3 S3 バケットに PDF ファイルを保存します。

  3. Amazon S3 バケットにある評価レポートファイルを開きます。

CSV エクスポート
変換評価レポートを CSV ファイルとして保存するには
  1. [エクスポート] をクリックして、[CSV] を選択します。ダイアログボックスを確認して、[CSV にエクスポート] を選択します。

  2. DMS Schema Conversion は、移行プロジェクトの Amazon S3 S3 バケットに CSV ファイルを含む ZIP アーカイブを保存します。

  3. Amazon S3 バケットから ZIP アーカイブをダウンロードして抽出し、CSV ファイルにアクセスします。

S3 バケットとファイル名

DMS Schema Conversion がエクスポートされたレポートを保存する Amazon S3 バケットは、移行プロジェクトの作成時に S3 バケットアクセス設定で指定したバケットです。

ファイルは、移行プロジェクト名に一致するフォルダに保存されます。からエクスポートする場合 AWS マネジメントコンソール、ファイルはソースエンジン、ターゲットエンジン、UTC タイムスタンプを使用して名前が付けられます。project-name/SOURCE_ENGINE_TARGET_ENGINE_YYYY-MM-DDTHH-MM-SS.sssZたとえば、 ですora-pg-demo/ORACLE_POSTGRESQL_2026-07-01T09-00-47.846Z.pdf

CSV アーカイブには、2 レベルのディレクトリパスに整理された少なくとも 3 つのファイルが含まれています。最上位ディレクトリは、ソースデータプロバイダー (ホスト名または IP アドレス) で設定されたとおりのソースサーバー名です。サブディレクトリとファイル名は、ターゲットデータベースのホスト名を使用します。

  • source-server/target-host/target-host.csv — アクション項目の出現ごとに 1 行。

  • source-server/target-host/target-host_Action_Items_Summary.csv — アクション項目タイプごとに 1 行、エフォート値。

  • source-server/target-host/target-host_Summary.csv — オブジェクトタイプごとに 1 行、複雑さカウント。

  • source-server/target-host/target-host_Stub_Objects.csv — サポートされていない組み込み用に生成されたスタブオブジェクトごとに 1 行。このファイルは、移行プロジェクト設定でサポートされていない組み込みオブジェクトをスタブオブジェクトに変換するが有効になっている場合にのみ存在します。

AWS CLI

次の例では、export-metadata-model-assessment を使用して、移行プロジェクトの変換評価レポートを PDF ファイルと CSV アーカイブの両方として Amazon S3 バケットにエクスポートします。

aws dms export-metadata-model-assessment \ --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \ --selection-rules '{"rules":[{"rule-type":"selection","rule-id":"1","rule-name":"1","rule-action":"explicit","object-locator":{"server-name":"source-server","schema-name":"ExampleSchema"}}]}' \ --assessment-report-types pdf csv
注記

--selection-rules パラメータは、レポートに含めるデータベースオブジェクトを指定する JSON 文字列を取得します。完全な選択ルールの JSON 構造については、「」を参照してくださいDMS Schema Conversion の選択ルール

レスポンスには、各レポートファイルの Amazon S3 オブジェクトキーとダウンロード URL が含まれます。

を指定しない場合--file-name、ファイルは、ファイル名としてタイムスタンプ project-name/YYYY-MM-DD-HH-MM-SS.pdfおよび を使用して、移行プロジェクト名に一致するフォルダに保存されます。project-name/YYYY-MM-DD-HH-MM-SS.zipたとえば、 ですsqlserver-pg-pma/2026-07-15-10-08-12.zip。を指定--file-nameして、そのフォルダ内のタイムスタンププレフィックスを上書きします。

{ "PdfReport": { "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.pdf", "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.pdf" }, "CsvReport": { "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.zip", "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.zip" } }
注記

変換評価レポートは、明示的な評価を実行した後だけでなく、変換オペレーションを実行した後にも利用できます。変換後、レポートは、依然として手動アクションを必要とするオブジェクトを反映し、生成 AI を使用して DMS Schema Conversion が変換したオブジェクトをマークします。変換の実行については、「」を参照してくださいデータベーススキーマの変換: step-by-stepガイド

DMS Schema Conversion の変換評価レポートの表示

変換評価レポートを表示するには、次のいずれかの方法を使用します。

重要

変換評価レポートは、最新の評価または変換オペレーションの範囲に含まれていたデータベースオブジェクトのみを対象としています。評価または変換の実行時に選択されなかったオブジェクトは、ソースデータベースに存在する場合でもレポートに表示されません。

新しい評価または変換オペレーションごとに、前のレポートが上書きされます。概要アクション項目のタブには、常に最新のオペレーションのみが反映されます。現在のレポートの結果を保持する必要がある場合は、新しい評価または変換を実行する前に PDF ファイルまたは CSV ファイルとしてエクスポートします。エクスポート手順については、「」を参照してください評価レポートの保存

AWS Management Console

評価または変換を実行すると、DMS Schema Conversion は次のタブに情報を追加します。

  • [概要]

  • アクション項目

概要タブ

概要タブには、変換評価レポートの概要情報が表示されます。DMS Schema Conversion がデータベースストレージオブジェクトとデータベースコードオブジェクトに対して自動的に変換できるデータベースオブジェクトの数を示します。

DMS Schema Conversion は、多くのデータベースオブジェクトを自動的に変換し、ターゲットデータベースエンジンへの変換を完了するために手動アクションを必要とするオブジェクトを識別します。概要タブには、ソースのデータベースオブジェクトと同等のデータベースオブジェクトをターゲット DB インスタンスに作成するために必要な労力の見積もりが表示されます。

テーブル、シーケンス、制約、データ型などのデータベースストレージオブジェクトの変換の概要を確認するには、[データベースストレージオブジェクト] をクリックします。

プロシージャ、関数、ビュー、トリガーなどのデータベースコードオブジェクトの変換の概要を確認するには、[データベースコードオブジェクト] をクリックします。

評価レポートの範囲を変更するには、ソースデータベースツリーで必要なノードを選択します。選択した範囲に応じて、DMS Schema Conversion は評価レポートの概要を更新します。

[Action Items] (アクション項目) タブ

アクション項目タブには、DMS Schema Conversion がターゲットデータベースエンジンと互換性のある形式に自動的に変換できないデータベースオブジェクトのアクション項目のリストが含まれています。DMS Schema Conversion は、アクション項目ごとに問題の説明と推奨アクションを提供しています。DMS Schema Conversion では、類似のアクション項目がグループ化されて、発生回数が表示されます。

関連するデータベースオブジェクトのコードを表示するには、リスト内のアクション項目を選択します。

生成 AI

生成 AI を備えた DMS Schema Conversion は、一般的に複雑な手動変換を必要とする、事前に変換されていないコードオブジェクトの変換に役立つ推奨事項を提供することで、データベース移行プロセスを合理化します。現在、この機能はソースデータベースとして Oracle、SQL Server、SAP ASE (Sybase ASE)、IBM Db2 for LUW、IBM Db2 for z/OS で使用でき、PostgreSQL または Aurora PostgreSQL に変換されます。

評価レポートには、生成 AI を使用した変換の候補となるデータベースコードオブジェクトが表示されます。このレポートを PDF にエクスポートして、アクション項目ごとに 5 つのオブジェクトの短いリストを取得できます。レポートを CSV ファイルにエクスポートして、候補の完全なリストを表示できます。

生成 AI を使用してスキーマを変換を有効にし、変換を実行すると、更新された評価レポートによって、各データベースオブジェクトが対応するアクション項目としてマークされます。生成 AI を使用して正常に変換されたオブジェクトと、生成 AI が変換できなかったオブジェクトの両方がマークされるため、AI アシスト変換の結果を簡単に特定して追跡できます。

生成 AI によって変換されたオブジェクトをすばやく見つけるには

  1. [アクション項目] タブに移動します。

  2. 右上にあるドロップダウンメニューを見つけます。

  3. オプションから [AI によって生成] を選択します。

このフィルタリング方法を使用すると、この機能を使用して正常に変換されたすべてのデータベースオブジェクトを効率的に表示できます。生成 AI によるデータベースオブジェクトの変換の詳細については、「」を参照してください生成 AI 変換の範囲

PDF report

PDF レポートには、次の 4 つの章がこの順序で含まれています。

  • エグゼクティブサマリー — 移行の複雑さの概要。DMS Schema Conversion が自動的に変換できるデータベースオブジェクトの数と、手動アクションを必要とする数を、オブジェクトタイプ (テーブル、ビュー、プロシージャ、トリガーなど) および複雑さカテゴリ (自動変換、シンプルなアクション、中程度の複雑さのアクション、複雑なアクション) 別に分類して表示します。これらのカテゴリの詳細については、「」を参照してください複雑さのカテゴリ

  • 変換アクションを含むデータベースオブジェクト — オブジェクトタイプ別に整理された、手動アクションが必要な特定のデータベースオブジェクトの内訳。各エントリはオブジェクトを名前で識別し、アクション項目コードを一覧表示します。

  • 生成 AI による変換の候補 — DMS Schema Conversion が生成 AI を使用した自動変換の候補として識別するデータベースオブジェクト。PDF には、アクション項目タイプごとに最大 5 つの候補オブジェクトが一覧表示されます。候補の完全なリストを表示するには、レポートを CSV としてエクスポートします。

  • 移行の詳細な推奨事項 — 手動アクションを必要とするすべてのデータベースオブジェクトのオブジェクトごとの分析。この章では、オブジェクトごとに、アクション項目コード (「」を参照アクション項目コード)、ターゲットデータベースエンジンとの特定の非互換性の説明、推奨される手動変換アクションを示します。すべてのオブジェクト間でアクション項目をタイプ別にグループ化する のアクション項目タブとは異なり、この章では影響を受ける各オブジェクトを個別に一覧表示します。 AWS マネジメントコンソール

レポートを PDF としてエクスポートするには、「」を参照してください評価レポートの保存

CSV report

評価レポートを CSV にエクスポートすると、DMS Schema Conversion は少なくとも 3 つの CSV ファイルを含むアーカイブを作成します。アーカイブは 2 レベルのディレクトリ構造を使用します。最上位ディレクトリはソースデータプロバイダー (ホスト名または IP アドレス) で設定されているとおりのソースサーバー名であり、サブディレクトリとファイル名はターゲットデータベースのホスト名を使用します。

アクション項目ファイル (target-host.csv)

メイン CSV ファイル (サフィックスなし) には、アクション項目の発生ごとに 1 行が含まれます。これには、次の列が含まれます。

  • カテゴリ — アクション項目が適用されるデータベースオブジェクトのタイプ。 procedureや などview-constraint

  • 発生 — など、アクション項目が影響する特定のデータベースオブジェクトインスタンスへの完全修飾パスSchemas.schema_name.Procedures.procedure_name

  • アクション項目 — 変換問題のタイプを識別する数値アクション項目コード。詳細については、「アクション項目コード」を参照してください。

  • 件名 — 未解決の識別子など、アクション項目が参照する特定のデータベースオブジェクト名またはコード要素。アクション項目が特定のオブジェクト名を参照していない場合、このフィールドは空です。

  • グループ — そのアクション項目コードが発生するたびに共有される問題タイプの一般的な説明。DMS Schema Conversion はこの値を使用して、関連する出現をグループ化します。

  • 説明 — この出現に対する特定の非互換性の詳細な説明。

  • ドキュメントリファレンス — 非互換性を解決するための関連ドキュメントへのリンク。

  • 推奨されるアクション — 非互換性を解決するために推奨される手動変換ステップ。

  • フィルタリング済み — アクション項目がレポートビューからフィルタリングされたかどうかを示します。

  • 推定複雑さ — この出現に割り当てられた複雑さカテゴリ: 自動変換、単純なアクション、中程度の複雑さのアクション、または複雑なアクション。

  • Line — 非互換性が発生するソースオブジェクトのコードの行番号。

  • 位置 — 非互換性が発生する行の文字位置。

  • ソース — ソースデータベースエンジン。

  • Target — ターゲットデータベースエンジン。

  • サーバーの IP アドレスとポート — ソースデータベースサーバーのホストとポート。

  • データベース名 — ソースデータベースの名前。

  • スキーマ名 — 影響を受けるオブジェクトを含むソーススキーマの名前。

  • AI/ML レコメンデーション — 生成 AI 変換が有効になり、この出現の結果が生成された場合に、このオブジェクトを変換するための生成 AI レコメンデーション。

アクション項目の概要ファイル (target-host_Action_Items_Summary.csv)

以下の列を含むアクション項目タイプごとに 1 行が含まれます。

  • スキーマ — 影響を受けるオブジェクトを含むソーススキーマの名前。

  • アクション項目 — 変換問題のタイプを識別する数値アクション項目コード。詳細については、「アクション項目コード」を参照してください。

  • 発生回数 — このアクション項目タイプの影響を受けるデータベースオブジェクトの総数。

  • 学習曲線の労力 — このアクション項目タイプの変換アプローチを設計するために必要な 1 回限りの労力。このコストは、出現回数に関係なく、アクション項目タイプごとに 1 回発生します。値は、低 (最小エフォート) から高 (最大エフォート) までの加重スケールを使用します。

  • 出現を変換する労力 — 設計された変換アプローチに従って、このアクション項目タイプの個々の出現を解決するために必要な労力。値は、学習曲線の取り組みと同じ加重スケールを使用します。

  • アクション項目の説明 — このアクション項目タイプが表す非互換性の説明。

  • 推奨アクション — このアクション項目タイプを解決するための推奨手動変換ステップ。

概要ファイル (target-host_Summary.csv)

次の列を含むデータベースオブジェクトタイプごとに 1 行が含まれます。

  • カテゴリ — 行が要約するデータベースオブジェクトタイプ。、、、TABLEVIEWPROCEDURETRIGGERINDEXCONSTRAINTSEQUENCE、、または などFUNCTION。ファイルには、CategoryStorage_objects_countCode_objects_countまたは の値を持つ集計メトリクス行も含まれますSQL_syntax_elements_number。これらの集計値の詳細については、「」を参照してください変換統計と SQL メトリクス

  • オブジェクトの数 — 評価対象スコープ内のこのタイプのデータベースオブジェクトの総数。

  • オブジェクトの自動変換 — DMS Schema Conversion が手動アクションなしで変換できるオブジェクトの数。

  • シンプルなアクションを持つオブジェクト — 変換に少量の手動作業を必要とするオブジェクトの数。

  • 中程度の複雑さのアクションを持つオブジェクト — 変換に中程度の手動作業を必要とするオブジェクトの数。

  • 複雑なアクションを持つオブジェクト — 変換に多大な手動作業を必要とするオブジェクトの数。

  • コード行の合計 — このタイプのすべてのオブジェクトのソースコード行の合計数。

レポートを CSV としてエクスポートするには、「」を参照してください評価レポートの保存

スタブオブジェクトファイル (target-host_Stub_Objects.csv)

このファイルは、移行プロジェクト設定でサポートされていない組み込みオブジェクトをスタブオブジェクトに変換するが有効になっている場合にのみ存在します。サポートされていない組み込み用に生成されたスタブオブジェクトごとに 1 行が含まれ、次の列が含まれます。

  • カテゴリ — など、スタブオブジェクトのタイプscalar-function

  • スタブオブジェクト名 — スキーマと署名を含む、生成されたスタブの完全修飾名。

  • 出現回数 — このスタブオブジェクトが変換されたコードで参照される回数。