---
sourceDocument: オーストラリア ServiceNow AI Platform の機能
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/servicenow-platform

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア ServiceNow AI Platform の機能

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# CMDB クエリを構築

# CMDB クエリビルダーを使用する CMDB クエリのビルド {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分

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

## 始める前に

必要なロール:保存済みクエリの表示と実行のみをcmdb_query_builder_readし、クエリの作成と保存、保存済みクエリの変更、およびクエリの実行をcmdb_query_builderします。クエリーのレポートには、レポート関連の ACL が必要です。

権限があるユーザーは、別のユーザーによって作成されたクエリを更新および[削除](https://servicenow-prod.fluidtopics.net/bmv4HJT9mrxEwlgyDyCDqg "使用または必要ではなくなった CMDB クエリを削除します。")できます。

## このタスクについて

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

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

クエリビルダーの使用の詳細については、「[CMDB クエリビルダーのクエリとレポート - プラットフォームアナリティクスアカデミー](https://www.youtube.com/watch?v=NArqszOamHc) ServiceNow コミュニティ」のビデオを参照してください。アプリケーションサービスに関連するクエリを含む、クエリビルダーでの CMDB クエリビルドの詳しい手順については、「[サンプルクエリ](https://servicenow-prod.fluidtopics.net/h5VQpbkdpUL6R9gmx_VXdQ "カスタム CMDB クエリおよびサービスマッピングクエリをビルドするためのモデルとして、サンプルクエリを使用します。")」を参照してください。

## 手順

1. 移動先 すべて設定 をクリックし、\[ CMDB クエリビルダー\] を選択します。
2. \[CMDB クエリビルダー\] ページで、次のいずれかの手順を行います。
   * \[新規作成\]を選択します。\[名前\] を入力し、\[クエリタイプ\] として \[CMDB クエリ\] を選択し、\[作成\] を選択します。
   * 保存済みクエリのウィジェットを選択し、既存のクエリのビルドを続行します。必要に応じて、最初に[保存済みクエリの検索](https://servicenow-prod.fluidtopics.net/k07tHv~MqZ4JW6oxV8cDwA "CMDB クエリビルダーを使用すると、クエリの名前、タイプ、カスタムタグ、クエリの作成者または更新者などの検索条件の任意の組み合わせを使用して、特定の保存済みクエリを検索できます。")を行います。
   * 保存済みクエリのウィジェットの右上隅をポイントし、\[重複クエリ\] アイコンを選択して、保存済みクエリのコピーを編集します。新しいクエリのデフォルト名には文字列「copy」が含まれています。
   {#use-cmdb-query-builder__choices_c2f_3zg_b3b}
3. キャンバスでは、次のいずれかの操作を実行できます。  
   * クエリに CI クラスを追加する：\[CMDB クラス\] タブで階層リストからクラスを選択し、それらをキャンバスにドラッグします。
   * クエリにアプリケーションサービス CI を追加する：\[CMDB クラス\] タブで階層リストから \[アプリケーションサービス\] を選択し、キャンバスにドラッグします。

     右側のバーの \[アプリケーションサービスプロパティ\] で \[接続ノードをパターンに変換\] を選択し、アプリケーションサービスと他の CMDB クラスノード間のパターンに対してクエリを実行できます。パターンに対してクエリを実行する場合、パターン接続の両端にあるノードは、任意の数のレベルだけ離れている可能性があります。\[接続ノードをパターンに変換\] が選択されていない場合、アプリケーションサービスノードと他の CMDB クラスノード間の接続は直接関係を表します。
   * クエリに非 CMDB テーブルを追加する：\[非 CMDB テーブル\] リストからテーブルを選択し、キャンバスにドラッグします。  
     注:  
     非 CMDB テーブルをクエリの開始ノードにすることはできません。
   * キャンバス上の 2 つのノード間に接続 (アプリケーションサービスの関係またはパターン) を追加する：
     1. 接続の最初のノードで、右側の中央にある小さな四角形を選択します。
     2. 接続の 2 番目のノードで、左側の中央にある小さな四角形を選択して、接続を作成します。
     {#use-cmdb-query-builder__ol_ig1_fw5_plb}  
     {#use-cmdb-query-builder__table_ipf_qw5_plb__entry__2}

     | 表記 | 説明 |
     |-|-|
     | フル ライン | CMDB クエリ内の関係。 |
     | 接続ラインの中央に赤のアスタリスク | 関係タイプなどの情報が欠落しているため、クエリが無効になります。 |
     | レベル：\<n\> タイプ：\<n\> または接続ラインの \<参照タイプ\> 表記 | 適用可能な場合：接続に含まれる関係レベルの数と関係タイプの数。または、参照である関係の参照タイプ。 |
     | 破線 | アプリケーションサービスノードと別のノード間のパターン接続。 |
     [表 : 1. 接続 UI 表記]

     {#use-cmdb-query-builder__table_ipf_qw5_plb}
   * 右側のバーの \[接続のプロパティ\] で関係性を設定します (必要に応じて接続ラインを選択します)。
     1. \[リレーションシップの方向\] セクションで \[親\] ノードを選択します (\[子\] ノードは自動的に調整されます)。
     2. \[リレーションシップレベル\] セクションで、CI が直接接続されている場合は \[レベル\] を \[第 1 レベルのリレーションシップ\] に設定します。CI が直接接続されているか、別の CI を介して間接的に接続されている場合は、\[第 2 レベル リレーションシップまで\] に設定します。
     3. \[リレーションシップタイプと関連アイテム\] セクションで、いずれかのオプションを選択します。{#use-cmdb-query-builder__table_xsh_c1h_b3b__entry__2}

        | オプション | 説明 |
        |-|-|
        | 関係性なし | 接続している関係がない CI をクエリする (`Windows Server に接続されていないすべての Tomcat WAR CI`など)。 |
        | 関係タイプを追加 | 固有または任意の関係タイプを選択する。 |
        | 関連アイテムを追加 | ノード間の関連 CI をクエリする。 |
        [ ]

        {#use-cmdb-query-builder__table_xsh_c1h_b3b}
     {#use-cmdb-query-builder__ol_mb1_xld_rw}
   * 非 CMDB テーブルへの接続の CI 参照列を設定します。\[接続のプロパティ\] の右側のバーの \[CI 参照列\] セクションで、\[CI 参照列を使用\] リストから CI の参照を含む列を選択します。オプションが 1 つしかない場合は自動的に選択されます。
   * \[接続ノードをパターンに変換\] オプションで設定されたアプリケーションサービスノードと非 CMDB テーブルノード間でパターンを設定します。アプリケーションサービス CI 自体とアプリケーションサービス内の CI にクエリを適用するには、\[このパターンのすべてのノードに \<table\> 参照フィルターを適用\] を選択します。
   * クラスノードにフィルターを追加する：クラスクエリを特定の CI セットまたは単一の特定 CI に絞り込むためのフィルターを適用します。  
     1. フィルターを追加するノードをポイントし、ノードの上にポップアップ表示される \[フィルターを適用\] アイコンを選択します。
     2. \[フィルター\] セクションで、属性および[関連リスト条件](https://www.servicenow.com/docs/access?context=create-related-list-query&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)を追加します。
     3. \[フィルター\] セクションを閉じます。
     {#use-cmdb-query-builder__ol_s2b_nnd_rw}たとえば、データベースロケーションのフィルターを追加して、シアトルにあるデータベースをクエリします。

     右側のバーにある \[適用済みフィルター\] を選択して、キャンバス上にある各ノードのすべてのフィルターを表示します。
   * And/Or 演算子をクエリに追加する：  
     1. 1 つのノードを他の 2 つのノードに接続します。
     2. 接続ライン上に表示される \[AND\] ボックスを選択して、\[AND\]/\[OR\] 演算子を切り替えます。

     {#use-cmdb-query-builder__ol_uyd_3vp_rw}たとえば、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. プロパティを選択し、プロパティリストの外側を選択して閉じます。
     {#use-cmdb-query-builder__ol_bhh_3qd_rw}
   * サービスマッピング クエリを CMDB クエリに統合して組み合わせクエリを作成する：  
     1. CMDB クエリをビルドするときは、左側のバーで \[保存済みサービスクエリ\] を選択します。
     2. サービスマッピングクエリを選択し、キャンバスにドラッグします。

     {#use-cmdb-query-builder__ol_zlh_lgh_hx}このクエリは、CMDB クエリに適合し、埋め込みのサービスマッピングクエリによって返されるサービスに含まれるすべての CI を返します。
   * 保存済みクエリの検索条件として使用できる検索タグを追加する：
     1. キャンバスの上部にある \[タグを追加\] アイコンを選択します。
     2. \[タグを追加\] を選択し、\[クエリタグ\] ダイアログボックスで 1 つまたは複数のタグ文字列を入力します。
     3. \[タグを追加\] アイコンをもう一度選択して \[クエリタグ\] ダイアログ ボックスを閉じます。
     {#use-cmdb-query-builder__ol_sm5_1pb_4y}
   {#use-cmdb-query-builder__ul_umc_tjd_rw}
4. \[保存\] を選択します。  
   \[保存済みクエリ\] タブで保存済みクエリのウィジェットをポイントし、\[クエリ情報\] を選択します。クエリに関連付けられたクエリタイプ、最終更新日、CMDB グループ、クエリスケジュールなどのクエリの詳細が表示されます。

## 次のタスク

* \[実行\] を選択します。

  クエリの結果のうち最初の 100 件のみが結果ペインに表示されます。
  * \[結果をさらにロード\] を選択すると、次の 100 件の結果セットが表示されます。  
    注:  
    このオプションは、V1 エンジン実行モードでのみ使用できます。CMDB クエリエンジンの実行モードの詳細については、「 [クエリを実行するための実行モードを設定する](https://servicenow-prod.fluidtopics.net/mtOfTW7v4xDtGhPpiMzUYg "クエリを実行するときに使用する実行モードをクエリレベルで構成します。実行モードによって、クエリがパフォーマンス向上エンジン (V2) またはレガシーエンジン (V1) のどちらを使用して実行されるかが決まります。")」を参照してください。
  * \[すべての結果をロード\] を選択すると、クエリ結果の残りが表示されます。最大件数は [glide.cmdb.query.max_results_limit](https://servicenow-prod.fluidtopics.net/IL8OOFNvetGi4Pot8D92TA "プロパティ値を設定してクエリ処理を構成します。") システムプロパティで指定した数です (デフォルトでは 10,000)。
  {#use-cmdb-query-builder__ul_gfw_42t_w1b}

  CI を選択してその CI フォームを開き、\[CI\] フォームで \[CMDB ワークスペースで開く\] を選択して、CMDB ワークスペースの \[CI 健全性\] タイルで CI 健全性を表示します。この操作には、sn_cmdb_user (CMDB ユーザー) ロールが必要です。  
  注:  
  * すべての結果が表示されるように、[glide.security.use_csrf_token](https://servicenow-prod.fluidtopics.net/entWKznzKxto1vdeeqh7nQ "パスワードリセット Windows アプリケーションのセキュリティ設定を構成します。") プロパティが \[true\] に設定されていることを確認します。
  * \[レベル\] が \[第 2 レベル リレーションシップまで\] に設定された場合、関係タイプがクエリ結果に表示されません。
  * クエリが実行されているときは、クエリが完了するまで待つか、タイムアウトしてから別のクエリを開くか実行してください。
  {#use-cmdb-query-builder__ul_f44_jyr_mfb}
* [クエリビルダーの設定を変更する](https://servicenow-prod.fluidtopics.net/WEOhxprFXPdwzwQK_jWWFw "CMDB クエリビルダーの機能の一部を制御する設定を構成します。"):\[設定\] アイコンを選択して、\[ クエリビルダー設定 \] ダイアログボックスを開きます。
* 保存済みクエリの URL をコピーし、CMDB クエリビルダーにアクセスできるユーザーと共有します。共有された URL を新しいインターネットブラウザウィンドウに貼り付けると、CMDB クエリビルダーに保存済みクエリが直接開きます。
* [CMDB クエリビルダーでのレポートの作成](https://servicenow-prod.fluidtopics.net/WxMk64bBfH8~IahqV~dEHA "CMDB クエリビルダーレポートを使用して、CMDB クエリまたはサービスマッピングクエリの結果を表示します。基本的なレポートを作成するか、関連する保存済みクエリの結果が変更されると自動的に更新される動的レポートを作成します。")。
* 将来クエリを実行し、結果を関係者に電子メールで送信するには、[スケジュールを作成](https://servicenow-prod.fluidtopics.net/Jh4BmgiWcDfHRmmo8a7qCQ "スケジュールされた時間に一度、または繰り返しスケジュールで保存済みの CMDB クエリを実行し、クエリ結果を指定されたユーザーにメール送信するようにスケジュールします。")します。
* クエリ結果をエクスポートする： \[クエリ結果\] コンテキストメニューを選択し、\[エクスポート\] を選択します。追加のクエリ結果があることを示す \[結果をさらにロード\] ボタンが表示されている場合でも、表示されている結果のみがエクスポートされます。

* [CMDB クエリのエクスポートとインポート](https://servicenow-prod.fluidtopics.net/tdaZPyTdzaOubjZlYMHyvQ "保存済みの CMDB クエリまたはサービスマッピングクエリの定義は、XML ファイルにエクスポートし、後でインポートして、CMDB クエリビルダーで実行することができます。このプロセスでは、インスタンス間で (たとえば開発環境から本番環境へ) 保存済みクエリをポートできます。") で、インスタンス間でクエリ定義を移植します。
* 保存済みクエリを使用して [CMDB グループに入力](https://servicenow-prod.fluidtopics.net/VMPz7T_hLTfibehjlFrjYw#populate-cmdb-grp-saved-query "グループ タイプに応じて、個々の CI を手動で追加したり、保存されている CMDB クエリーを選択したり、CMDB グループ自体にエンコード クエリーを作成したりして、CMDB グループを追加することができます。各クエリーの結果の CI がメンバーとしてグループに追加されます。")します。
* [CMDB クエリの削除](https://servicenow-prod.fluidtopics.net/bmv4HJT9mrxEwlgyDyCDqg "使用または必要ではなくなった CMDB クエリを削除します。")。
{#use-cmdb-query-builder__ul_jhq_hdx_rw}
**関連概念**   

* [サンプルクエリ](https://servicenow-prod.fluidtopics.net/h5VQpbkdpUL6R9gmx_VXdQ "カスタム CMDB クエリおよびサービスマッピングクエリをビルドするためのモデルとして、サンプルクエリを使用します。")