Data Transmission Service:DTS の移行タスクまたは同期タスクにおける ETL の設定

既存の同期タスクで ETL 設定を変更するには、次のものが含まれます。

• ETL が設定されていない既存の同期タスクがある場合 (つまり、同期タスクの作成時に ETL 機能の設定 が いいえ に設定されていた場合)、いいえ を ○ に変更して DSL スクリプトを設定できます。

• ETL がすでに設定されている場合は、既存の DSL スクリプトを変更するか、ETL 機能の設定 を いいえ に設定できます。

  重要

  • 既存の DSL スクリプトを編集するには、まず同期オブジェクトを選択中のオブジェクトからソースオブジェクトに戻し、選択中のオブジェクトに再度追加してから DSL スクリプトを編集します。

  • 移行タスクでは DSL スクリプトの変更はサポートされていません。

注意事項

• 既存の同期タスクで ETL 設定を変更しても、ターゲットデータベースのテーブルスキーマの変更はサポートされません。スキーマを変更するには、同期タスクを開始する前にターゲットデータベースで変更してください。

• ETL 設定を変更すると、データリンクが中断される可能性があります。注意して進めてください。

• ETL 設定の変更は、タスクの再起動後に処理される増分データにのみ適用されます。変更前に処理された既存データには影響しません。

• DSL スクリプトは、データ変換とクリーニング操作のみを処理します。データベースオブジェクトの作成はサポートしていません。

• DSL スクリプトで参照されるフィールドは、ソースデータベースに存在し、どのフィルター条件によっても除外されていない必要があります。そうしないと、タスクが失敗する可能性があります。

• DSL スクリプトでは、大文字と小文字が区別されます。データベース名、テーブル名、フィールド名は、ソースデータベースのものと完全に一致する必要があります。

• DSL スクリプトは複数の式をサポートしていません。複数の式を 1 つにまとめるには、e_compose 関数を使用します。

• ソースデータベースのすべてのテーブルからのすべての DML 変更は、DSL 処理後に同一の列情報を生成する必要があります。そうしないと、タスクが失敗する可能性があります。たとえば、e_set 関数を使用して列を追加する場合、ソースデータベースからの INSERT、UPDATE、DELETE 操作がすべて、ターゲットテーブルで同じ追加列を生成するようにしてください。詳細については、「データ変更時刻の記録」をご参照ください。

データ処理 DSL は、データ同期シナリオにおけるデータ処理のために DTS が特別に設計したスクリプト言語です。条件関数をサポートし、文字列、日付、数値を処理できるため、以下の特徴を持つデータ処理ロジックを柔軟に定義できます。

• 強力な機能：多くの関数を提供し、関数の組み合わせをサポートします。

• 比較的シンプルな構文：データフィルタリング、変換、マスキングなどの一般的なシナリオの例が含まれています。詳細については、「一般的なシナリオ例」をご参照ください。

• 高い実行効率：コード生成技術を使用して、同期プロセスへのパフォーマンスへの影響を最小限に抑えます。

定数と変数

• 定数

  タイプ	例
  int	123
  float	123.4
  string	"hello1_world"
  boolean	true または false
  datetime	DATETIME('2021-01-01 10:10:01')

• 変数

  変数	説明	データの型	値の例
  __TB__	テーブル名	string	table
  __DB__	データベース名	string	mydb
  __OPERATION__	操作タイプ	string	__OP_INSERT__, __OP_UPDATE__, __OP_DELETE__
  __BEFORE__	UPDATE 操作の変更前の値 (pre-image) 説明 DELETE 操作には変更前の値のみがあります。	特殊マーカー、型なし	v(`column_name`,__BEFORE__)
  __AFTER__	UPDATE 操作の変更後の値 (post-image) 説明 INSERT 操作には変更後の値のみがあります。	特殊マーカー、型なし	v(`column_name`,__AFTER__)
  __COMMIT_TIMESTAMP__	トランザクションのコミット時刻	datetime	'2021-01-01 10:10:01'
  `column`	レコードの指定された列の値	string	`id`, `name`

式関数

• 数値演算

  関数	構文	有効値	戻り値	例
  加算	op_sum(value1, value2)	value1: 整数または浮動小数点数 value2: 整数または浮動小数点数	両方のパラメーターが整数の場合は整数を返し、それ以外の場合は浮動小数点数を返します。	op_sum(`col1`, 1.0)
  減算	op_sub(value1, value2)	value1: 整数または浮動小数点数 value2: 整数または浮動小数点数	両方のパラメーターが整数の場合は整数を返し、それ以外の場合は浮動小数点数を返します。	op_sub(`col1`, 1.0)
  乗算	op_mul(value1, value2)	value1: 整数または浮動小数点数 value2: 整数または浮動小数点数	両方のパラメーターが整数の場合は整数を返し、それ以外の場合は浮動小数点数を返します。	op_mul(`col1`, 1.0)
  部門	op_div_true(value1, value2)	value1: 整数または浮動小数点数 value2: 整数または浮動小数点数	両方のパラメーターが整数の場合は整数を返し、それ以外の場合は浮動小数点数を返します。	op_div_true(`col1`, 2.0); col1=15 の場合、7.5 を返します。
  剰余演算	op_mod(value1, value2)	value1: 整数または浮動小数点数 value2: 整数または浮動小数点数	両方のパラメーターが整数の場合は整数を返し、それ以外の場合は浮動小数点数を返します。	op_mod(`col1`, 10); col1=23 の場合、3 を返します。

• 論理演算

  関数	構文	有効な値	戻り値	例
  等価性チェック	op_eq(value1, value2)	value1: 整数、浮動小数点数、または文字列 value2: 整数、浮動小数点数、または文字列	ブール値：true または false	op_eq(`col1`, 23)
  より大きいかどうかのチェック	op_gt(value1, value2)	value1: 整数、浮動小数点数、または文字列 value2: 整数、浮動小数点数、または文字列	ブール値：true または false	op_gt(`col1`, 1.0)
  より小さい	op_lt(value1, value2)	value1: 整数、浮動小数点数、または文字列 value2: 整数、浮動小数点数、または文字列	ブール値：true または false	op_lt(`col1`, 1.0)
  以上かどうかのチェック	op_ge(value1, value2)	value1: 整数、浮動小数点数、または文字列 value2: 整数、浮動小数点数、または文字列	ブール値：true または false	op_ge(`col1`, 1.0)
  以下かどうかのチェック	op_le(value1, value2)	value1: 整数、浮動小数点数、または文字列 value2: 整数、浮動小数点数、または文字列	ブール値：true または false	op_le(`col1`, 1.0)
  AND 演算	op_and(value1, value2)	value1: ブール値 value2: ブール値	ブール値：true または false	op_and(`is_male`, `is_student`)
  OR 演算	op_or(value1, value2)	value1: ブール値 value2: ブール値	ブール値：true または false	op_or(`is_male`, `is_student`)
  IN 演算	op_in(value, json_array)	value: 任意の型 json_array: JSON 形式の文字列	ブール値：true または false	op_in(`id`,json_array('["0","1","2","3","4","5","6","7","8"]'))
  値が null かどうかをチェック	op_is_null(value)	value: 任意の型	ブール値：true または false	op_is_null(`name`)
  値が null でないかどうかをチェック	op_is_not_null(value)	value: 任意の型	ブール値：true または false	op_is_not_null(`name`)

• 文字列関数

  関数	構文	値の範囲	戻り値	例
  文字列の連結	op_add(str_1,str_2,...,str_n)	str_1: 文字列 str_2: 文字列 ... str_n: 文字列	連結された文字列	op_add(`col`,'hangzhou','dts')
  文字列のフォーマットと連結	str_format(format, value1, value2, value3, ...)	format: 中括弧をプレースホルダーとして使用する文字列、例："part1: {}, part2: {}" value1: 任意の型 value2: 任意の型	フォーマットされた文字列	str_format("part1: {}, part2: {}", `col1`, `col2`); col1="ab" かつ col2="12" の場合、"part1: ab, part2: 12" を返します。
  文字列の置換	str_replace(original, oldStr, newStr, count)	original: 元の文字列 oldStr: 置換する文字列 newStr: 置換後の文字列 count: 整数、最大置換回数。すべての出現箇所を置換する場合は -1 を設定します。	置換された文字列	str_replace(`name`, "a", 'b', 1); name="aba" の場合、"bba" を返します。str_replace(`name`, "a", 'b', -1); name="aba" の場合、"bbb" を返します。
  すべての文字列型フィールド (varchar、text、char など) の値を置換	tail_replace_string_field(search, replace, all)	search: 置換する文字列 replace: 置換後の文字列 all: すべての一致を置換するかどうか。現在、true のみをサポートしています。 説明 すべての一致を置換したくない場合は、str_replace 関数を使用してください。	置換された文字列	tail_replace_string_field('\u000f', '', true) は、文字列型フィールド値のすべての "\u000f" をスペースに置き換えます。
  文字列の先頭と末尾から指定された文字を削除	str_strip(string_val, charSet)	string_val: 元の文字列 char_set: 削除する文字のセット	先頭と末尾の文字が削除された文字列	str_strip(`name`, 'ab'); name=axbzb の場合、xbz を返します。
  文字列を小文字に変換	str_lower(value)	value: 文字列の列または文字列リテラル	小文字の文字列	str_lower(`str_col`)
  文字列を大文字に変換	str_upper(value)	value: 文字列の列または文字列リテラル	大文字の文字列	str_upper(`str_col`)
  文字列を数値に変換	cast_string_to_long(value)	value: 文字列	整数	cast_string_to_long(`col`)
  数値を文字列に変換	cast_long_to_string(value)	value: 整数	文字列	cast_long_to_string(`col`)
  部分文字列の出現回数をカウント	str_count(str,pattern)	str: 文字列の列または文字列リテラル pattern: 検索する部分文字列	部分文字列が出現する回数	str_count(`str_col`, 'abc'); str_col="zabcyabcz" の場合、2 を返します。
  部分文字列の位置を検索	str_find(str, pattern)	str: 文字列の列または文字列リテラル pattern: 検索する部分文字列	最初の一致の位置。見つからない場合は `-1` を返します	str_find(`str_col`, 'abc'); `str_col="xabcy"` の場合、`1` を返します。
  文字列が文字のみで構成されているかチェック	str_isalpha(str)	str: 文字列の列または文字列リテラル	true または false	str_isalpha(`str_col`)
  文字列が数字のみで構成されているかチェック	str_isdigit(str)	str: 文字列の列または文字列リテラル	true または false	str_isdigit(`str_col`)
  正規表現のマッチング	regex_match(str,regex)	str: 文字列の列または文字列リテラル regex: 正規表現の文字列の列または文字列リテラル	true または false	regex_match(__TB__,'user_\\d+')
  データマスキングのために文字列の一部を指定された文字でマスクします。たとえば、電話番号の最後の 4 桁をアスタリスクに置き換えます	str_mask(str, start, end, maskStr)	str: 文字列の列または文字列リテラル start: 整数、マスキングの開始位置 (最小値 0) end: 整数、マスキングの終了位置 (最大値は文字列の長さマイナス 1) maskStr: 単一文字の文字列、例：'#'	開始位置から終了位置までの文字がマスクされた文字列	str_mask(`phone`, 7, 10, '#')
  cond の後の文字列の一部を抽出	substring_after(str, cond)	str: 元の文字列 cond: 文字列	文字列 説明 結果には cond は含まれません。	substring_after(`col`, 'abc')
  cond の前の文字列の一部を抽出	substring_before(str, cond)	str: 元の文字列 cond: 文字列	文字列 説明 結果には cond は含まれません。	substring_before(`col`, 'efg')
  cond1 と cond2 の間の文字列の一部を抽出	substring_between(str, cond1, cond2)	str: 元の文字列 cond1: 文字列 cond2: 文字列	文字列 説明 結果には cond1 も cond2 も含まれません。	substring_between(`col`, 'abc','efg')
  値が文字列型かどうかをチェック	is_string_value(value)	value: 文字列または列名	ブール値：true または false	is_string_value(`col1`)
  文字列型フィールドの内容を置換します。末尾から逆順に開始します	tail_replace_string_field(search, replace, all)	search: 置換する文字列 replace: 置換後の文字列 all: すべて置換するかどうか。true または false	置換された文字列	すべての文字列フィールド値の "\u000f" をスペースに置き換えます。 tail_replace_string_field('\u000f','',true)
  MongoDB のフィールドの値を取得	bson_value("field1","field2","field3",...)	field1: トップレベルのフィールド名 field2: 第 2 レベルのフィールド名	ドキュメント内の指定されたフィールドの値	e_set(`user_id`, bson_value("id")) e_set(`user_name`, bson_value("person","name"))

グローバル関数

• フロー制御関数

  関数	構文	パラメーター	例
  if 文	e_if(bool_expr, func_invoke)	bool_expr：ブール定数または関数呼び出し。 定数： true または false。 関数呼び出しの例： op_gt(`id`, 10)。 func_invoke：関数呼び出し。 サポートされる関数： e_drop、e_keep、e_set、e_if、e_compose	e_if(op_gt(`id`, 10), e_drop()); ID > 10 の場合、レコードを破棄します。
  if-else 文	e_if_else(bool_expr, func_invoke1, func_invoke2)	bool_expr：ブール定数または関数呼び出し。 定数： true または false。 関数呼び出しの例： op_gt(`id`, 10)。 func_invoke1：条件が true の場合に実行される関数呼び出し。 func_invoke2：条件が false の場合に実行される関数呼び出し。	e_if_else(op_gt(`id`, 10), e_set(`tag`, 'large'), e_set(`tag`, 'small')); ID > 10 の場合、タグを "large" に設定し、それ以外の場合は "small" に設定します。
  複数の条件を評価し、最初に一致した操作を実行する Switch に似た文です。 一致する条件がない場合は、デフォルトの操作を実行します。	s_switch(condition1, func1, condition2, func2, ..., default=default_func)	condition1：ブール定数または関数呼び出し。 定数： true または false。 関数呼び出しの例： op_gt(`id`, 10)。 func_invoke：関数呼び出し。 condition1 をチェックし、true の場合はこの関数を実行して switch 文を終了します。 false の場合は、次の条件をチェックします。 default_func：すべての条件が false の場合に実行される関数呼び出し。	e_switch(op_gt(`id`, 100), e_set(`str_col`, '>100'), op_gt(`id`, 90), e_set(`str_col`, '>90'), default=e_set(`str_col`, '<=90')).
  複数の操作を組み合わせる	e_compose(func1, func2, func3, ...)	func1：関数呼び出し。 e_set、e_drop、e_if が指定可能です。 func2：関数呼び出し。 e_set、e_drop、e_if が指定可能です。	e_compose(e_set(`str_col`, 'test'), e_set(`dt_col`, dt_now())); str_col を "test" に設定し、dt_col を現在の時間に設定します。

• データ操作関数

  関数	構文	パラメーター	例
  このレコードを破棄する (同期しない)	e_drop()	なし	e_if(op_gt(`id`, 10), e_drop()); ID > 10 のレコードを破棄します。
  このレコードを保持する (送信先に同期する)	e_keep(condition)	condition：ブール式	e_keep(op_gt(id, 1)); ID > 1 のレコードのみを同期します。
  列の値を設定する	e_set(`col`, val, NEW)	col：列名 val：定数または関数呼び出し。 col のデータの型と一致する必要があります。 NEW：col を val のデータの型に変換します (オプション)。 重要 NEW を省略する場合は、その前のカンマを含めないでください。 タスクエラーを避けるために、データの型の互換性を確認してください。	e_set(`dt_col`, dt_now()); dt_col を現在の時間に設定します。 e_set(`col1`, `col2` + 1); col1 を col2 + 1 に設定します。 e_set(`col1`, 1, NEW); col1 を数値型に変換し、1 に設定します。
  MongoDB のフィールド保持、フィールド破棄、およびフィールド名マッピング	e_expand_bson_value('*', 'fieldA',{"fieldB":"fieldC"})	*：保持するフィールド名。* はすべてのフィールドを意味します。 fieldA：破棄するフィールド名。 {"fieldB":"fieldC"}：フィールド名のマッピング。fieldB はソースフィールド名、fieldC は送信先フィールド名です。 説明 フィールド名のマッピングはオプションです。	e_expand_bson_value("*", "_id,name"); _id と name を除くすべてのフィールドを送信先に書き込みます。