Datastream は、ServiceNow インスタンスからの変更イベントのレプリケーションをサポートしています。 ServiceNow はエンタープライズ オペレーション向けのクラウドベースのプラットフォームです。Datastream がサポートする他のソースと同様に、データをレプリケートできます。
このページには、次に関する情報が記載されています。
- ServiceNow からレプリケートする際に理解しておく必要がある主な用語。
- Datastream が ServiceNow インスタンスから pull するデータを処理する方法の動作。
- Datastream がサポートする ServiceNow のバージョン。
- ServiceNow をソースとして使用する場合の既知の制限事項。
主な用語
ServiceNow は、テーブル、レコード、フィールドを使用して動作します。
- ServiceNow インスタンス は、専用の分離された ServiceNow クラウド環境です（例:
company.service-now.com）。 - テーブル は、ServiceNow の主要なデータ構造で、データベース テーブルに相当します。
- レコード は、テーブル内の個々のエントリで、データベースの行に相当します。
- フィールド は、レコード内の個々のデータ要素で、データベースの列に相当します。
- コネクタは、ServiceNow テーブルから直接データにアクセスするための主要な RESTful インターフェースとしてテーブル API を使用します。
- オフセットベースのページネーション は、オフセット番号をテーブル API に渡して、ServiceNow テーブル内のレコードを移動する方法です。この方法は、ページネーション中のレコードの削除に影響を受けやすく、コネクタがデータをスキップする可能性があります。
- キーセットベースのページネーション は、コネクタが識別子やタイムスタンプなどの一意のレコード値とその順序を追跡してページネーションを管理する方法です。この方法は、ページネーション中にレコードが削除された場合でも有効です。
行動
Datastream の ServiceNow ソースのサポートは、ServiceNow REST テーブル API に依存しています。Datastream は、データの完全性とパフォーマンスを確保するために、2 つの主要なレプリケーション方法をサポートしています。
履歴のバックフィル
- ServiceNow インスタンスから変更データをレプリケートする場合、Datastream はテーブル内の既存のすべてのレコードの完全な履歴同期を実行します。
- データの整合性を確保し、大量の抽出時のレコードの損失を防ぐため、コネクタはキーセットベースのページネーションを使用します。コネクタは、一意のレコード値とその順序を追跡してこのプロセスを管理します。これにより、レコードの削除に対して抽出が堅牢になり、コネクタがレコードをスキップしたり重複させたりすることを防ぎます。
- Datastream は、
sys_updated_onレコード プロパティとsys_idレコード プロパティでデータを並べ替えて、初期ロードの安定した順序を提供します。変更できないレコードが含まれており、sys_updated_onフィールドがないsys_journal_fieldテーブルの場合、コネクタはsys_created_onプロパティとsys_idプロパティで並べ替えます。
増分同期
- ServiceNow インスタンスから変更データをレプリケートする場合、Datastream は、初期バックフィル後に発生する挿入や更新などの変更をキャプチャします。
- サーバー側の増分同期: コネクタは、
sys_updated_onプロパティとsys_idプロパティ（またはsys_journal_fieldテーブルの場合はsys_created_onとsys_id）のフィルタを使用して、前回の同期が成功してから変更されたレコードについて ServiceNow API にクエリを実行します。 - 同期プロセスでは、
sys_updated_on（またはsys_journal_fieldテーブルの場合はsys_created_on）マーカーとsys_idマーカーで構成される複合カーソルを使用します。sys_updated_onマーカーとsys_created_onマーカーにより、指定した時刻以降のタイムスタンプを持つレコードのみが次のサイクルで同期されます。一方、sys_idマーカーは、タイムスタンプが同じレコードの整合性を確保します。
バージョン
ServiceNow コネクタは、ServiceNow REST テーブル API（V2）で動作します。 Datastream がサポートする機能は、Zurich リリースに対して検証されています。
レプリケートされるオブジェクト
ServiceNow コネクタは、動的検出メカニズムを使用して、インスタンス内のテーブル（オブジェクト）のセット全体を識別します。価値の高いビジネスデータのみをレプリケートするために、コネクタは多層フィルタリング プロセスを適用して、内部アーキテクチャ、技術ログ、システム メタデータ テーブルを除外します。
フィルタ ロジック
- ウェブサービス アクセス: ウェブサービス アクセスが有効（
ws_access=true）に構成されているテーブルのみをレプリケートできます。この 構成がない場合、コネクタはテーブルからレコードデータを取得できません。 - 除外されたスーパークラス: コネクタは、
sys_metadataシステム構成テーブルから継承されたテーブル、またはローテーションされたテーブル 階層の一部であるテーブルを除外して、技術メタデータや一貫性のないスナップショットのレプリケートを防ぎます。 - 内部システム プレフィックス: コネクタは、プラットフォームの配管またはレガシー機能を表す 特定の技術プレフィックスで始まるテーブルを除外します。
- **ゴールデン リスト（システム例外）**: コネクタはほとんどの
sys_テーブルを除外しますが、sys_user、sys_choice、sys_journal_fieldなどの重要なビジネス エンティティは明示的に許可リストに登録します。
デフォルトでフィルタされるシステム プレフィックス
| カテゴリ | 接頭辞 | 説明 |
|---|---|---|
| 体幹の内部 | v_、ts_、imp_、ecc_、wf_、sh$、bin_、var_、gs_ |
仮想テーブル、検索インデックス、インポート ステージング、ECC キュー、ワークフロー コンテキスト。 |
| 分析と AI | pa_、ua_、ml_、ais_、promin_、di_ |
パフォーマンス分析スコア、ベンダー テレメトリー、ML ベクトル、AI 検索プロファイル。 |
| 技術モジュール | sa_、sla_、atf_、cxs_、automation_、ids_ |
サービス マッピング パターン、SLA エンジンログ、セキュリティ監査証跡。 |
| レガシーと管理 | pf_、clone_、upgrade_、rollback_、expert_、dscy_ |
インスタンスのパッチ適用履歴、アップグレード ログ、廃止されたレガシー モジュール。 |
許可されているシステム テーブル
- ユーザーとセキュリティ:
sys_user、sys_user_group、sys_user_grmember、sys_user_role、sys_user_has_role。 - コア参照:
sys_choice（プルダウン オプション）、sys_company、sys_domain、sys_location。 - 監査証跡:
sys_journal_field（作業メモとコメントの履歴）。
既知の制限事項
ServiceNow をソースとして使用する場合の既知の制限事項は次のとおりです。
- Datastream は、削除されたレコードのキャプチャをサポートしていません。
- Datastream は、デフォルトで多くの内部プラットフォーム テーブルを除外します（例:
ts_、v_、imp_で始まるテーブル）。 - ウェブサービス アクセスが有効（
ws_access=true）に構成されているテーブルのみをレプリケートできます。これは、ほとんどのテーブルのデフォルトです。 - コネクタは、基盤となる ServiceNow データベース インスタンスに表示される方法でフィールド値をレプリケートします。これらの値は、実際の値と呼ばれます。 つまり、Datastream が宛先にレプリケートする実際の値は、ServiceNow ユーザー インターフェースに表示される値（表示値）と異なる場合があります。 詳細については、 ServiceNow ナレッジベースをご覧ください。
次のステップ
- Datastream で使用する ServiceNow ソースを構成する 方法を学習する。