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

# 移行プロジェクトのスキーマ変換設定の指定
<a name="schema-conversion-settings"></a>

スキーマ変換設定では、DMS Schema Conversion がソースデータベースオブジェクトをターゲット互換 SQL に変換する方法と、スキーマ変換ビューに表示されるスキーマとデータベースの 2 つの要素をカスタマイズできます。すべての変換パスに適用される設定については、以下のセクションで説明します。変換パスに固有の設定については、ナビゲーションの対応するトピックを参照してください。

## 一般的な変換設定
<a name="schema-conversion-settings-common"></a>

次の 2 つの設定は、すべての変換パスに適用されます。各設定には、 AWS マネジメントコンソール ラベルの後に API および CLI AWS パラメータ名が括弧内に表示されます。

**変換された SQL コードのコメント** (`ShowSeverityLevelInSql`)  
DMS Schema Conversion が変換された SQL 出力にコメントを挿入するアクション項目の最小重要度レベルを制御します。選択したレベル以上のアクション項目のみがコメントを受け取ります。  
**値:**  


<table>
<thead>
  <tr><th>コンソールラベル</th><th>API/CLI 値</th><th>コメントを受け取るアクション項目</th></tr>
</thead>
<tbody>
  <tr><td><b>エラーのみ</b></td><td><code>CRITICAL</code></td><td>オブジェクトの動作を妨げる重大なエラー</td></tr>
  <tr><td><b>エラーおよび警告</b></td><td><code>HIGH</code></td><td>重大なエラーと重大度の高い警告</td></tr>
  <tr><td rowspan="3"><b>すべてのメッセージ</b></td><td><code>MEDIUM</code></td><td>重大度が重大、高、中程度のアクション項目</td></tr>
  <tr><td><code>LOW</code></td><td>情報メモを除くすべてのアクション項目</td></tr>
  <tr><td><code>INFO</code></td><td>情報メモを含むすべてのアクション項目</td></tr>
</tbody>
</table>

**デフォルト**: `CRITICAL`

**生成 AI を使用してスキーマを変換する** (`EnableGenAiConversion`)  
有効にすると、DMS Schema Conversion は生成 AI モデルを使用して、ルールベースのロジックでは処理できない SQL コンストラクトを変換します。これにより、手動解決が必要なアクション項目の数が減少します。  
**タイプ:** ブール値 (`true` \| `false`)  
**デフォルト**: `false`  
DMS Schema Conversion の生成 AI 機能は、サポートされている AWS リージョンでのみ使用できます。プライマリリージョンがサポートされていない場合、この設定は効果がありません。サポートされているリージョンとクロスリージョン推論ルーティングのリストについては、「」を参照してください[DMS Schema Conversion でのクロスリージョン推論](CHAP_Security.DataProtection.CrossRegionInference.md#CHAP_Security.DataProtection.CrossRegionInference.SchemaConversion)。
生成 AI 変換は、特定の変換パスでのみサポートされます。サポートされているパスと範囲内の SQL 要素のリストについては、「」を参照してください[生成 AI を使用したデータベースオブジェクトの変換](schema-conversion-convert.databaseobjects.md)。

## ツリービューの設定
<a name="schema-conversion-settings-treeview"></a>

ツリービューの設定は、他のスキーマ変換設定とは異なります。変換された SQL は変更されません。代わりに、スキーマ変換ビューのソースデータベースペインとターゲットデータベースペインに表示されるスキーマとデータベースを制御します。これにより、変換対象として選択できる内容が決まります。ツリービュー設定は、すべての変換パスに適用されます。

**重要**  
ツリービューの設定は、 でのみ設定できます AWS マネジメントコンソール。 AWS Database Migration Service API または CLI AWS で設定することはできません。

ツリービューの設定は、**設定**ページの**ツリービュー**セクションで行います。このページを開くには、 AWS マネジメントコンソール 「」の手順に従います[設定の変更](#schema-conversion-settings-cli)。次に、**ツリービュー**を選択します。ソースペインとターゲットペインには、以下の各コントロールを個別に設定します。

**空のスキーマを非表示にする**  
オブジェクトを含まないスキーマを非表示にします。このコントロールを選択して、ペインから空のスキーマを削除します。これにより、変換するオブジェクトがあるスキーマに集中できます。  
**デフォルト:** 選択済み。このコントロールをクリアしない限り、DMS Schema Conversion は空のスキーマを非表示にします。

**システムデータベースまたはスキーマ**  
選択したシステムデータベースまたはスキーマを非表示にします。DMS Schema Conversion は、ソースエンジンまたはターゲットエンジンの共通システムオブジェクトのリストを提供します。非表示にするものを選択します。  
PostgreSQL ソースの場合、リストには `pg_catalog`や などのオブジェクトが含まれます`information_schema`。MySQL ターゲットの場合、リストには `mysql`や などのオブジェクトが含まれます`performance_schema`。  
**デフォルト:** DMS Schema Conversion は、ソースエンジンまたはターゲットエンジンの標準システムオブジェクトを事前に選択します。

**ユーザー定義データベースまたはスキーマ**  
名前を入力するデータベースまたはスキーマを非表示にします。2 つ以上の名前をカンマで区切ります。パーセント記号 (%) をワイルドカードとして使用して、データベースまたはスキーマ名の任意の文字数に一致させます。  
**デフォルト:** なし。

## 設定の変更
<a name="schema-conversion-settings-cli"></a>

**注記**  
同じプロジェクトでスキーマ変換オペレーションが実行されている間は、設定を変更できません。

------
#### [ AWS マネジメントコンソール ]

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/dms/v2/](https://console.aws.amazon.com/dms/v2/) で AWS DMS コンソールを開きます。

1. ナビゲーションペインで **[移行プロジェクト]** を選択します。

1. 移行プロジェクトを選択します。

1. **[スキーマ変換]** を選択して、**[スキーマ変換を起動]** をクリックします。

1. スキーマ変換ビューで、**設定**を選択します。

1. **[変換]** セクションで、設定を変更します。

1. **適用**を選択し、**スキーマ変換**を選択してスキーマビューに戻ります。

------
#### [ AWS CLI ]

[`modify-conversion-configuration`](https://docs.aws.amazon.com/cli/latest/reference/dms/modify-conversion-configuration.html) コマンドを使用します。設定をネストされた JSON オブジェクトとして `--conversion-configuration`パラメータに渡します。一般的な設定`"Common project settings"`や などの変換パス固有の名前など、セクション名を最上位キーとして使用します`"MSSQL_TO_POSTGRESQL_15"`。セクション名を最上位キーとして指定しないフラット JSON 構造は無効です。

**注記**  
変換設定は、次の方法で `--conversion-configuration`に渡すことができます。これは、任意の文字列パラメータで動作する標準の AWS CLI 機能です。  
**インライン:** `--conversion-configuration '{"Common project settings":{...}}'` (JSON 二重引用符からエスケープしないように一重引用符を使用)
**相対パス:** `--conversion-configuration file://settings.json`
**絶対パス:** `--conversion-configuration file:///tmp/settings.json`

完全な JSON 構造は次のようになります。

```
{
  "Common project settings": {
    "ShowSeverityLevelInSql": "CRITICAL",
    "EnableGenAiConversion": false
  },
  "{{conversion_path_section_name}}": {
    "SettingName": value,
    ...
  }
}
```

変更するセクションとキーのみを含めます。[`modify-conversion-configuration`](https://docs.aws.amazon.com/cli/latest/reference/dms/modify-conversion-configuration.html) コマンドは、指定された値を既存の設定とマージします。次の例では、 `ShowSeverityLevelInSql`を に設定します`HIGH`。

```
aws dms modify-conversion-configuration \
      --migration-project-identifier {{migration_project_arn}} \
      --conversion-configuration '{
        "Common project settings": {
          "ShowSeverityLevelInSql": "HIGH"
        }
      }'
```

------

**Topics**
+ [一般的な変換設定](#schema-conversion-settings-common)
+ [ツリービューの設定](#schema-conversion-settings-treeview)
+ [設定の変更](#schema-conversion-settings-cli)
+ [Oracle から MySQL へのコンバージョン設定](schema-conversion-oracle-mysql.md)
+ [Oracle から PostgreSQL へのコンバージョン設定](schema-conversion-oracle-postgresql.md)
+ [Oracle から Amazon Redshift への変換設定](schema-conversion-oracle-redshift.md)
+ [SQL Server から MySQL へのコンバージョン設定](schema-conversion-sql-server-mysql.md)
+ [SQL Server から PostgreSQL へのコンバージョン設定](schema-conversion-sql-server-postgresql.md)
+ [MySQL から PostgreSQL への変換設定](schema-conversion-mysql-postgresql.md)
+ [PostgreSQL から MySQL への変換設定](schema-conversion-postgresql-mysql.md)
+ [IBM Db2 for LUW から Amazon RDS for PostgreSQL への変換設定](schema-conversion-db2-luw-postgresql.md)
+ [IBM Db2 for z/OS から Amazon RDS for Db2 への変換設定](schema-conversion-db2-zos-db2.md)
+ [IBM Db2 for z/OS から Amazon RDS for PostgreSQL への変換設定](schema-conversion-db2-zos-postgresql.md)
+ [SAP ASE (Sybase ASE) から PostgreSQL への変換設定](schema-conversion-sybase-ase.md)