CMDB クエリビルダーを使用したサービスマッピングのクエリのビルド

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：6分

    • サービスマッピングのクエリタイプとは、クラスとそのクラス間の関係で構成されるパターンです。パターンを構築してクエリを実行すると、クエリはそのパターンを含むすべてのサービスマッピングサービスを返します。

    始める前に

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

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

    このタスクについて

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

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

    CMDB クエリビルダーでサービスマッピングクエリをビルドする詳しい手順については、「サンプルクエリ」を参照してください。

    手順

    1. 次のように移動する。 All (すべて) > 構成 > CMDB Query Builder.
    2. [CMDB クエリビルダー] ページで、次のいずれかの操作を行います。
      1. [新規作成]を選択します。
      2. [名前]を入力します。
      3. [クエリタイプ] として [サービスマッピングクエリ] を選択します。
      4. [作成] を選択します。
      5. 保存済みクエリのウィジェットを選択し、既存のクエリのビルドを続行します。必要に応じて、最初に保存済みクエリの検索を行います。
      6. 保存済みクエリのウィジェットの右上隅をポイントします。
      7. [重複クエリ] アイコンを選択して、保存済みクエリのコピーを編集します。
        新しいクエリのデフォルト名には文字列 'copy'が含まれています。
    3. キャンバスでは、次のいずれかを実行できます。
      • クエリに CI クラスを追加する：[CMDB クラス] 階層リストからクラスを選択し、それらをキャンバスにドラッグします。
      • キャンバス上の 2 つのノード間に接続 (関係) を追加する：
        1. 関係の最初のノードで、右側の中央にある小さな四角形を選択します。
        2. 関係の 2 番目のノードで、左側の中心にある小さな四角形を選択して、接続を作成します。
        3. 右側のバーの [接続のプロパティ] で、次のように設定します (必要に応じて接続ラインを選択します)。
          • [リレーションシップの方向] セクションで [親] ノードを選択します ([子] ノードは自動的に調整されます)。
          • [サービスクエリのプロパティ] セクションで、[関連 CI を検索します。] または [関連していない CI を検索します。] を選択して、2 つのクラスの間に関係があるパターンまたはないパターンをそれぞれクエリします。

            たとえば、Windows Server に接続されていないすべての Tomcat WAR CI です。

        表 : 1. 関係 UI 表記
        表記 説明
        破線 サービスマッピングクエリ内の関係。
      • クラスノードにフィルターを追加する：クラスを特定の 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. プロパティを選択し、プロパティリストの外側を選択して閉じます。
      • 列を選択し、結果のサービス セットに適用されるフィルターを追加する：
        1. 右側のバーにある [プロパティ] を選択してからキャンバス上の空白を選択し、何も選択されていないことを確認します。
        2. 右側のバーの下部で [列を追加] を選択し、追加する列を選択します。列リストの外側を選択して閉じます。
        3. キャンバスの上部にある [サービスマッピングクエリフィルターを適用] アイコンを選択し、フィルターを追加します。
      • クエリ全体を逆にして、クエリパターンを含まないすべてのサービスマッピングサービスを検索する：ノードを 1 ～ 2 回選択して、右側のバーにクエリのプロパティを表示させます。[メタデータ] セクションで [このパターンが含まれるサービス] を切り替えて、オプションを有効または無効にします。
      • 保存済みクエリの検索条件として使用できる検索タグを追加する：
        1. キャンバスの上部にある [タグを追加] アイコンを選択します。
        2. [タグを追加] を選択し、[クエリタグ] ダイアログボックスで 1 つまたは複数のタグ文字列を入力します。
        3. [タグを追加] アイコンをもう一度選択して [クエリタグ] ダイアログ ボックスを閉じます。
    4. [保存] を選択します。

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

    次のタスク

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

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

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

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

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

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