インポートセットの主要な概念

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：6分

    • インスタンスにデータをインポートする前に、インポートセットについて確認してください。

    インポートセットテーブルは、データソースからインポートされたレコードのステージング領域として機能します。

    注:
    非常に大きなデータをインポートしないでください。非常に大きなインポートセットを作成すると、遅延やシステム機能停止が発生する可能性があります。

    変換マップは、インポートセットテーブルに表示されるフィールドと、インシデントテーブルやユーザーテーブルなどの既存の ServiceNow テーブルのフィールドとの関係を決定します。

    インポートセットは、インスタンス内のデータがインポートされるデータと一致する場合にレコードをスキップします。

    注:
    インポートセットはユーザーシステムとして実行されるため、暗号化フィールドにデータを追加することはできません。

    インポートセットの用語

    表 : 1. 主要な用語
    用語 定義
    インポートセットテーブル

    これらのレコードを変換する前に、データソースからインポートされたレコードのステージング場所として機能するテーブル。これらのテーブルのフィールドは、インポートされたデータに基づいて自動的に生成されるため、手動で変更しないでください。

    注:
    インポートセットテーブルの列は自動的に生成されるため、手動で追加しないでください。列を手動で追加すると、スケジュール済みのテーブルクリーンアップに悪影響を及ぼし、クリーンアップの未完了やレコードの孤立が発生する可能性があります。

    インポートセットテーブルに列を追加する必要がある場合は、まず入力データに列を追加してから、[20 件のレコードのテストロード] または [すべてのレコードをロード] を選択してインポートセットテーブルに列を自動生成します。

    インポートセットテーブルの列のタイプが入力データと同じでない可能性があります。たとえば、通貨列は、通貨タイプであるターゲットテーブル列に割り当てられるまで、インポートセットテーブルでは文字列の列として表されます。
    データソース インポートするデータを取得する場所を定義するレコード。データソースは、ファイル、JDBC 互換データベース、または LDAP 組織単位を指すことができます。
    変換 変換マップで定義されたルールに基づく、インポートセットテーブルから別のテーブルへのデータの変換。
    変換マップ インポートセットのフィールドとテーブルのフィールド (インシデントなど) の間の関係を定義するフィールドマップのセット。

    変換時中、データは変換マップに基づいてインポートセットテーブルからターゲットテーブルにコピーされます。

    単一のインポートセットフィールドを、他のテーブルの複数のフィールドにマッピングすることができます。
    強力なインポートセットトランスフォーマー データを抽出、変換、および 1 つ以上のターゲットテーブルにロードします。変換機能と処理機能を分離し、変換マップのより柔軟な代替手段を提供します。
    外部レコードの挿入 外部レコードの挿入は、インポートによって、そのインポートのターゲットテーブルではないテーブルが変更されたときに発生します。

    この変更は、テーブルの参照フィールドを更新するときに発生します。たとえば、インシデントの発信者の値を更新する場合、実際には sys_user テーブルが更新されます。
    結合 インポートデータを変換するときに、既存のターゲットテーブルレコードを更新できます。

    インポートセットレコードを変換するときに [ターゲット] フィールドを使用して結合するかどうかを指定できます。フィールドマップの [結合] オプションが選択されている場合、インポートセット行が変換されると、インスタンスは [ターゲットフィールド] の値がインポートセット行の [ソースフィールド] と同じであるターゲットテーブルの既存のレコードをチェックします。

    ターゲットテーブルに一致する値を持つ既存のレコードが見つかった場合、そのレコードが更新されます。一致するレコードが見つからない場合は、ターゲットテーブルに新しいレコードが作成されます。

    サポートされているインポート形式

    いくつかの異なるファイル形式または外部データソースからデータをインポートできます。

    表 : 2. ファイル形式
    形式 制限事項
    CSV CSV ファイルは、RFC4180 で提案された CSV 標準に準拠する必要があります。特に、これはフィールド内に二重引用符が表示されないことを意味します。インポートされた CSV ファイル内のデータの最初の行がヘッダー行になり、そのインポートセットの列を定義します。
    Excel Excel ファイルには、XLS または XLSX 拡張子が必要です。
    XML XML ファイルには、データ行ごとに一貫した XPath が必要です。
    JSON
    • JSON アレイの場合、各行のパスで /incidents/incidents のようにアレイのルート要素を 2 回指定する必要があります。
    • JSON ファイルは RFC-4627 に従う必要があります。たとえば、値と続く名前は 1 つのカンマで区切る必要があります。オブジェクト内の名前は一意である必要があります。
    • @element、[index]、または text() などの述語や、子、兄弟、先祖などの Axis はサポートされていません。
    カスタム (スクリプトで解析) カスタム JavaScript を記述して、マップのリストへの入力行を解析できます。

    ServiceNow® プラットフォームは、次の外部データソースからデータをインポートできます。

    表 : 3. 外部データ ソース
    データソース 制限事項
    JDBC JDBC インポートには有効な変換マップが必要です。一部のネットワーク構成では ServiceNow® MID サーバー が必要です。
    LDAP LDAP インポートには有効な変換マップが必要です。
    OIDC OIDC インポートには有効な変換マップが必要です。
    ServiceNow® REST (統合ハブ) REST インポートには有効な変換マップが必要です。
    カスタム (スクリプトでロード) カスタムインポートには有効な変換マップが必要です。

    各種のデータソースの詳細については、「データソース」を参照してください。

    変換マップと強力なインポートセットトランスフォーマー

    変換マップと強力なインポートセットトランスフォーマーの両方がデータを変換します。変換マップは、データをステージングテーブルから宛先ファイルに変換します。強力なインポートセットトランスフォーマーは、ソーステーブルからメッセージリスナーにデータを変換します。データソースに変換マップと強力なインポートセットトランスフォーマーの両方がある場合、システムは変換マップの代わりに強力なインポートセットトランスフォーマーを使用します。

    インポートセットスケジュール設定済みクリーンアップ

    Import Set Deleter スケジュール済みジョブは、毎日深夜に古いインポートセットデータをクリーンアップします。

    デフォルトでは、7 日以上経過したすべてのインポートセットと、関連するインポートセットテーブルのレコードが削除されます。このスケジュール済みジョブがインスタンスでアクティブでない場合は、特に繰り返しインポートを使用するときに、このジョブをアクティブ化してインポートセットテーブルの増加を抑えます。
    注:
    スケジュールされたクリーンアップがシステムでアクティブになっていない場合は、このクリーンアップを有効にする前に、インポートセットテーブルが大きすぎない (すべてのテーブルで合計 500 万レコード) ことを確認する必要があります。テーブルが大きすぎる場合は、先に進む前にレコードを手動で削除してください。このデータの削除を調整するには、カスタマーサービス & サポート に連絡してください。
    図 : 1. スケジュール済みスクリプト実行
    インポートセット削除ツール。

    手順については、「インポートセットを削除する」を参照してください。

    インポートセットテーブル削除ツール

    次のインポートセットテーブルのいずれかまたはすべてを手動で削除できます。
    • コンピューター
    • ユーザー
    • 通知
    • ロケーション
    関連する変換マップを削除することも、データのみを削除してテーブル構造を保持することもできます。
    図 : 2. 削除で利用可能なテーブル
    インポートセットテーブル削除ツール。

    手順については、「インポートセットテーブルを削除する」を参照してください。