---
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年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

ソーステーブルからデータを抽出し、必要に応じてデータを変換して、データを複数のターゲットテーブルにロードするための ETL 定義を作成します。ETL 定義は、ネストされたデータ構造もサポートしています。

## 始める前に

必要なロール：import_transformer

## 手順

1. 移動先 すべてシステムインポートセットアドミニストレーションETL 定義.
2. \[新規\] をクリックします。
3. フォームに入力します。  
   {#create-etl-definitions__table_fnb_s3p_3jb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | ETL 定義の名前。 |
   | 説明 | ETL 定義の説明。 |
   | 空のフィールドをコピー | 空のフィールド値をコピーするオプションです。受信データに空の値のフィールドがある場合は、空の値をコピーするか、無視して既存の値を保持するかのいずれかが行えます。 |
   | onBefore スクリプトを実行 (Execute onBefore script) | データを挿入または更新する前にスクリプトを実行するオプションです。 onBefore スクリプトには 3 つのパラメーターがあります。 * source：インポートレコードからのソースデータ。 * target：インポートレコードからの変換済みデータ。onBefore スクリプトでは、このパラメーターは、ターゲットテーブルに挿入される前に変換済みデータにアクセスします。 * importLog：データインポートアクティビティに関する情報を記録するログ。 {#create-etl-definitions__ul_zl1_jxd_ntb} onBefore スクリプトには 2 つの変数があります。 * ignore. タイプ：ブーリアン。true の場合、指定されたインポートセット行は無視されます。 * ignore_reason. タイプ：文字列。インポートセット行が無視された理由を説明するメッセージです。 {#create-etl-definitions__ul_ekz_wxd_ntb} |
   | onAfter スクリプトを実行 (Execute onAfter script) | データを挿入または更新した後にスクリプトを実行するオプションです。 onAfter スクリプトには 3 つのパラメーターがあります。 * source：インポートレコードからのソースデータ。 * target：インポートレコードからの変換済みデータ。onAfter スクリプトでは、このパラメーターは、ターゲットテーブルに挿入された後で変換済みデータにアクセスします。レコードが挿入または更新されると、sys_id が割り当てられます。 * importLog：データインポートアクティビティに関する情報を記録するログ。 {#create-etl-definitions__ul_srr_kxd_ntb} |
   | アプリケーション | このレコードのアプリケーションスコープ。 |
   | アクティブ | ETL 定義がアクティブな場合に選択されます。ETL 定義がアクティブでない場合は選択が解除されます。 |
   [ ]

   {#create-etl-definitions__table_fnb_s3p_3jb}
4. \[送信\] をクリックします。

## 例

この例では、ワーカーの ETL 定義に onBefore スクリプトと onAfter スクリプトの両方があります。onBefore スクリプトでは、ワーカーが既に退職しているため、ID が 124 のソースレコードは無視されます。ソースデータとターゲットデータの両方がインポートログに書き込まれます。最後に、スクリプトは sn_etl_demo_worker テーブルの変換された値を反復処理し、各ワーカーの ID と名前を取得してインポートログに記録します。

onAfter スクリプトでは、ソースおよびターゲットデータは両方ともインポートログに書き込まれます。スクリプトは、sn_etl_demo_worker テーブルの変換された値を再度反復処理します。これによりデータがターゲットテーブルに挿入され、各レコードに sys_id が割り当てられます。このスクリプトは、各ワーカーの Sys ID、ID、および名前をインポートログに記録します。  
注:  
* ガイド付きまたは段階的なエクスペリエンスを通じて、これらの定義とマッピングを作成する方法については、「[統合ハブ - インポート](https://servicenow-prod.fluidtopics.net/SgqMy8c6dTrG8VxH6JUY4g "ガイド付きの手順を追って操作できる統合インターフェイスを介してデータインポートタスクを自動化します。外部データソースを定義し、ターゲットテーブルを指定し、ソースデータがどのようにターゲットデータになるかをマッピングし、定期的なインポートをスケジュール設定します。")」を参照してください。
* ターゲットテーブルまたはアプリケーションが CMDB に関連している場合は、[IntegrationHub ETL](https://www.servicenow.com/docs/access?context=integrationhub-etl&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) ガイド付きエクスペリエンスを使用します。
{#create-etl-definitions__ul_xmd_xch_jzb}
**関連タスク**   

* [ETL エンティティの定義](https://servicenow-prod.fluidtopics.net/83rexh6nM28HzArrIpgT2Q "強力な変換エンジンで使用される抽出変換ロード (ETL) エンティティを定義します。")
* [ETL エンティティマッピングを定義する](https://servicenow-prod.fluidtopics.net/o0Y6F5Jvbi7p_Zr9xgj4cQ "ソースエンティティをターゲットエンティティにマッピングします。")
* [ETL エンティティフィールド定義を作成する](https://servicenow-prod.fluidtopics.net/FXqCHuIfeuxNWiZtKz3r1w "抽出変換ロード (ETL) 操作用にマッピングされたエンティティフィールドを定義します。")
* [強力な変換エンジン操作を定義する](https://servicenow-prod.fluidtopics.net/UDtj0IN~DUxa_3XCzJf9GQ "強力な変換エンジン (RTE) が実行する必要のある操作を定義します。")