--- 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 --- # インポートセットの主要な概念 # インポートセットの主要な概念 {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分 インスタンスにデータをインポートする前に、インポートセットについて確認してください。 インポートセットテーブルは、データソースからインポートされたレコードのステージング領域として機能します。 注: 非常に大きなデータをインポートしないでください。非常に大きなインポートセットを作成すると、遅延やシステム機能停止が発生する可能性があります。 変換マップは、インポートセットテーブルに表示されるフィールドと、インシデントテーブルやユーザーテーブルなどの既存の ServiceNow テーブルのフィールドとの関係を決定します。 インポートセットは、インスタンス内のデータがインポートされるデータと一致する場合にレコードをスキップします。 注: インポートセットはユーザーシステムとして実行されるため、暗号化フィールドにデータを追加することはできません。 ## インポートセットの用語 {#c_ImportSetsKeyConcepts__table_rv4_gxf_f5__entry__2} | 期間 | 定義 | |-|-| | インポートセットテーブル | これらのレコードを変換する前に、データソースからインポートされたレコードのステージング場所として機能するテーブル。これらのテーブルのフィールドは、インポートされたデータに基づいて自動的に生成されるため、手動で変更しないでください。 注: インポートセットテーブルの列は自動的に生成されるため、手動で追加しないでください。列を手動で追加すると、スケジュール済みのテーブルクリーンアップに悪影響を及ぼし、クリーンアップの未完了やレコードの孤立が発生する可能性があります。 インポートセットテーブルに列を追加する必要がある場合は、まず入力データに列を追加してから、\[20 件のレコードのテストロード\] または \[すべてのレコードをロード\] を選択してインポートセットテーブルに列を自動生成します。 インポートセットテーブルの列のタイプが入力データと同じでない可能性があります。たとえば、通貨列は、通貨タイプであるターゲットテーブル列に割り当てられるまで、インポートセットテーブルでは文字列の列として表されます。 | | データソース | インポートするデータを取得する場所を定義するレコード。データソースは、ファイル、JDBC 互換データベース、または LDAP 組織単位を指すことができます。 | | 変換 | 変換マップで定義されたルールに基づく、インポートセットテーブルから別のテーブルへのデータの変換。 | | 変換マップ | インポートセットのフィールドとテーブルのフィールド (インシデントなど) の間の関係を定義するフィールドマップのセット。 変換時中、データは変換マップに基づいてインポートセットテーブルからターゲットテーブルにコピーされます。 単一のインポートセットフィールドを、他のテーブルの複数のフィールドにマッピングすることができます。 | | 強力なインポートセットトランスフォーマー | データを抽出、変換、および 1 つ以上のターゲットテーブルにロードします。変換機能と処理機能を分離し、変換マップのより柔軟な代替手段を提供します。 | | 外部レコードの挿入 | 外部レコードの挿入は、インポートによって、そのインポートのターゲットテーブルではないテーブルが変更されたときに発生します。 この変更は、テーブルの参照フィールドを更新するときに発生します。たとえば、インシデントの発信者の値を更新する場合、実際には sys_user テーブルが更新されます。 | | 結合 | インポートデータを変換するときに、既存のターゲットテーブルレコードを更新できます。 インポートセットレコードを変換するときに \[ターゲット\] フィールドを使用して結合するかどうかを指定できます。フィールドマップの \[結合\] オプションが選択されている場合、インポートセット行が変換されると、インスタンスは \[ターゲットフィールド\] の値がインポートセット行の \[ソースフィールド\] と同じであるターゲットテーブルの既存のレコードをチェックします。 ターゲットテーブルに一致する値を持つ既存のレコードが見つかった場合、そのレコードが更新されます。一致するレコードが見つからない場合は、ターゲットテーブルに新しいレコードが作成されます。 | [表 : 1. 主要な用語] {#c_ImportSetsKeyConcepts__table_rv4_gxf_f5} ## サポートされているインポート形式 {#c_ImportSetsKeyConcepts__section_uyv_ylc_m1b} いくつかの異なるファイル形式または外部データソースからデータをインポートできます。 {#c_ImportSetsKeyConcepts__table_mwq_nl1_kr__entry__2} | フォーマット | 制限事項 | |-|-| | CSV | CSV ファイルは、[RFC4180](http://tools.ietf.org/pdf/rfc4180.pdf) で提案された CSV 標準に準拠する必要があります。特に、これはフィールド内に二重引用符が表示されないことを意味します。インポートされた CSV ファイル内のデータの最初の行がヘッダー行になり、そのインポートセットの列を定義します。 | | Excel | Excel ファイルには、XLS または XLSX 拡張子が必要です。 | | XML | XML ファイルには、データ行ごとに一貫した XPath が必要です。 | | JSON | * JSON アレイの場合、各行のパスで `/incidents/incidents` のようにアレイのルート要素を 2 回指定する必要があります。 * JSON ファイルは [RFC-4627](https://www.ietf.org/rfc/rfc4627.txt) に従う必要があります。たとえば、値と続く名前は 1 つのカンマで区切る必要があります。オブジェクト内の名前は一意である必要があります。 * `@element`、`[index]`、または `text()` などの述語や、子、兄弟、先祖などの Axis はサポートされていません。 {#c_ImportSetsKeyConcepts__ul_mgp_3kr_5x} | | カスタム (スクリプトで解析) | カスタム JavaScript を記述して、マップのリストへの入力行を解析できます。 | [表 : 2. ファイル形式] {#c_ImportSetsKeyConcepts__table_mwq_nl1_kr} ServiceNow® プラットフォームは、次の外部データソースからデータをインポートできます。 {#c_ImportSetsKeyConcepts__table_nck_jm1_kr__entry__2} | データソース | 制限事項 | |-|-| | JDBC | JDBC インポートには有効な変換マップが必要です。一部のネットワーク構成では ServiceNow® MID サーバー が必要です。 | | LDAP | LDAP インポートには有効な変換マップが必要です。 | | OIDC | OIDC インポートには有効な変換マップが必要です。 | | ServiceNow® REST (統合ハブ) | REST インポートには有効な変換マップが必要です。 | | カスタム (スクリプトでロード) | カスタムインポートには有効な変換マップが必要です。 | [表 : 3. 外部データ ソース] {#c_ImportSetsKeyConcepts__table_nck_jm1_kr} 各種のデータソースの詳細については、「[データソース](https://servicenow-prod.fluidtopics.net/QY_vF~U~8sbqhjA5Se8dyg "データソースを使用してインポートセットを作成し、必要に応じて、生産テーブルにマップする前にデータを処理できるようにします。")」を参照してください。 ## 変換マップと強力なインポートセットトランスフォーマー {#c_ImportSetsKeyConcepts__section_gkz_blr_cjb} 変換マップと強力なインポートセットトランスフォーマーの両方がデータを変換します。変換マップは、データをステージングテーブルから宛先ファイルに変換します。強力なインポートセットトランスフォーマーは、ソーステーブルからメッセージリスナーにデータを変換します。データソースに変換マップと強力なインポートセットトランスフォーマーの両方がある場合、システムは変換マップの代わりに強力なインポートセットトランスフォーマーを使用します。 ## インポートセットスケジュール設定済みクリーンアップ {#c_ImportSetsKeyConcepts__section_rzy_t3d_m1b} Import Set Deleter スケジュール済みジョブは、毎日深夜に古いインポートセットデータをクリーンアップします。 デフォルトでは、7 日以上経過したすべてのインポートセットと、関連するインポートセットテーブルのレコードが削除されます。このスケジュール済みジョブがインスタンスでアクティブでない場合は、特に繰り返しインポートを使用するときに、このジョブをアクティブ化してインポートセットテーブルの増加を抑えます。 注: スケジュールされたクリーンアップがシステムでアクティブになっていない場合は、このクリーンアップを有効にする前に、インポートセットテーブルが大きすぎない (すべてのテーブルで合計 500 万レコード) ことを確認する必要があります。テーブルが大きすぎる場合は、先に進む前にレコードを手動で削除してください。このデータの削除を調整するには、カスタマーサービス \& サポート に連絡してください。 図 : 1. スケジュール済みスクリプト実行 手順については、「[インポートセットを削除する](https://servicenow-prod.fluidtopics.net/CE_WkpHS7Mui7zbXznlNUA "インポートセットを削除して、スケジュールに基づいて、1 回のみ、またはオンデマンドでデータベースをクリーンアップします。")」を参照してください。 ## インポートセットテーブル削除ツール {#c_ImportSetsKeyConcepts__section_yhm_4lt_1jb} 次のインポートセットテーブルのいずれかまたはすべてを手動で削除できます。 * コンピューター * ユーザー * 通知 * 場所 {#c_ImportSetsKeyConcepts__ul_ihz_xlt_1jb} 関連する変換マップを削除することも、データのみを削除してテーブル構造を保持することもできます。図 : 2. 削除で利用可能なテーブル 手順については、「[インポートセットテーブルを削除する](https://servicenow-prod.fluidtopics.net/6rTaPKU420CNWfEmluWX4w "インポートセットテーブル、関連する変換マップ、またはデータのみ (テーブル構造を保持) を削除し、データベースをクリーンアップします。")」を参照してください。