ETL 定義クイックスタートガイド

リリースバージョン: Australia

更新日 2026年03月12日

所要時間：5分

ETL 定義を設定して使用し、 ServiceNow テーブルにデータをインポートする方法について説明します。

始める前に

必要なロール：admin

このクイックスタートガイドでは、次の JSON ファイルのデータをインポートしてターゲットテーブル ServiceNow します。この JSON ファイルには、学校、クラス、生徒、科目の階層データが含まれています。次のコンテンツを JSON ファイルに保存します。


[{ 
   "name": "schoolA", 
   "classes": [ 
   { 
    "name": "classA", 
    "students": [ 
    {"name": "studentA", "subjects": [{"name": "subjectA", "marks": 80}, 
     {"name": "subjectB", "marks": 90},{"name": "subjectC", "marks": 100}]}, 
    {"name": "studentB", "subjects": [{"name": "subjectA", "marks": 75}, 
     {"name": "subjectB", "marks": 85}, {"name": "subjectC", "marks": 95}]}
   ] 
  },{ 
   "name": "classB", 
   "students": [ 
   {"name": "studentC", "subjects": [{"name": "subjectA", "marks": 60}, 
    {"name": "subjectB", "marks": 70}, {"name": "subjectC", "marks": 80}]}, 
   {"name": "studentD", "subjects": [{"name": "subjectA", "marks": 55}, 
    {"name": "subjectB", "marks": 65}, {"name": "subjectC", "marks": 75}]} 
   ] 
  } 
 ] 
}]

手順

データソースを作成し、データをロードします。
1. JSON 形式のデータソースを作成し、各行のパスをとして作成します。
2. [ 単一列のデータ ] オプションをオンにします。
3. データソースとして保存します。
4. 上記の JSON ファイルをデータソースに添付します。
5. [ すべてのレコードをロード ] を選択して、インポートセットテーブルにレコードをロードします。
6. 作成されたインポートセット行を開きます。
  レコードは単一の JSON 列に保存する必要があります。
データをインポートするためのターゲットテーブル構造を作成します。
1. この例では、複数のクラスを持つ学校があり、各クラスには複数の生徒がいて、各生徒には複数の科目があります。
2. これらの関係を反映するテーブル構造を作成します。
3. 学校 >名:文字列。
4. クラス:>名:文字列、学校:学校への参照。
5. 受講者 ->名:文字列、クラス:クラスへの参照。
6. 件名:>名:文字列、マーク:整数、学生:学生への参照。
JSON レコードデータをターゲットテーブルにマッピングする ETL 定義を作成します。
1. 検索項目システムインポートセット > ETL 定義.
2. [新規] を選択します。
3. 名前を入力し、レコードを保存します。
エンティティを作成します。
1. [ETL エンティティ] タブで、[ 新規] を選択します。
2. [名前] を [インポートセット] に設定して保存します。
3. JSON のすべてのリーフ値のインポートセットエンティティフィールドを追加します。
  フィールド/パスは JSON のルートからのパスであり、配列は [*] でマークされます。
4. [ETL 定義] に移動し、[ETL エンティティ] で [ 新規] を選択します。
5. [名前] を [学校] に設定します。
6. 手順 2 で作成した学校のテーブルとしてテーブルを設定します。
7. パスを学校として設定します。
8. エンティティを保存します。
9. [関連リンク] の下にある [フィールドを生成 ] を選択します。
  これにより、[ 名前 ] フィールドが生成されます。結合を true に設定します。
10. [ETL 定義] に移動し、[ETL エンティティ] で [ 新規] を選択します。
11. 手順 2 で作成したクラステーブルとしてテーブルを設定します。
12. パスを class[*] として設定します。
  [*] を使用すると、複数の行を持つエンティティになります。
13. [関連リンク] の下にある [フィールドを生成 ] を選択します。
14. [ETL エンティティ] フィールドの学校は参照フィールドであるため、[フィールド/パス] を school.name に変更し、名前が一意であるため [名前] フィールドの [結合] を true に設定します。
15. [学生] と [科目] にもエンティティを追加します。
  [件名] の [名前] フィールドと [学生] フィールドの両方で [結合] を true に設定します。
RTE エンティティマッピングを追加します。
1. [RTE エンティティマッピング] に移動し、[ 新規] を選択します。
2. [名前] を [学校にインポートセット] に設定します。
3. ソースエンティティをインポートセットに設定します。
4. ターゲットエンティティを学校に設定します。
5. 順序は 100 のままにします。
6. [RTE フィールドマッピング] で [ 新規] を選択します。
7. [ ソースフィールド] で [ 学校名] を選択します。
  ソースエンティティからのみエンティティフィールドを選択できます。
8. [ ターゲットフィールド] で [ 名前] を選択します。
  ターゲットエンティティからのみエンティティフィールドを選択できます。
9. [ETL 定義] に移動し、[RTE エンティティマッピング] で [ 新規] を選択します。
10. [ 名前 ] を [インポートセット] に [クラス] に設定します。
11. インポートセットのソースエンティティを選択します。
12. クラスへのターゲットエンティティを選択します。
13. [ 順序] を 200 に設定します。
14. 名前と学校名をマップする RTE フィールドマッピングを追加します。
  学校のターゲットフィールドは、インポートセットの学校名にマッピングする必要があります。システムはこの値を使用して学校を検索し、正しい学校参照を設定します。
15. 学生と科目のマッピングも追加します。
強力なインポートセットトランスフォーマーレコードを作成し、インポートを実行します。
1. ステップ 1 で作成したデータソースに移動します。
2. [Robust Transformer] タブを選択し、[ New (新規)] を選択します。
3. 名前を設定します。
4. トランスフォーマー定義を、前に作成した ETL 定義に設定します。
5. 詳細を設定します。
  [ 詳細 ] の選択は必須ではありませんが、構成をデバッグできます。パフォーマンスに悪影響を与える可能性があるため、本番環境に移行する前にこれをオフにしてください。
6. [送信] を選択します。
7. [すべてのレコードをロード] を選択します。
8. [ 強力な変換を実行] を選択します。
9. [Transform (変換)] を選択します。
10. インポートセットに移動します。
11. [インポートセット行] タブを選択し、インポートセット行レコードを開きます。
12. 構成が正しく機能する場合は、すべてのレコードが挿入されたインポートセット行レコードが表示されます。