抽出変換ロード (ETL) 定義を作成する

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：3分

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

    始める前に

    必要なロール：import_transformer

    手順

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

    例

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

    onAfter スクリプトでは、ソースおよびターゲットデータは両方ともインポートログに書き込まれます。スクリプトは、sn_etl_demo_worker テーブルの変換された値を再度反復処理します。これによりデータがターゲットテーブルに挿入され、各レコードに sys_id が割り当てられます。このスクリプトは、各ワーカーの Sys ID、ID、および名前をインポートログに記録します。

    onBefore スクリプトと onAfter スクリプトを含む ETL 定義の例。
    注:
    • ガイド付きまたは段階的なエクスペリエンスを通じて、これらの定義とマッピングを作成する方法については、「統合ハブ - インポート」を参照してください。
    • ターゲットテーブルまたはアプリケーションが CMDB に関連している場合は、IntegrationHub ETL ガイド付きエクスペリエンスを使用します。