翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 変換ルールおよび変換アクション 選択したスキーマ、テーブルまたはビューに適用する変換を指定するには、変換アクションを使用します。変換ルールはオプションです。 ## 制限事項 + 同じオブジェクト (スキーマ、テーブル、列、テーブルとテーブルスペース、またはインデックスとテーブルスペース) に対して複数の変換ルールアクションを適用することはできません。各変換アクションが異なるオブジェクトに対して適用される限り、複数の変換ルールアクションを任意のレベルに適用できます。ただし、同じ列に対して `ADD-COLUMN` または `CHANGE-DATA-TYPE` のような別の変換を実行できるデータマスキング変換ルールを使用する場合、この制限は適用されません。 + 変換ルールのテーブル名と列名では大文字と小文字が区別されます。例えば、Oracle データベースまたは Db2 データベースのテーブル名と列名は大文字で指定する必要があります。 + 右から左へ記述する言語の列名の変換はサポートされていません。 + 変換は、名前に特殊文字 (\#、\\、/、-など) を含む列では実行できません。 + BLOB データ型 や CLOB データ型にマップされた列に対してサポートされている変換は、ターゲットでの列の削除のみです。 + AWS DMS では、2 つのソーステーブルを 1 つのターゲットテーブルにレプリケートすることはできません。 は、 AWS DMS レプリケーションタスクの変換ルールに従って、テーブル間、および列間でレコードをレプリケートします。重複を避けるため、オブジェクト名は一意である必要があります。 例えば、ソーステーブルに `ID` という名前の列があり、対応するターゲットテーブルには `id` という既存の列があるとします。ルールで `ADD-COLUMN` ステートメントを使用して `id` という新しい列を追加し、SQLite ステートメントを使用してその列にカスタム値を設定すると、`id` という名前の重複したあいまいなオブジェクトが作成されます。これはサポートされません。 + 変換ルールを作成する場合、`column-name` を `%` に設定するときなど、選択ルールが複数の列を指定する場合にのみ、`data-type` パラメータを使用することをお勧めします。単一の列を選択するために `data-type` を使用することはお勧めしません。 + AWS DMS は、ソースオブジェクトとターゲットオブジェクト (テーブル) が同じデータベース/スキーマにある変換ルールをサポートしていません。変換ルールでソースとターゲットの両方と同じテーブルを使用すると、テーブルデータへの意図しない変更、テーブル構造の変更、テーブルの削除など、有害になりうる予想外の結果をもたらす可能性があります。 ## 値 変換ルールタイプを使用するテーブルマッピングルールの場合、次の値を適用できます。 | パラメータ | 使用できる値: | 説明 | | --- | --- | --- | | rule-type | transformation | 選択ルールにより指定された各オブジェクトにルールを適用する値。特に明記されていない限り、transformation を使用します。 | | rule-id | 数値。 | ルールを識別する一意の数値。同じオブジェクト (スキーマ、テーブル、列、テーブル間スペース、インデックステーブルスペース) に複数の変換ルールを指定すると、 は変換ルールに下位の rule-id AWS DMS を適用します。 | | rule-name | 英数字値。 | ルールを特定する一意な名前。 | | object-locator | 以下のパラメータを使用するオブジェクト。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Transformations.html) | ルールが適用される各スキーマ、テーブルまたはビュー、テーブルのテーブルスペース、インデックスのテーブルスペース、および列の名前。`data-type` を除く各 `object-locator` パラメータの値のすべてあるいは一部で、「%」パーセント記号をワイルドカードとして使用できます。したがって、これらの項目には以下を対応させることができます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Transformations.html)
また、`table-tablespace-name` あるいは `index-tablespace-name` パラメータは、Oracle ソースのエンドポイントと一致させるためのみに使用できます。`table-tablespace-name` または `index-tablespace-name` を単一のルールで指定できますが、両方を指定することはできません。したがって、以下の項目の*いずれか*を一致させることができます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Transformations.html) | | rule-action | `add-column`, `include-column`, `remove-column`
`rename`
`convert-lowercase`, `convert-uppercase`
`add-prefix`, `remove-prefix`, `replace-prefix`
`add-suffix`, `remove-suffix`, `replace-suffix`
`define-primary-key`
`change-data-type`
`add-before-image-columns`
`data-masking-digits-mask`
`data-masking-digits-randomize`
`data-masking-hash-mask` | オブジェクトに適用する変換。すべて変換ルールアクションでは、大文字と小文字が区別されます。
`rule-action` パラメータの `add-column` 値は、テーブルに列を追加します。ただし、同じテーブルの既存の列と同じ名前の新しい列を追加することはできません。
`data-type` パラメータおよび `expression` パラメータとともに使用すると、`add-column` は新しい列データの値を指定します。
`rule-action` の `change-data-type` の値は、`column` ルールターゲットに対してのみ使用できます。
`include-column` パラメータの`rule-action`の値により、テーブルのモードを*[drop all columns by default]*(デフォルトですべての列を削除する)と*[include the columns specified]*(指定した列を含める)に変更します。複数の列は、`include-column` ルールを複数回呼び出してターゲットに含まれます。
ルールのスキーマ名またはテーブル名にワイルドカード (`%`) が含まれている場合は `define-primary-key` は使用できない。
既存のタスクの場合、`remove-column`、`rename`、`add-prefix` などのターゲットテーブルスキーマを変更する変換ルールアクションは、タスクを再開するまで有効になりません。変換ルールを追加した後でタスクを再開すると、変更した列で列データが欠落するなど、予期しない動作が発生する可能性があります。変換ルールが正しく動作するには、タスクを再起動する必要があります。
`data-masking-digits-mask`、`data-masking-digits-randomize`、`data-masking-hash-mask` は、ターゲットにロードするときにテーブルの 1 つ以上の列に含まれる機密情報をマスクするためのものです。これらの変換は、列ルールターゲットでのみ使用できます。詳細については、「[データマスキングを使用して機密情報を非表示にする](CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Masking.md)」を参照してください。 | | rule-target | schema, table, column, table-tablespace, index-tablespace | 変換するオブジェクトのタイプ。`table-tablespace` および `index-tablespace` の値は、Oracle ターゲットエンドポイントでのみ使用できます。
`object-locator`: `table-tablespace-name` または `index-tablespace-name` 名の一部として指定するパラメータの値を指定してください。 | | value | ターゲットタイプの名前付けルールに従った英数字値。 | 入力が必要なアクションの新しい値 (rename など)。 | | old-value | ターゲットタイプの名前付けルールに従った英数字値。 | 置き換えが必要なアクションの古い値 (replace-prefix など)。 | | data-type | `type` – `rule-action` が `add-column` である場合に使用するデータ型、または `rule-action` が `change-data-type` である場合は置換データ型。
または、`rule-action` が `change-data-type`、`column-name` の値が `"%"`、かつ既存のデータ型を識別するための追加の `data-type` パラメータが `object-locator` に含まれる場合の置換データ型の名前。
AWS DMS は、次の DMS データ型の列データ型変換をサポートしています。 `"bytes", "date", "time", "datetime", "int1", "int2", "int4", "int8", "numeric", "real4", "real8", "string", "uint1", "uint2", "uint4", "uint8", "wstring", "blob", "nclob", "clob", "boolean", "set", "list" "map", "tuple"` AWS DMS は、サポートされている形式で、あるタイプから別の ONLY への変換を適用できます。例: DATE は `YYYY:MM:DD/YYYY-MM-DD.` で表す必要があります。DATETIME は `YYYY:MM:DD HH:MM:SS/YYYY-MM-DD HH:MM:SS` で表す必要があります。TIME は `HH:MM:SS` で表す必要があります。
`precision` - 追加された列または置換データ型に精度がある場合は、精度を指定する整数値。
`scale` – 追加された列または置換データ型に位取り、整数の値、または日時の値がある場合、位取りを指定する整数値
`length` – 新しい列データの長さ (`add-column` と共に使用する場合) | 次は、置換する既存のデータ型を指定する `data-type` パラメータの例です。
{
	"rules": [{
			"rule-type": "selection",
			"rule-id": "1",
			"rule-name": "1",
			"object-locator": {
				"schema-name": "%",
				"table-name": "%"
			},
			"rule-action": "include"
		},
		{
			"rule-type": "transformation",
			"rule-id": "2",
			"rule-name": "2",
			"rule-target": "column",
			"object-locator": {
				"schema-name": "test",
				"table-name": "table_t",
				"column-name": "col10"
			},
			"rule-action": "change-data-type",
			"data-type": {
				"type": "string",
				"length": "4092",
				"scale": ""
			}
		}
	]
}

ここでは、`table_t` テーブルの `col10` 列が `string` データ型に変更されます。 | | expression | SQLite 構文に続く英数字の値。 | `rule-action` を `rename-schema` に設定して使用すると、`expression` パラメータは新しいスキーマを指定します。`rule-action` を `rename-table` に設定して使用すると、`expression` は新しいテーブルを指定します。`rule-action` を `rename-column` に設定して使用すると、`expression` は新しい列の値を指定します。
`rule-action` を `add-column` に設定して使用すると、`expression` は新しい列を構成するデータを指定します。
このパラメータでは式のみがサポートされていることに注意する。演算子とコマンドはサポートされない。
変換ルールに式を使用する方法の詳細については、「[変換ルール式を使用した列の内容の定義](CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Expressions.md)」をご参照ください。
SQLite 式の詳細については、「[SQLite 関数を使用して式を構築する](CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Expressions.md#CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Expressions-SQLite)」を参照。 | | primary-key-def | 以下のパラメータを使用するオブジェクト。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Transformations.html) | このパラメータでは、変換されたテーブルまたはビューの一意のキーの名前、タイプ、内容を定義できます。rule-action が define-primary-key に設定され、rule-target が table に設定されている場合にこの処理を行います。デフォルトでは、一意のキーはプライマリキーとして定義されます。 | | before-image-def | 以下のパラメータを使用するオブジェクト。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Transformations.html) | このパラメータは、前イメージ列を識別するための命名規則を定義し、ターゲット上に作成された前イメージ列を持つことができるソース列を識別するためのフィルターを指定します。`rule-action` が `add-before-image-columns` に設定され、`rule-target` が `column` に設定されている場合に、このパラメータを指定できます。
`column-prefix` と `column-suffix` の両方を空の文字列に設定しないでください。
[`column-filter`] では以下を選択します。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Transformations.html) `before-image-def` パラメータは、CLOB や BLOB などのラージバイナリオブジェクト (LOB) データ型をサポートしていません。データ型が LOB に設定されている場合、テーブルに void 列が作成されます。
AWS DMS ターゲットエンドポイントの前イメージのサポートの詳細については、以下をご参照ください:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/CHAP_Tasks.CustomizingTasks.TableMapping.SelectionTransformation.Transformations.html) | ## 例 **Example スキーマの名前変更** 以下の例では、スキーマの名前をソースでの `Test` からターゲットでの `Test1` に変更します。 ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "Test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "rename", "rule-target": "schema", "object-locator": { "schema-name": "Test" }, "value": "Test1" } ] } ``` **Example テーブル名の変更** 以下の例では、テーブルの名前をソースでの `Actor` からターゲットでの `Actor1` に変更します。 ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "Test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "rename", "rule-target": "table", "object-locator": { "schema-name": "Test", "table-name": "Actor" }, "value": "Actor1" } ] } ``` **Example 列名の変更** 以下の例では、テーブル `Actor` の列の名前をソースでの `first_name` からターゲットでの `fname` に変更します。 ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "4", "rule-name": "4", "rule-action": "rename", "rule-target": "column", "object-locator": { "schema-name": "test", "table-name": "Actor", "column-name" : "first_name" }, "value": "fname" } ] } ``` **Example Oracle テーブルのテーブルスペースの名前変更** 次の例では、Oracle ソースの `Actor` という名前のテーブルの `SetSpace` という名前のテーブルのテーブルスペースを、Oracle のターゲットエンドポイントで `SceneTblSpace` に名前変更します。 ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "Play", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "rename", "rule-target": "table-tablespace", "object-locator": { "schema-name": "Play", "table-name": "Actor", "table-tablespace-name": "SetSpace" }, "value": "SceneTblSpace" } ] } ``` **Example Oracle インデックスのテーブルスペースの名前変更** 以下の例では、Oracle ソースの `Actor` という名前のテーブルの `SetISpace` という名前のインデックスのテーブルスペースを、Oracle のターゲットエンドポイントで `SceneIdxSpace` に名前変更します。 ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "Play", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "rename", "rule-target": "table-tablespace", "object-locator": { "schema-name": "Play", "table-name": "Actor", "table-tablespace-name": "SetISpace" }, "value": "SceneIdxSpace" } ] } ``` **Example 列の追加** 次の例では、スキーマ `test` のテーブル `Actor` に `datetime` 列を追加します。 ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "add-column", "rule-target": "column", "object-locator": { "schema-name": "test", "table-name": "actor" }, "value": "last_updated", "data-type": { "type": "datetime", "precision": 6 } } ] } ``` **Example 列の削除** 以下の例では、ソース内の `Actor` という名前のテーブルを変換し、先頭文字が `col` のすべての列をターゲットから削除します。 ``` { "rules": [{ "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "remove-column", "rule-target": "column", "object-locator": { "schema-name": "test", "table-name": "Actor", "column-name": "col%" } }] } ``` **Example [Convert to lowercase] (小文字に変換)** 以下の例では、テーブルの名前をソースでの `ACTOR` からターゲットでの `actor` に変換します。 ``` { "rules": [{ "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "convert-lowercase", "rule-target": "table", "object-locator": { "schema-name": "test", "table-name": "ACTOR" } }] } ``` **Example 大文字への変換** 次の例では、すべてのテーブルおよびすべてのスキーマ内のすべての列を、ソースでの小文字からターゲットでの大文字に変換します。 ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "convert-uppercase", "rule-target": "column", "object-locator": { "schema-name": "%", "table-name": "%", "column-name": "%" } } ] } ``` **Example プレフィックスの追加** 以下の例では、ソース内のすべてのテーブルを変換し、ターゲットではそれらのテーブルにプレフィックス `DMS_` を追加します。 ``` { "rules": [{ "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "add-prefix", "rule-target": "table", "object-locator": { "schema-name": "test", "table-name": "%" }, "value": "DMS_" }] } ``` **Example プレフィックスの置き換え** 以下の例では、ソースでプレフィックス `Pre_` を含むすべての列を変換し、ターゲットではプレフィックスを `NewPre_` に置き換えます。 ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "replace-prefix", "rule-target": "column", "object-locator": { "schema-name": "%", "table-name": "%", "column-name": "%" }, "value": "NewPre_", "old-value": "Pre_" } ] } ``` **Example サフィックスの削除** 以下の例では、ソース内のすべてのテーブルを変換し、ターゲットではそれらのテーブルからサフィックス `_DMS` を削除します。 ``` { "rules": [{ "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "test", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "remove-suffix", "rule-target": "table", "object-locator": { "schema-name": "test", "table-name": "%" }, "value": "_DMS" }] } ``` **Example プライマリキーの定義** 次の例では、ターゲットエンドポイントに移行した `ITEM` テーブルの 3 つの列の `ITEM-primary-key` という名前のプライマリキーを定義します。 ``` { "rules": [{ "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "inventory", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "define-primary-key", "rule-target": "table", "object-locator": { "schema-name": "inventory", "table-name": "ITEM" }, "primary-key-def": { "name": "ITEM-primary-key", "columns": [ "ITEM-NAME", "BOM-MODEL-NUM", "BOM-PART-NUM" ] } }] } ``` **Example 一意のインデックスの定義** 次の例では、ターゲットエンドポイントに移行した `ITEM` テーブルの 3 つの列の `ITEM-unique-idx` という名前の一意のインデックスを定義します。 ``` { "rules": [{ "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "inventory", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-action": "define-primary-key", "rule-target": "table", "object-locator": { "schema-name": "inventory", "table-name": "ITEM" }, "primary-key-def": { "name": "ITEM-unique-idx", "origin": "unique-index", "columns": [ "ITEM-NAME", "BOM-MODEL-NUM", "BOM-PART-NUM" ] } }] } ``` **Example ターゲット列のデータ型の変更** 次の例では、`SALE_AMOUNT` という名前のターゲット列のデータ型を既存のデータ型から `int8` に変更します。 ``` { "rule-type": "transformation", "rule-id": "1", "rule-name": "RuleName 1", "rule-action": "change-data-type", "rule-target": "column", "object-locator": { "schema-name": "dbo", "table-name": "dms", "column-name": "SALE_AMOUNT" }, "data-type": { "type": "int8" } } ``` **Example 前イメージ列の追加** `emp_no` という名前のソース列の場合、次の例の変換ルールによって、ターゲットに `BI_emp_no` という名前の新しい列が追加されます。 ``` { "rules": [{ "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "%", "table-name": "%" }, "rule-action": "include" }, { "rule-type": "transformation", "rule-id": "2", "rule-name": "2", "rule-target": "column", "object-locator": { "schema-name": "%", "table-name": "employees" }, "rule-action": "add-before-image-columns", "before-image-def": { "column-prefix": "BI_", "column-suffix": "", "column-filter": "pk-only" } } ] } ``` ここでは、次のステートメントは、対応する行の `BI_emp_no` 列に 1 を代入します。 ``` UPDATE employees SET emp_no = 3 WHERE BI_emp_no = 1; ``` サポートされている AWS DMS ターゲットに CDC 更新を書き込む場合、 `BI_emp_no`列では、どの行が`emp_no`列の値を更新したかを判断できます。