コンテンツにスキップ

変換処理の使い方

カラムマッピング設定の「変換手順」から選べる24種類の用途と設定例です。各画面はサンプルデータによる実際の設定・プレビューです。画像をクリックすると、このページ内で拡大表示します。画像・背景・右上の「×」をクリックするか、Escキーで閉じると、元の閲覧位置に戻ります。

操作と例の読み方

  1. 「元の値」で対象のソースカラムを選びます。
  2. 各画像の 1 の一覧から処理を選び、「追加」をクリックします。
  3. 手順の行を選択し、2 の「処理の設定」を下記の表に合わせます。「…」は値や条件の設定画面を開きます。
  4. 「出力する値」で、この手順の結果を選びます。
  5. サンプル入力の型と値を表の例に合わせ、3 の「変換を確認」をクリックします。
  6. 「OK」でマッピング画面に反映し、マッピング画面の「保存」で保存します。

表の VALUE = "abc" は、参照先がVALUEの行で「入力の型」を「文字列」、「サンプル入力」を abc にする意味です。VALUE = や引用符は入力しません。結果に付く引用符も画面の表示用です。

サンプル入力の表記と実際の操作

表記 実際の操作
"abc" 入力の型は「文字列」、サンプル入力は abc だけ。
"" 入力の型は「文字列」、サンプル入力は空欄。引用符2個は入力しません。
" " 入力の型は「文字列」、半角スペースを3個入力。
NULL 入力の型で「NULL」を選択。サンプル入力は空欄。文字列の NULL とは異なります。
123 数値として試す場合は入力の型を「数値」、値を 123 にします。

入力欄によって、バックスラッシュの扱いが異なります。 サンプル入力・固定値では、\t や \n を実際のタブ・改行へ変換しません。Tabキーはセル移動に使われます。改行を含む値の確認は、実際の改行を含む入力データを用意して行ってください。

入力欄 記述例と意味
サンプル入力・固定値 \t はバックスラッシュとtの2文字、\n はバックスラッシュとnの2文字。
正規表現置換・正規表現抽出の検索欄 \t はタブ、\n は改行(LF)に一致。\s+ は連続する空白文字に一致。
正規表現置換の置換後の文字列 $1 は1番目の取得グループ。\t・\n はタブ・改行に変換しません。

共通の「入力する値」「結果名」「有効」は手順と出力の設定で説明しています。各設定表は処理固有の項目を掲載します。「…」から固定値を指定するときは、取得方法を「固定値」、型を文字列・数値など、値を表の内容に設定します。

処理一覧

処理 用途
空白・NULLの置換 NULL、空文字、スペースやタブのみの値を、指定した値に置き換えます。
空白除去 名称やコードの前後に付いた不要な空白を取り除きます。
大文字化 英字コードの表記を大文字に統一します。
小文字化 メールアドレスのドメインや英字識別子の表記を小文字にそろえます。
左埋め 桁数の異なるコードの左側を0などで埋めます。
右埋め 固定長の出力に向けて、文字列の右側を埋めます。
文字列置換 電話番号のハイフンなど、決まった文字列を置き換えます。
正規表現置換 連続する空白や文字のパターンをまとめて置換します。
部分文字列 コードの決まった位置から必要な文字数を取り出します。
正規表現抽出 接頭辞付きコードなどから、パターンに合う部分を取り出します。
文字列結合 複数の列、固定値、変換した結果を一つの文字列にします。
文字列分割 区切られた文字列から、指定位置の項目を一つ取得します。
型変換 文字列の数値を計算に使える数値などへ変換します。
日時変換 日付の書式、時差、日付の加算を設定します。
四則演算 単価×数量など、二つの値で計算します。
丸め 小数点以下の桁数をそろえて数値を丸めます。
切上げ 数値以上で最も小さい整数にします。
切捨て 数値以下で最も大きい整数にします。
条件による切替 条件によって、出力する値を切り替えます。
コード変換 システム間で異なる区分コードを変換します。
最初のNULL以外の値 複数の候補から、最初に見つかったNULLでない値を採用します。
条件判定 条件の成立・不成立を真偽値として出力します。
マスキング 名前・電話番号・コードなどの一部または全体を、指定した文字で隠します。
ハッシュ化 入力を固定長のハッシュ文字列へ変換し、同じ値を照合するための識別子にします。

空白・NULLの置換

NULL、空文字、スペースやタブなどの空白文字だけの値を、指定した値に置き換えます。対象は個別に選択できます。

空白・NULLの置換の設定と確認結果

設定方法

「置換する対象」でNULL・空文字・空白のみを複数選択します。新規追加時は3つとも選択されています。「置換後の値」の「…」で取得方法を「固定値」、型を「文字列」、値を「未設定」にします。ソース列・BIND変数・前の変換結果も指定できます。

対象 判定する値
NULL 値がない状態。文字列の "NULL" とは異なります。
空文字 文字数0の文字列 ""。
空白のみ 1文字以上のスペース・タブ・改行などだけの文字列。空文字は含みません。
設定項目 設定例
置換後の値(列・変換結果も指定可) 固定値: 未設定

確認例

サンプル入力 最終結果
VALUE = NULL "未設定"
VALUE = 空文字(入力の型は「文字列」、入力欄は空欄) "未設定"
VALUE = 半角スペース3個 "未設定"
VALUE = "ABC" "ABC"

空白・NULLの置換の詳細設定

子画面の 1 で取得方法・参照先・固定値の型・値を設定し、2 の「OK」で戻ります。ソースカラムとBIND変数は参照先の一覧から選択します。固定値では参照先を使いません。

注意点

選択した対象だけを置き換え、それ以外の値は変更しません。対象は1つ以上選択してください。選択した対象には同じ置換後の値を使用します。対象ごとに異なる値を使う場合は、対象を分けた複数の手順を追加します。

対象を1つだけ選択する設定例

NULLだけを置換

該当する対象だけをチェックします。

NULLだけを置換

置換後の値の設定

入力 結果
NULL "未設定"

空文字だけを置換

該当する対象だけをチェックします。

空文字だけを置換

置換後の値の設定

入力 結果
"" "未入力"

空白のみを置換

該当する対象だけをチェックします。

空白のみを置換

置換後の値の設定

入力 結果
" " "未入力"

空白除去

名称やコードの前後に付いた不要な空白を取り除きます。

空白除去の設定と確認結果

設定方法

「空白除去の位置」で両端・先頭・末尾を選びます。例では「両端」にします。

設定項目 設定例
空白除去の位置 両端

確認例

サンプル入力 最終結果
VALUE = " abc " "abc"

注意点

文字列の途中の空白は残します。先頭・末尾のタブや改行も空白除去の対象です。大文字化も必要なら、後の手順の入力にこの結果を指定します。

大文字化

英字コードの表記を大文字に統一します。

大文字化の設定と確認結果

設定方法

「入力する値」に大文字化する列または変換結果を指定します。大文字化専用の追加オプションはありません。

処理固有の設定項目はありません。入力する値と出力先の手順を確認してください。

確認例

サンプル入力 最終結果
VALUE = "Abc-01" "ABC-01"

注意点

数値や記号はそのままです。ロケールを指定する項目はなく、ロケールに依存しない大文字化を行います。NULLはNULLのままです。

小文字化

メールアドレスのドメインや英字識別子の表記を小文字にそろえます。

小文字化の設定と確認結果

設定方法

「入力する値」に対象の列または変換結果を指定します。小文字化専用の追加オプションはありません。

処理固有の設定項目はありません。入力する値と出力先の手順を確認してください。

確認例

サンプル入力 最終結果
VALUE = "Abc-01" "abc-01"

注意点

変換する範囲は入力値全体です。メールアドレスの一部だけを変換したい場合は、必要な部分の抽出・変換・結合を組み合わせます。NULLはNULLのままです。

左埋め

桁数の異なるコードの左側を0などで埋めます。

左埋めの設定と確認結果

設定方法

「出力文字数」を5、「埋める文字(1文字)」を 0 にします。

設定項目 設定例
出力文字数 5
埋める文字(1文字) 0

確認例

サンプル入力 最終結果
VALUE = "7" "00007"

注意点

出力文字数は追加する文字数ではなく、埋めた後の全体の長さです。埋める文字は1文字です。入力が指定長以上なら切り詰めません。先頭0を残す出力には文字列型を使用します。 入力欄は1文字に制限され、複数文字の貼り付けは受け付けません。未入力では確認・保存できません。半角スペース1文字も指定できます。

右埋め

固定長の出力に向けて、文字列の右側を埋めます。

右埋めの設定と確認結果

設定方法

「出力文字数」を5、「埋める文字(1文字)」を _ にします。

設定項目 設定例
出力文字数 5
埋める文字(1文字) _

確認例

サンプル入力 最終結果
VALUE = "AB" "AB___"

注意点

入力が指定長以上の場合はそのままです。空白で埋める場合は、埋める文字に実際のスペース1文字を入力します。文字数による指定で、バイト数による指定ではありません。 入力欄は1文字に制限され、複数文字の貼り付けは受け付けません。未入力では確認・保存できません。半角スペース1文字も指定できます。

文字列置換

電話番号のハイフンなど、決まった文字列を置き換えます。

文字列置換の設定と確認結果

設定方法

「検索文字の値」を固定文字列 -、「置換後の値」を固定文字列の空欄にします。検索文字や置換後の値には列・前の変換結果も選べます。

設定項目 設定例
検索文字の値 固定値: -
置換後の値 固定値:
大文字小文字を区別しない False

確認例

サンプル入力 最終結果
VALUE = "090-1234-5678" "09012345678"

文字列置換の詳細設定

子画面の 1 で取得方法・参照先・固定値の型・値を設定し、2 の「OK」で戻ります。ソースカラムとBIND変数は参照先の一覧から選択します。固定値では参照先を使いません。

注意点

該当するすべての箇所を置換します。検索文字は正規表現として解釈しません。「大文字小文字を区別しない」で照合方法を切り替えます。検索文字を空文字にすることはできません。

正規表現置換

連続する空白や文字のパターンをまとめて置換します。

正規表現置換の設定と確認結果

設定方法

「検索文字・正規表現」に \s+、「置換後の文字列」に - を入力します。画面にはバックスラッシュを1文字入力します。

設定項目 設定例
検索文字・正規表現 \s+
置換後の文字列 -
大文字小文字を区別しない False

確認例

サンプル入力 最終結果
VALUE = "AB 12 CD" "AB-12-CD"

下記をコピーし、参照先VALUEの「サンプル入力」に貼り付けてください。「入力の型」は「文字列」にします。この例は半角スペースだけを使用し、タブは含みません。

AB  12   CD

ABと12の間は半角スペース2個、12とCDの間は3個です。「検索文字・正規表現」には \s+ をそのまま入力します。バックスラッシュは1個です。「置換後の文字列」に - を入力して「変換を確認」を押すと、AB-12-CD になります。

掲載画面でバックスラッシュが円記号のように見える箇所も、実際の文字は半角バックスラッシュ(U+005C)です。このページの \s+ をコピーして使用してください。全角の円記号とは異なります。

注意点

例では連続する半角スペースを、それぞれハイフン1文字にします。\s+ は実際のタブや改行などの空白文字にも一致します。サンプル入力に \t や \n の2文字を入力しても、タブや改行にはなりません。.NETの正規表現です。置換文字列では $1 などで取得グループを参照できます。無効なパターンや処理時間の超過は変換エラーになります。

部分文字列

コードの決まった位置から必要な文字数を取り出します。

部分文字列の設定と確認結果

設定方法

「開始位置の値」を固定数値5、「文字数の値」を固定数値5にします。それぞれ列・前の変換結果から指定することもできます。

設定項目 設定例
開始位置の値 固定値: 5
文字数の値 固定値: 5
取得範囲が文字数を超えた場合 エラーにする(初期値)/NULLを返す

確認例

サンプル入力 最終結果
VALUE = "ABC-12345" "12345"

部分文字列の詳細設定

子画面の 1 で取得方法・参照先・固定値の型・値を設定し、2 の「OK」で戻ります。ソースカラムとBIND変数は参照先の一覧から選択します。固定値では参照先を使いません。

注意点

開始位置は1から数えます。有効な開始位置で文字数0を指定すると空文字を返します。指定範囲が入力文字数を超える場合は、「取得範囲が文字数を超えた場合」の設定に従います。末尾までの自動短縮はしません。

例えば、ABC に開始位置1・文字数5を指定すると、初期値の「エラーにする」では変換エラー、「NULLを返す」ではNULLになります。NULLは後続の「空白・NULLの置換」で任意の値に置き換えられます。

この選択は範囲不足だけに適用します。開始位置が0以下、文字数が負数などの設定不備はエラーです。画面の「変換失敗時」は、ここで「エラーにする」を選んだ場合のエラーや、ほかの変換エラーに適用されます。

正規表現抽出

接頭辞付きコードなどから、パターンに合う部分を取り出します。

正規表現抽出の設定と確認結果

設定方法

検索に ORDER-(\d+)、取得グループに1を設定します。括弧内の数字部分を取り出します。

設定項目 設定例
検索文字・正規表現 ORDER-(\d+)
大文字小文字を区別しない False
取得グループ(0は全体) 1

確認例

サンプル入力 最終結果
VALUE = "ORDER-12345" "12345"

注意点

最初の一致を使用します。グループ0は一致全体、1以降は括弧で取得したグループです。一致しない場合、指定グループがない場合、そのグループが一致しない場合はエラーです。

文字列結合

複数の列、固定値、変換した結果を一つの文字列にします。

文字列結合の設定と確認結果

設定方法

「結合する値」の「…」を開き、VALUE、GIVEN_NAMEの順にソースカラムを指定します。「区切り文字」には実際の半角スペース1文字を入力します。

設定項目 設定例
結合する値 2 設定
区切り文字
NULLの要素を除外する True

確認例

サンプル入力 最終結果
VALUE = "Sato"
GIVEN_NAME = "Hanako"
"Sato Hanako"

文字列結合の詳細設定

子画面の 1 で取得方法・参照先・固定値の型・値を設定し、2 の「OK」で戻ります。ソースカラムとBIND変数は参照先の一覧から選択します。固定値では参照先を使いません。

注意点

値の一覧の上から順に結合します。区切り文字を空欄にすると文字を挿入せず連結します。「NULLの要素を除外する」がTrueならNULLだけを除外し、空文字は残します。FalseでNULLが一つでもある場合は結果がNULLです。

文字列分割

区切られた文字列から、指定位置の項目を一つ取得します。

文字列分割の設定と確認結果

設定方法

「区切り文字」を ,、「取得位置」を2にします。

設定項目 設定例
区切り文字 ,
取得位置(1から) 2
指定位置の項目がない場合 エラーにする(初期値)/NULLを返す

確認例

サンプル入力 最終結果
VALUE = "A,B,C" "B"

注意点

取得位置は1から数えます。空の項目も位置に含めます。A,,C の2番目は空文字です。区切り文字は正規表現ではなく文字列です。行や列を増やす処理ではありません。

例えば、aaa_bbb を _ で区切って3番目を取得すると、「指定位置の項目がない場合」が「エラーにする」では変換エラー、「NULLを返す」ではNULLになります。NULLは後続の「空白・NULLの置換」で任意の値に置き換えられます。存在する空の項目は、この選択にかかわらず空文字のままです。

取得位置が0以下、区切り文字が空などの設定不備はエラーです。画面の「変換失敗時」は、ここで「エラーにする」を選んだ場合のエラーや、ほかの変換エラーに適用されます。

型変換

文字列の数値を計算に使える数値などへ変換します。

型変換の設定と確認結果

設定方法

「変換先の型」を「数値」、ロケールを en-US、桁区切りを許可する設定をTrueにします。サンプルの入力の型は「文字列」です。

設定項目 設定例
変換先の型 数値
ロケール(空欄は標準) en-US
数値の桁区切りを許可 True

確認例

サンプル入力 最終結果
VALUE = "1,234.50" 1234.50

注意点

文字列・数値・真偽値・日時・NULLを選べます。ロケール空欄は標準形式です。真偽値には true、false、1、0 を使えます。日時型を選ぶと入力書式やタイムゾーンの項目が表示されます。日時を指定書式の文字列にする場合は「日時変換」を使います。

日時変換

日付の書式、時差、日付の加算を設定します。

日時変換の設定と確認結果

設定方法

入力書式の種類を「書式指定」、入力書式を yyyyMMdd、日付のみをTrueにします。出力方法は「文字列」、出力書式は yyyy-MM-dd にします。

設定項目 設定例
ロケール(空欄は標準) 空欄
入力書式の種類 書式指定
入力書式 yyyyMMdd
日付のみ True
入力タイムゾーン UTC
出力タイムゾーン Keep
出力方法 文字列
出力書式 yyyy-MM-dd
加算する年数 0
加算する月数 0
加算する日数 0
加算する時間 0
加算する分数 0
加算する秒数 0

確認例

サンプル入力 最終結果
VALUE = "20240401" "2024-04-01"

出力書式の設定

入力と出力の設定は同じ「処理の設定」内にあります。右側をスクロールして出力方法・出力書式を設定します。

日時の加算項目

年・月・日・時・分・秒の順で加算し、その後に出力タイムゾーンへ変換します。減算は負数を指定します。例:加算する日数を 1 にすると翌日です。

UTCから日本時間への変換

時差変換の例:入力 2024-04-01T00:00:00Z、出力タイムゾーン Tokyo Standard Time、出力書式 yyyy-MM-dd HH:mm:sszzz で 2024-04-01 09:00:00+09:00 になります。入力にZや時差がある場合はその情報を優先し、ない場合に入力タイムゾーンを使用します。Keepは入力の時差を維持します。Zを末尾に付ける出力にはUTCを指定してください。夏時間で存在しない時刻や二通りに解釈できる時刻はエラーです。

注意点

書式の MM は月、mm は分、HH は24時間です。候補以外の書式も入力できます。「日時型」で出力する場合は出力書式を使いません。日付のみでは出力タイムゾーンをKeepにし、時・分・秒の加算は0にします。

四則演算

単価×数量など、二つの値で計算します。

四則演算の設定と確認結果

設定方法

元の値VALUEを単価とし、「演算」を「乗算」にします。「相手の値」の「…」で取得方法「ソースカラム」、参照先QUANTITYを選択します。

設定項目 設定例
演算 乗算
相手の値 QUANTITY

確認例

サンプル入力 最終結果
VALUE = 1200
QUANTITY = 3
3600

四則演算の詳細設定

子画面の 1 で取得方法・参照先・固定値の型・値を設定し、2 の「OK」で戻ります。ソースカラムとBIND変数は参照先の一覧から選択します。固定値では参照先を使いません。

注意点

加算・減算・乗算・除算・剰余を選べます。引き算・割り算は「入力する値 − 相手の値」「入力する値 ÷ 相手の値」の順です。NULLを含む計算はNULLです。ゼロによる除算・剰余や数値範囲の超過はエラーになります。

丸め

小数点以下の桁数をそろえて数値を丸めます。

丸めの設定と確認結果

設定方法

「小数桁数の値」を固定数値2、「丸め方式」を「四捨五入」にします。桁数には列や前の変換結果も使えます。

設定項目 設定例
小数桁数の値 固定値: 2
丸め方式 四捨五入

確認例

サンプル入力 最終結果
VALUE = 123.455 123.46

丸めの詳細設定

子画面の 1 で取得方法・参照先・固定値の型・値を設定し、2 の「OK」で戻ります。ソースカラムとBIND変数は参照先の一覧から選択します。固定値では参照先を使いません。

注意点

小数桁数は0〜28です。四捨五入は中間値をゼロから遠ざかる方向へ丸めます。偶数丸めは中間値の末尾を偶数にします。例:123.445を2桁にすると、四捨五入は123.45、偶数丸めは123.44です。

切上げ

数値以上で最も小さい整数にします。

切上げの設定と確認結果

設定方法

「入力する値」に数値列または計算結果を指定します。切上げ専用の追加オプションはありません。

処理固有の設定項目はありません。入力する値と出力先の手順を確認してください。

確認例

サンプル入力 最終結果
VALUE = 12.3 13

注意点

小数第何位かを指定する処理ではなく、整数への切上げです。負数の -12.3 は -12 です。常に正の無限大方向へ丸めます。

切捨て

数値以下で最も大きい整数にします。

切捨ての設定と確認結果

設定方法

「入力する値」に数値列または計算結果を指定します。切捨て専用の追加オプションはありません。

処理固有の設定項目はありません。入力する値と出力先の手順を確認してください。

確認例

サンプル入力 最終結果
VALUE = 12.9 12

注意点

小数部分を単に取り除く処理とは異なり、常に負の無限大方向へ丸めます。負数の -12.3 は -13 です。小数桁数を指定した丸めには「丸め」を使います。

条件による切替

条件によって、出力する値を切り替えます。

条件による切替の設定と確認結果

設定方法

「条件設定」の「…」で左の値を「元の値」、比較方法を「より大きい」、右の値を固定数値0にします。成立時は固定文字列「在庫あり」、不成立時は「在庫なし」にします。

設定項目 設定例
条件設定 比較条件
成立時の値 固定値: 在庫あり
不成立時の値 固定値: 在庫なし

確認例

サンプル入力 最終結果
VALUE = 3 "在庫あり"

条件による切替の詳細設定

子画面の 1 は条件ツリーです。条件を選び、2 側で条件の種類・左右の値・比較方法・NOTを設定します。グループは「すべて成立(AND)」「いずれか成立(OR)」を選び、子条件を追加します。設定後は「OK」で戻ります。

成立時の値の設定

「成立時の値」の「…」で、取得方法「固定値」、型「文字列」、値「在庫あり」を設定します。「不成立時の値」も同じ画面で設定できます。

注意点

成立時・不成立時には固定値、ソース列、BIND変数、元の値、前の変換結果を選べます。実行時は選ばれた側の値だけを評価します。数値として比較する場合、両側の型を数値にしてください。

コード変換

システム間で異なる区分コードを変換します。

コード変換の設定と確認結果

設定方法

「コード対応表」の「…」で、変換前コード1に文字列「在籍」、0に文字列「退職」を割り当てます。「未一致時の動作」で表にない値の扱いを選びます。

設定項目 設定例
大文字小文字を区別しない False
コード対応表 2 設定
未一致時の動作 エラーにする

確認例

サンプル入力 最終結果
VALUE = "1" "在籍"

コード変換の詳細設定

子画面の 1 で変換前のコードと変換後の型・値を設定し、2 の「OK」で戻ります。行の右端のゴミ箱で対応を削除できます。

注意点

未一致時はエラー・元の値を維持・NULL・既定値から選択します。既定値を選ぶと置換後の値を指定できます。変換前コードは重複できません。先頭0が意味を持つコードは入力・対応表とも文字列で扱います。

最初のNULL以外の値

複数の候補から、最初に見つかったNULLでない値を採用します。

最初のNULL以外の値の設定と確認結果

設定方法

「結合する値」の「…」に、VALUE、BACKUP_EMAIL、固定文字列 unknown@example.com の順で候補を並べます。この処理の「結合する値」は候補一覧で、文字列を連結する設定ではありません。

設定項目 設定例
結合する値 3 設定

確認例

サンプル入力 最終結果
VALUE = NULL
BACKUP_EMAIL = "backup@example.com"
"backup@example.com"

最初のNULL以外の値の詳細設定

子画面の 1 で取得方法・参照先・固定値の型・値を設定し、2 の「OK」で戻ります。ソースカラムとBIND変数は参照先の一覧から選択します。固定値では参照先を使いません。

注意点

上から順に評価し、最初のNULL以外の値を返します。空文字や空白は有効な候補です。全候補がNULLなら結果もNULLです。文字列だけでなく、数値や前の変換結果も候補にできます。

条件判定

条件の成立・不成立を真偽値として出力します。

条件判定の設定と確認結果

設定方法

「条件設定」の「…」で「すべて成立(AND)」を選び、元の値が100以上、かつ200未満になる二つの比較条件を設定します。

設定項目 設定例
条件設定 すべて成立(AND)

確認例

サンプル入力 最終結果
VALUE = 120 True

条件判定の詳細設定

子画面の 1 は条件ツリーです。条件を選び、2 側で条件の種類・左右の値・比較方法・NOTを設定します。グループは「すべて成立(AND)」「いずれか成立(OR)」を選び、子条件を追加します。設定後は「OK」で戻ります。

注意点

結果は文字列ではなく真偽値です。「条件による切替」のような成立時・不成立時の値は設定しません。条件グループのAND・OR、結果の反転NOTも使えます。後の手順でこの真偽値を参照することもできます。

マスキング

名前・電話番号・コードなどの一部または全体を、指定した文字で隠します。

マスキングの設定と確認結果

設定方法

「マスキング方式」を「末尾を残す」、「残す末尾文字数」を4、「マスク文字(1文字)」を * にします。先頭を残す場合は「先頭を残す」、両端を残す場合は「先頭と末尾を残す」を選びます。必要な文字数欄だけが表示されます。

設定項目 設定例
マスキング方式 末尾を残す
残す末尾文字数 4
マスク文字(1文字) *

確認例

サンプル入力 最終結果
VALUE = "09012345678" "*******5678"

注意点

初期値は「全体を隠す」と * です。残す文字数は0以上です。残す文字数の合計が入力文字数以上なら全体を隠します。NULLと空文字はそのままです。文字数はUnicodeコードポイント単位で、サロゲートペアは分断しません。結合文字は別コードポイントとして数えます。マスク文字は左埋め・右埋めと同じ1文字制限で、サロゲートペアは指定できません。

方式 入力 出力
全体を隠す 山田太郎 ****
先頭2文字を残す AB123456 AB******
末尾4文字を残す 09012345678 *******5678
先頭1文字・末尾2文字を残す abcdef a***ef
短い入力:末尾4文字を残す設定 123 ***

残す文字数が入力の長さ以上の場合

エラーにせず、入力全体をマスクします。入力文字数と同じ場合も全体が対象です。「変換失敗時」の処理には進みません。例えば入力が 12345、マスク文字が * の場合は次の結果になります。

設定 出力
先頭2文字を残す 12***
先頭4文字を残す 1234*
先頭5文字を残す(同じ長さ) *****
先頭56文字を残す(入力長を超える) *****
先頭1文字・末尾4文字を残す(合計5文字) *****

残す文字数が入力長を超えた場合のマスキング

「先頭と末尾を残す」では、両方の文字数の合計で判定します。短いデータでも元の値が全体表示されないようにするための動作です。

ハッシュ化

入力を固定長のハッシュ文字列へ変換し、同じ値を照合するための識別子にします。

ハッシュ化の設定と確認結果

設定方法

「ハッシュ方式」を「HMAC-SHA256(SDI管理鍵)」にします。「使用する鍵」は「SDI管理鍵」で固定され、鍵の追加登録や入力は不要です。鍵なしの計算には「SHA-256(鍵なし)」を選びます。

設定項目 設定例
ハッシュ方式 HMAC-SHA256(SDI管理鍵)
使用する鍵 SDI管理鍵

確認例

サンプル入力 最終結果
VALUE = "employee001" "9c93a8ee3b2e26ba914428bf142fe552f383d8c01e7fdd362b0c58c906602c16"

注意点

UTF-8で計算し、小文字の16進数64文字を返します。NULLはNULL、空文字は空文字のハッシュになります。入力の空白や大文字小文字は変更しません。必要なら前の手順で整形してください。保存先は64文字以上の文字列列にします。HMACの結果は利用するSDI設定に依存し、掲載画像はサンプル環境の結果です。単純なSHA-256では候補値から結果を照合できます。

ハッシュ方式の選び方

方式 計算に使うもの 同じ入力の結果 主な用途
HMAC-SHA256(SDI管理鍵) 入力値とSDI内部から導出した鍵 同じSDI設定なら同じ 社員番号などの秘匿・照合
SHA-256(鍵なし) 入力値だけ SDI環境が違っても同じ 他システムと共通のハッシュ値による照合

どちらの方式も、ハッシュ用の鍵を追加登録する操作は不要です。 HMAC-SHA256は既存のSDI管理鍵の仕組みを利用します。社員番号や電話番号などを秘匿する場合は、初期値のHMAC-SHA256を選びます。SHA-256では、候補となる元の値をハッシュ化して結果を照合できます。

鍵なしSHA-256を試す

「ハッシュ方式」を「SHA-256(鍵なし)」に変更します。「使用する鍵」は表示されなくなります。サンプル入力の型を「文字列」、値を abc にし、「変換を確認」をクリックします。

鍵なしSHA-256の設定と確認結果

サンプル入力 結果
abc ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

同じ文字列を同じUTF-8で計算する場合、この結果はどのSDI環境でも同じです。

出力の長さと保存先の列

両方式とも、入力の長さに関係なく小文字の16進数64文字を出力します。 短い入力は長くなり、64文字より長い入力は短くなります。

入力 ハッシュ出力の長さ
社員番号 E001:4文字 64文字
電話番号:11文字 64文字
説明文:1000文字 64文字

保存先には64文字以上を保存できる文字列列を用意します。Oracleなら VARCHAR2(64 CHAR) が一例です。SDIはハッシュを列長に合わせて切り詰めません。NULLはNULLのまま、空文字は64文字のハッシュ値になります。

複数Mapping・複数サーバーで同じ結果を使う

同一のSDI設定を共有し、同じ入力・同じ変換設定を使用する場合は、別Mappingや別サーバーでも同じ結果になります。各サーバーでは、共有するSDI設定に対して既存の管理鍵登録を行います。SDI設定を新しく作り直した場合は、ハッシュ結果が変わることがあります。

同じ管理鍵を入力しただけでは、別々に新規作成したSDI環境の結果が一致するとは限りません。照合に使う場合は、同じSDI設定を共有または移行して利用してください。画面のHMAC出力例はサンプル環境の結果のため、ご利用環境の結果とは異なる場合があります。

設定の保存と鍵を利用できない場合

Mappingには方式・鍵の参照元・導出バージョンだけを保存し、鍵本体は保存しません。HMACで鍵を利用できない場合は実行開始前にエラーにし、「変換失敗時」のNULL・既定値へは切り替えません。ハッシュから元の値へ戻す機能や、一意性の保証はありません。

複数の列を別々に変換して結合する

複数の変換結果を結合する設定

次の4手順を作ります。手順1〜3の「入力する値」をそれぞれソース列にするため、途中の結果を上書きせず個別に作成できます。

手順 入力する値 処理 結果
1 VALUE = " ab " 空白除去 "ab"
2 CODE = "xy" 大文字化 "XY"
3 DATE = "20240401" 日時変換 "2024-04-01"
4 手順1・2・3の結果 文字列結合、区切り文字 | "ab|XY|2024-04-01"

結合する変換結果の選択

手順4の「結合する値」で、取得方法を「変換結果」にし、参照先に手順1・2・3を順に選びます。「出力する値」を手順4にして「変換を確認」を実行します。

参照できるのは、その手順より前にある有効な手順です。出力や他の手順から使われていない結果は「未使用」と表示されます。必要な結果と参照先だけが計算されます。別のターゲット列の変換結果は参照しません。

カラムマッピング設定へ戻る