CMDB クエリビルダーを使用する CMDB クエリのビルド

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：9分

    • インフラストラクチャに対して CI クラスおよびオプションで非 CMDB テーブル、ならびにそれらを接続する関係と参照をクエリする CMDB クエリタイプです。

    始める前に

    必要なロール：保存済みクエリの表示および実行のみの場合は cmdb_query_builder_read、クエリの作成と保存、保存済みクエリの変更、およびクエリの実行の場合は cmdb_query_builder (itil、itil_admin および asset に含まれる)。クエリーのレポートには、レポート関連の ACL が必要です。

    権限があるユーザーは、別のユーザーによって作成されたクエリを更新および削除できます。

    このタスクについて

    クエリに含める CI クラスおよび非 CMDB テーブルをドラッグしてクエリをビルドします。次に、それらをノードとしてキャンバスにドロップし、それらの関係プロパティを定義します。任意のノードについて、その属性をフィルタリングして、そのクラスの特定の CI セットまたは特定の単一の CI に結果を絞り込むことができます。クエリ結果に表示されるプロパティ列を選択することもできます。

    クエリのビルドをステップ実行すると、CMDB クエリビルダーのリストオプションおよび他のユーザーインターフェイス要素は、選択内容に合わせて動的にフィルタリングされます。

    クエリビルダーの使用の詳細については、「CMDB クエリビルダーのクエリとレポート - プラットフォームアナリティクスアカデミー ServiceNow Community」のビデオを参照してください。アプリケーションサービスに関連するクエリを含む、クエリビルダーでの CMDB クエリビルドの詳しい手順については、「サンプルクエリ」を参照してください。

    手順

    1. 移動先 すべて > 構成 をクリックし、[ CMDB Query Builder (CMDB クエリビルダー)] を選択します。
    2. [CMDB クエリビルダー] ページで、次のいずれかの手順を行います。
      • [新規作成]を選択します。[名前] を入力し、[クエリタイプ] として [CMDB クエリ] を選択し、[作成] を選択します。
      • 保存済みクエリのウィジェットを選択し、既存のクエリのビルドを続行します。必要に応じて、最初に保存済みクエリの検索を行います。
      • 保存済みクエリのウィジェットの右上隅をポイントし、[重複クエリ] アイコンを選択して、保存済みクエリのコピーを編集します。新しいクエリのデフォルト名には文字列「copy」が含まれています。
    3. キャンバスでは、次のいずれかの操作を実行できます。
      • クエリに CI クラスを追加する：[CMDB クラス] タブで階層リストからクラスを選択し、それらをキャンバスにドラッグします。

      • クエリにアプリケーションサービス CI を追加する：[CMDB クラス] タブで階層リストから [アプリケーションサービス] を選択し、キャンバスにドラッグします。

        右側のバーの [アプリケーションサービスプロパティ] で [接続ノードをパターンに変換] を選択し、アプリケーションサービスと他の CMDB クラスノード間のパターンに対してクエリを実行できます。パターンに対してクエリを実行する場合、パターン接続の両端にあるノードは、任意の数のレベルだけ離れている可能性があります。[接続ノードをパターンに変換] が選択されていない場合、アプリケーションサービスノードと他の CMDB クラスノード間の接続は直接関係を表します。

      • クエリに非 CMDB テーブルを追加する：[非 CMDB テーブル] リストからテーブルを選択し、キャンバスにドラッグします。
        注:
        非 CMDB テーブルをクエリの開始ノードにすることはできません。
      • キャンバス上の 2 つのノード間に接続 (アプリケーションサービスの関係またはパターン) を追加する：
        1. 接続の最初のノードで、右側の中央にある小さな四角形を選択します。
        2. 接続の 2 番目のノードで、左側の中央にある小さな四角形を選択して、接続を作成します。
        表 : 1. 接続 UI 表記
        表記 説明
        フル ライン CMDB クエリ内の関係。
        接続ラインの中央に赤のアスタリスク 関係タイプなどの情報が欠落しているため、クエリが無効になります。
        レベル：<n> タイプ：<n> または接続ラインの <参照タイプ> 表記

        適用可能な場合：接続に含まれる関係レベルの数と関係タイプの数。または、参照である関係の参照タイプ。
        破線 アプリケーションサービスノードと別のノード間のパターン接続。
      • 右側のバーの [接続のプロパティ] で関係性を設定します (必要に応じて接続ラインを選択します)。
        1. [リレーションシップの方向] セクションで [親] ノードを選択します ([子] ノードは自動的に調整されます)。
        2. [リレーションシップレベル] セクションで、CI が直接接続されている場合は [レベル] を [第 1 レベルのリレーションシップ] に設定します。CI が直接接続されているか、別の CI を介して間接的に接続されている場合は、[第 2 レベル リレーションシップまで] に設定します。
        3. [リレーションシップタイプと関連アイテム] セクションで、いずれかのオプションを選択します。
          オプション 説明
          関係性なし 接続している関係がない CI をクエリする (Windows Server に接続されていないすべての Tomcat WAR CIなど)。
          関係タイプを追加 固有または任意の関係タイプを選択する。
          関連アイテムを追加 ノード間の関連 CI をクエリする。
      • 非 CMDB テーブルへの接続の CI 参照列を設定します。[接続のプロパティ] の右側のバーの [CI 参照列] セクションで、[CI 参照列を使用] リストから CI の参照を含む列を選択します。オプションが 1 つしかない場合は自動的に選択されます。
      • [接続ノードをパターンに変換] オプションで設定されたアプリケーションサービスノードと非 CMDB テーブルノード間でパターンを設定します。アプリケーションサービス CI 自体とアプリケーションサービス内の CI にクエリを適用するには、[このパターンのすべてのノードに <table> 参照フィルターを適用] を選択します。
      • クラスノードにフィルターを追加する：クラスクエリを特定の CI セットまたは単一の特定 CI に絞り込むためのフィルターを適用します。
        1. フィルターを追加するノードをポイントし、ノードの上にポップアップ表示される [フィルターを適用] アイコンを選択します。
        2. [フィルター] セクションで、属性および関連リスト条件を追加します。
        3. [フィルター] セクションを閉じます。
        たとえば、データベースロケーションのフィルターを追加して、シアトルにあるデータベースをクエリします。

        右側のバーにある [適用済みフィルター] を選択して、キャンバス上にある各ノードのすべてのフィルターを表示します。

      • And/Or 演算子をクエリに追加する：
        1. 1 つのノードを他の 2 つのノードに接続します。
        2. 接続ライン上に表示される [AND] ボックスを選択して、[AND]/[OR] 演算子を切り替えます。
        たとえば、C1 は Tomcat WAR、C2 は Linux サーバー、C3 は Windows Server です。Linux サーバーまたは Windows Server に接続されているすべての Tomcat WAR CI をクエリします。
      • クエリ結果に表示する、ノードのプロパティ列を追加する：
        注:
        関係の場合、クエリ結果にはparent、child、およびtype列が表示されます。[cmdb_rel_ci] テーブルから他の列を追加することはできません。
        1. 右側のペインにある [プロパティ] を選択します。
        2. 右側のバーに [レポート列] セクションが表示されるようにノードを 1 ～ 2 回選択し、[列を追加] を選択します。
        3. プロパティを選択し、プロパティリストの外側を選択して閉じます。
      • サービスマッピング クエリを CMDB クエリに統合して組み合わせクエリを作成する：
        1. CMDB クエリをビルドするときは、左側のバーで [保存済みサービスクエリ] を選択します。
        2. サービスマッピングクエリを選択し、キャンバスにドラッグします。
        このクエリは、CMDB クエリに適合し、埋め込みのサービスマッピングクエリによって返されるサービスに含まれるすべての CI を返します。
      • 保存済みクエリの検索条件として使用できる検索タグを追加する：
        1. キャンバスの上部にある [タグを追加] アイコンを選択します。
        2. [タグを追加] を選択し、[クエリタグ] ダイアログボックスで 1 つまたは複数のタグ文字列を入力します。
        3. [タグを追加] アイコンをもう一度選択して [クエリタグ] ダイアログ ボックスを閉じます。
    4. [保存] を選択します。

      [保存済みクエリ] タブで保存済みクエリのウィジェットをポイントし、[クエリ情報] を選択します。クエリに関連付けられたクエリタイプ、最終更新日、CMDB グループ、クエリスケジュールなどのクエリの詳細が表示されます。

    次のタスク

    • [実行] を選択します。

      クエリの結果のうち最初の 100 件のみが結果ペインに表示されます。
      • [結果をさらにロード] を選択すると、次の 100 件の結果セットが表示されます。
      • [すべての結果をロード] を選択すると、クエリ結果の残りが表示されます。最大件数は glide.cmdb.query.max_results_limit システムプロパティで指定した数です (デフォルトでは 10,000)。

      CI を選択してその CI フォームを開き、[CI] フォームで [CMDB ワークスペースで開く] を選択して、CMDB ワークスペースの [CI 健全性] タイルで CI 健全性を表示します。この操作には、sn_cmdb_user (CMDB ユーザー) ロールが必要です。

      注:
      • すべての結果が表示されるように、glide.security.use_csrf_token プロパティが [true] に設定されていることを確認します。
      • [レベル] が [第 2 レベル リレーションシップまで] に設定された場合、関係タイプがクエリ結果に表示されません。
      • クエリが実行されているときは、クエリが完了するまで待つか、タイムアウトしてから別のクエリを開くか実行してください。
    • クエリビルダーの設定を変更する：設定アイコン (設定) アイコンを選択して [クエリビルダー設定] ダイアログボックスを開きます。
    • 保存済みクエリの URL をコピーし、CMDB クエリビルダーにアクセスできるユーザーと共有します。共有された URL を新しいインターネットブラウザウィンドウに貼り付けると、CMDB クエリビルダーに保存済みクエリが直接開きます。
    • CMDB クエリビルダーでのレポートの作成。
    • 将来クエリを実行し、結果を関係者に電子メールで送信するには、スケジュールを作成します。
    • クエリ結果をエクスポートする：

      [クエリ結果] コンテキストメニューを選択し、[エクスポート] を選択します。追加のクエリ結果があることを示す [結果をさらにロード] ボタンが表示されている場合でも、表示されている結果のみがエクスポートされます。

    • CMDB クエリのエクスポートとインポート で、インスタンス間でクエリ定義を移植します。
    • 保存済みクエリを使用して CMDB グループに入力します。
    • CMDB クエリの削除。