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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む9読むのに数分

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

    始める前に

    Core UI プラグイン (com.glide.ui.ui16) を有効にする必要があります。

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

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

    このタスクについて

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

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

    クエリビルダーの使用の詳細については、「CMDB Query Builder Queries and Reporting - Platform Analytics Academy (CMDB クエリビルダーのクエリとレポート - Platform Analytics Academy) ServiceNow Community」のビデオを参照してください。アプリケーションサービスに関連するクエリを含む、クエリビルダーでの CMDB クエリ構築の詳しい手順については、「サンプルクエリ」を参照してください。

    手順

    1. 移動先 すべて > 構成 をクリックし、[ CMDB Query Builder] をクリックします。
    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 フォームでは、[ダッシュボード] をクリックすると CI ダッシュボードで CI の健全性を表示できます。

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

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

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