---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

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

# ETL 定義クイックスタートガイド {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年11月04日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

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

## 始める前に

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