Service Graph Connector for Microsoft SCCM 3.0 セットアップ指針Service Graph Connector for Microsoft SCCM 3.0 セットアップ指針 前書き Service Graph Connector for Microsoft SCCM (SG-SCCM) 3.0 リリースでは、複数の SCCM インスタンスから単一の ServiceNow CMDB にデータをインポートできます。 Service Graph Connector for Microsoft SCCM 3.0 の初期構成は、以前のバージョンのコネクタとは異なります。このドキュメントでは、Service Graph Connector for Microsoft SCCM 3.0 にアップグレードするお客様向けのベストプラクティスを説明しています。 単一の SCCM インスタンスからデータをインポートする場合でも、複数の SCCM インスタンスからデータをインポートする場合でも、SG-SCCM 3.0 のすべてのユーザーが、ガイド付き設定のステップに従って新しい接続を作成し、対応するデータソースと予定されているデータインポートを生成する必要があります。 これらの生成されたデータソースと予定されているデータインポートは、データのインポートに使用されます。 主なステップ データソースおよび予定されているデータインポートを動的に作成するための権限を SG-SCCM に付与します。インポート元の SCCM インスタンスごとに、以下を実行します。 SCCM インスタンスへの新しい接続と認証情報を作成します。データソースおよび予定されているデータインポートの新しいセットを作成します。データソースを検証して接続を確認します。 ガイド付き設定で次のステップを実行して、SG-SCCM 3.0 を構成します。 ガイド付き設定：データソースおよび予定されているデータインポートアクセスの構成 以前のバージョンの SG-SCCM とは異なり、Service Graph Connector for Microsoft SCCM 3.0 では、デフォルト設定のデータソースと予定されているデータインポートは直接実行されません。代わりに、SG-SCCM 3.0 は、デフォルト設定のデータソース (プライムデータソースとも呼ばれる) およびスケジュール済みインポートからコピーされる、データソースとスケジュール済みインポートの新しいセットを SCCM 接続ごとに作成します。 新しくコピーされたこれらのデータソースは、構成時にお客様から提供された一意のプリフィックスで識別されます。 接続および資格情報エイリアスのユーザーを作成すると、コネクタは対応するデータソースと予定されているデータインポートを生成します。 しかし、スコープ対象のアプリケーションには、デフォルトの ServiceNow プラットフォームでデータソースまたは予定されているデータインポートを作成する機能はありません。したがって、データソースと予定されているデータインポートの生成を有効にするには、次のテーブルに対するアクセス権を作成する必要があります。 データソース [sys_data_source]予定されているデータインポート [scheduled_import_set] ガイド付き設定の最初のステップである「データソースおよび予定されているデータインポートアクセスの構成」では、これらの必要な権限が有効になります。 次に示すように、ステップに従って必要なアクセス権を設定します。 次の図は、データソース [sys_data_source] テーブルの「アプリケーションアクセス」を示しています。 次の図は、予定されているデータインポート [scheduled_import_set] テーブルの「アプリケーションアクセス」を示しています。 ガイド付き設定：接続の構成 このステップでは、Flow Designer の接続認証情報インターフェイスを使用して、新しい接続を作成します。 ガイド付き設定には、次の 2 つの異なる接続オプションがあることに注意してください。 接続の構成接続の構成 (統合認証) 統合認証機能を使用するかどうかに基づいて、これら 2 つのうち一方または他方を構成する必要があります。 [構成] ボタンをクリックすると、Flow Designer の接続ページに移動します。 接続および認証情報のセットアップ SG-SCCM の新規インストールでも SG-SCCM 2.5 からのアップグレードでも、SG-SCCM 3.0 では、最初の接続を含め、SCCM 接続ごとに新しい接続および資格情報エイリアスを作成する必要があります。Service Graph Connector for Microsoft SCCM の古いバージョンからアップグレードするユーザーは、新しい接続および資格情報エイリアスを作成する必要があります。 Flow Designer の接続インターフェイスでは、デフォルト接続を構成しないでください。代わりに、[接続を追加] ボタンをクリックして新しい接続を追加します。 接続を構成して作成します。この接続には、後で作成する可能性のある他の SCCM 接続と区別するために、わかりやすい名前を付けることをお勧めします。 注：MID サーバーは、「データソースおよび予定されているデータインポートの構成」のガイド付き設定ステップの一部として構成されます。 新しい接続が作成されると、Flow Designer の [接続] のリストに表示されます。 ガイド付き設定に戻り、構成プロセスを続行します。 ガイド付き設定：データソースおよび予定されているデータインポートの構成 このステップでは、新しく作成された接続のデータソースおよび予定されているデータインポートのセットを生成します。SCCM 接続ごとに個別のスケジュール設定とカスタマイズを可能にするために、データソースとインポートの新しいセットを作成する必要があります。 対応するデータソースおよび予定されているデータインポートの生成 Service Graph Connector for Microsoft SCCM 3.0 では、デフォルト設定のデータソースと予定されているデータインポートを使用する代わりに、生成されたデータソースと予定されているデータインポートを使用します。ガイド付き設定ステップ「データソースおよび予定されているデータインポートの構成」では、接続および資格情報エイリアスに関連付けられたデータソースおよび予定されているデータインポートが生成されます。 最初の構成要素 [データソースおよび予定されているデータインポートセットのプリフィックス (Prefix to Data source and Scheduled Data Import Sets)] は必須項目です。このプリフィックスは、この個別の SCCM 接続のすべてのデータソースとスケジュール済みインポートの名前に付加される識別子です (最大 8 文字)。マルチインスタンス展開では、このプリフィックスは、関連するデータソースのセットを識別できるように、短くて意味のある識別子にする必要があります。たとえば、AMS リージョンと EMEA リージョンに 2 つの異なる SCCM インスタンスがある場合、データソースとスケジュールのセットを簡単に識別して区別するために、インスタンスプリフィックスとして「AMS」と「EMEA」を選択できます。 注：統合認証接続タイプ用に「接続および資格情報エイリアス」が作成されている場合、MID サーバーは必須です。 接続を設定したら、[インポートの作成/更新] をクリックします。プリフィックスが新しい一意の値である場合、SG-SCCM ガイド付き設定では、デフォルト (プライム) SG-SCCM データソースおよびスケジュール済みインポートからコピーされた、データソースと予定されているデータインポートの新しいセットが作成されます。これは、プリフィックスに加えて、[識別された接続 (identified connection)]、[MID] および [ユーザーとして実行 (Run As User)] のパラメーターを使用します。 プリフィックス値が SG-SCCM データソースの既存のセットに対応する場合、それらのデータソースと予定されているデータインポートは、新しく指定された設定パラメーターで更新されます。 作成後、新しいデータソースと予定されているデータインポートが次のように表示されます。これらの項目の名前の先頭には、前のステップで指定したプリフィックス値が付いていることに注意してください。 データソースを検証 新しいデータソースを作成したら、接続を確認するために検証する必要があります。ガイド付き設定のステップ「データソースを検証」で [構成] ボタンをクリックします。 SG-SCCM コンピューター ID に基づいて、新しく作成されたデータソースを選択します。次に [20 件のレコードのテストロード] をクリックします。 処理されたレコードの数がゼロ以外であることで、接続が成功したことを確認します。 生成されたデータソースと接続および資格情報 Microsoft SCCM は、リソース ID と呼ばれる内部識別子を使用して、SCCM 内のコンピューターを一意に識別します。この ID は、レコードを識別するソースネイティブキーの一部として SG-SCCM で使用されます。 しかし、Microsoft SCCM では、リソース ID が複数の SCCM インスタンス間で一意であることは保証されません。 SCCM リソース ID は、異なる SCCM インスタンス間で重複する可能性があり、重複することがわかっています。 正しく処理しないと、異なる SCCM インスタンスのデータが CMDB 内で不適切な望ましくない方法で結合される可能性があります。 異なる SCCM インスタンスのデータを区別するために、生成されたデータソースを使用してインポートされたデータには、SQL select ステートメントに埋め込まれた接続および資格情報エイリアス識別子 (sys_id) があります。この情報は、CI を特定の SCCM インスタンスに関連付けるために使用されます。 上記のステップに従って SG-SCCM ガイド付き設定でデータソースのセットを作成すると、構成された接続および資格情報エイリアスに基づいて、この SQL 句が動的に追加されます。 次の図は、接続および資格情報エイリアス情報が埋め込まれた、生成されたデータソース SQL ステートメントを示しています。 次の図は、個別のインポートデータ列として接続および資格情報エイリアス情報 sys_id を含むインポートセット行を示しています。 次の図は、すべてのレコードに関連付けられた接続および資格情報エイリアス情報を含むソース [sys_object_source] テーブルレコードを示しています。 デフォルト設定のデータソースと予定されているデータインポートについて 次の理由により、デフォルト設定 (OOTB) の予定されているデータインポートまたはデータソース (名前が「SG-SCCM」で始まるもの) を直接構成または使用しないでください。 OOTB の予定されているデータインポートまたはデータソースは、データソースおよび予定されているデータインポートのインスタンスを生成するためのテンプレートとして使用されます。デフォルト設定のデータソース内の SQL ステートメントをカスタマイズすると、生成されたデータソースにコピーされますが、これは望ましくない場合があります。ガイド付き設定 では、デフォルト設定のデータソースの認証情報やその他の構成を設定する機能が提供されなくなりました。OOTB のデータソースを使用してインポートされたデータには接続および資格情報エイリアス情報がないため、CI を特定の SCCM インスタンスに関連付ける方法はありません。 代わりに、上記のガイド付き設定のステップに従って新しい接続を追加し、実行用にデータソースと予定されているデータインポートのコピーを作成することをお勧めします。 既存の「SG-SCCM コンピューター ID」の予定されているデータインポートを非アクティブ化 SG-SCCM のアップグレードシナリオでは、既存の SG-SCCM コンピューター ID の予定されているデータインポートが引き続きアクティブである可能性があります。 このバージョンの SG-SCCM では、データソースと予定されているデータインポートのセットを作成するときに、OOTB のデータソースと予定されているデータインポート (名前が「SG-SCCM」で始まるもの) がテンプレートとして使用されるため、既存の「SG-SCCM コンピューター ID」の予定されているデータインポートを非アクティブ化する必要があります。 代わりに、生成された予定されているデータインポートを上記のように構成し、それを SCCM データインポートに使用する必要があります。 アップグレード中にスキップされたデータソースレコード 以前のバージョンの SG-SCCM コネクタからアップグレードするお客様の場合は、データソースレコードがアップグレードプロセスのスキップされた変更として保持されます。 これは、以前のバージョンの SG-SCCM で、認証情報と接続の詳細がデータソース [sys_data_source] レコードに直接保存されるために発生します。したがって、これはアップグレード時に自動的にマージできない「カスタマイズ済み」レコードとして識別されます。 これらのスキップされた更新を解決して、SG-SCCM 3.0 のすべての新機能が顧客インスタンスにインストールされるようにする必要があります。「レビュー対象のスキップされた変更」のすべてのレコードを解決する必要があることが想定されます。 次の図は、スキップされた「未変更のカスタマイズ」レコードとしてのデフォルト設定のデータソースレコードを示しています。 ユーザーは、これらのスキップされたデータソース [sys_data_source] レコードを確認し、「ベースシステムに戻す」必要があります。 注：これらのデータソースはデータソースのインスタンスを生成するためのテンプレートとして使用されるため、デフォルト設定のデータソースレコードは「ベースシステムに戻す」必要があります。 保存を希望する SG-SCCM SQL ステートメントの既存のカスタマイズがある場合は、ベースシステムに戻す前に、これらの SQL ステートメントを (テキストファイルなどに) 保存する必要があります。その後、次のガイド付き設定のステップを使用して再マージできます。 ガイド付き設定：インスタンスデータソースの SQL ステートメントをカスタマイズ SQL ステートメントのカスタマイズはオプションのステップです。 SQL ステートメントをカスタマイズする場合は、データソースの SQL ステートメントを直接変更するのではなく、インスタンスメンバーの「カスタム SQL ステートメント」を変更する必要があります。 それは、データソース内の SQL ステートメントがデータのインポート中に上書きされる可能性があるためです。 カスタマイズするには、ガイド付き設定の「データソース SQL ステートメントのカスタマイズ」セクションにある [構成] ボタンをクリックします。 これにより、「SCCM インスタンス」のリストが表示されます。これらはそれぞれ 1 つの接続/インスタンスに対応し、以下の例の「AMS」などのように、指定されたプリフィックスで識別されます。 インスタンスプリフィックスをクリックすると、このプリフィックスの「インスタンスメンバー」のリストが表示されます。各インスタンスメンバーは、プライム (OOTB またはデフォルト) データソースからの特定のインスタンスデータソースの派生を表します。 インスタンスメンバーには、「カスタム SQL ステートメント」列があります。ここで、特定のインスタンス/プリフィックスに関連付けられた特定のデータソースに対してカスタム SQL ステートメントを設定できます。たとえば、プライム (デフォルト) SG-SCCM コンピューター ID データソースから派生した「AMS-SG-SCCM コンピューター ID」データソースのカスタム SQL ステートメントを指定できます。 このカスタム SQL ステートメントは、このデータソースのデフォルト SQL を上書きします。 マルチインスタンスのシナリオでは、インスタンスセットごとに異なるカスタム SQL ステートメントを使用できます。たとえば、「AMS-SG-SCCM コンピューター ID」に対して 1 つのカスタム SQL ステートメント、「EMEA-SG-SCCM コンピューター ID」に対して別のカスタム SQL を使用するなどです。 特定のインスタンスメンバーのデータソースにカスタム SQL ステートメントを追加するには、以下のようにします。 [インスタンスメンバー (Instance Member)] レコードをクリックします。 このフォームでは、[カスタム SQL ステートメント] フィールドに入力できます。 便宜上、[プライム SQL ステートメントをコピー] リンクをクリックして、[カスタム SQL ステートメント] フィールドに現在のデフォルト SQL ステートメントを (対応するプライムデータソースから) 入力できます。 これは、どのようなカスタマイズを意図する場合にも推奨される出発点となります。[更新] をクリックして変更を保存します。 注：[接続 ID] フィールドを SQL ステートメントに追加する必要はありません。インポートの実行中に自動的に挿入されます。 以下は、SQL ステートメントが使用される順序です。 「カスタム SQL ステートメント」：指定されている場合は 1 番目の優先順位。「カスタム SQL ステートメント」が指定されていない場合は「プライムデータソース」の [SQL ステートメント] フィールド。 上記の例では、「AMS-SG-SCCM コンピューター ID」がカスタム SQL ステートメントを使用します。 一方、「AMS-SG-SCCM ディスク」は、SG-SCCM ディスクで定義されたデフォルトの SQL ステートメントを使用します。 注：以前の SG-SCCM で「SQL ステートメント」をカスタマイズした顧客のアップグレードでは、SQL ステートメントのカスタマイズを [インスタンスメンバー] の [カスタム SQL ステートメント] フィールドに手動で移動する必要があります。 ServiceNow Software Asset Management Professional のデータソース 「データソースおよび予定されているデータインポートの構成」のガイド付き設定ステップが実行される前に「Software Asset Management Professional」プラグインがアクティブ化されている場合、次の追加のデータソースと予定されているデータインポートが生成されます。 <プリフィックス>-SG-SCCM SAMP の使用状況<プリフィックス>-SG-SCCM ソフトウェアエディション<プリフィックス>-前回使用した SG-SCCM ソフトウェア しかし、「データソースおよび予定されているデータインポートの構成」のガイド付き設定ステップを実行した後に「Software Asset Management Professional」をアクティブ化し、上記のデータソースと予定されているデータインポートを使用する場合は、「データソースおよび予定されているデータインポートの構成」のガイド付き設定ステップを再実行して、これらのデータソースと予定されているデータインポートを再生成する必要があります。 生成されたデータソースおよび予定されているデータインポートの編集または削除 既存の「プリフィックス」を使用して「データソースおよび予定されているデータインポートの構成」のガイド付き設定ステップを実行すると、新しいデータソースや既存の予定されているデータインポートを生成する代わりに、以前に生成されたデータソースおよび予定されているデータインポートが変更されます。 生成されたデータソースや予定されているデータインポートを削除する場合は、必要に応じてこれらを削除し、「データソースおよび予定されているデータインポートの構成」のガイド付き設定ステップを実行して再生成できます。 2 番目の SCCM インスタンスの追加 上記のとおり、Service Graph Connector for Microsoft SCCM (SG-SCCM) 3.0 リリースでは、複数の SCCM インスタンスから単一の ServiceNow CMDB にデータをインポートできます。 2 番目 (または 3 番目など) の SCCM インスタンス接続を定義するプロセスは、上記のように最初の接続を定義するのと同じです。 主なステップ： 上記のようにガイド付き設定の「接続の構成」ステップを使用して、SCCM インスタンスへの新しい接続と認証情報を作成します。 新しい一意のプリフィックスを使用して、データソースおよび予定されているデータインポートの新しいセットを作成します。 データソースを検証して接続を確認します。 新しいデータソースは、上記と同じプロセスでカスタマイズできます。 用語リスト 名前 定義 SCCM インスタンス 単一の SCCM ソースに関連付けられたデータソースのセット。(接続および資格情報エイリアス) SCCM インスタンスメンバー 「SCCM インスタンス」に関連付けられたデータソース。 プライムデータソース 特定の SCCM 接続に関連付けられたデータソースを生成するためのコピープロセスの作成元として使用されるテンプレートデータソース (デフォルト設定のデータソース)。 設定後の実行 上記の推奨事項に従ってすべての設定が完了したら、マルチインスタンス実行へのスムーズな移行を確実にするための最終ステップとして、SG-SCCM をフルデータロードで実行します。 上記の設定により、SG-SCCM のソースネイティブキー（sys_object_source.id フィールドに格納されている値）が変更されるため、SG-SCCM をフルデータロードで実行することが重要です。これにより、SG-SCCM から取得されるすべてのレコードのソースネイティブキーの新しい値が再設定されます。 これはシンプルです。増分処理が有効になっている SG-SCCM データソース（例：[最終実行日時を使用] == true）については、[最終実行日時] フィールドの値をクリア/空にしてください。これにより、SG-SCCM は SCCM からすべてのデータを強制的にロードします。すべてのデータについて、CMDBへのデータ処理中に、新しいソースネイティブキーの値がsys_object_sourceに保存されます。非増分モードで実行すると、エンドツーエンドの実行時間が長くなる可能性があることに注意してください。また、これは1回限りの変更であり、「最終実行日時を使用」がtrueに設定されているSG-SCCMデータソースは、この実行が完了すると増分モードに戻ります。