Erstellen Sie eine CMDB-Abfrage mit dem CMDB-Abfragegenerator

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 7 Minuten Lesedauer

    • Ein CMDB-Abfragetyp, der die Infrastruktur nach CI-Klassen und optional nicht-CMDB-Tabellen sowie den Beziehungen und Referenzen abfragt, die sie verbinden.

    Vorbereitungen

    Erforderliche Rolle: cmdb_query_Builder_read, um nur gespeicherte Abfragen anzuzeigen und auszuführen, und cmdb_query_Builder (enthalten für itil, itil_admin und Asset), um Abfragen zu erstellen und zu speichern, gespeicherte Abfragen zu ändern und auszuführen. Für die Berichterstellung zu Abfragen sind berichtbezogene ACLs erforderlich.

    Autorisierte Anwender können und aktualisieren Löschen Eine von einem anderen Anwender erstellte Abfrage.

    Warum und wann dieser Vorgang ausgeführt wird

    Erstellen Sie die Abfrage, indem Sie die CI-Klassen und nicht-CMDB-Tabellen ziehen, die Sie in die Abfrage aufnehmen möchten. Sie werden dann als Knoten auf der Canvas abgelegt und Beziehungseigenschaften zwischen ihnen definiert. Sie können nach den Attributen eines beliebigen Knotens filtern, um die Ergebnisse auf einen bestimmten Satz von CIs dieser Klasse oder auf ein einzelnes bestimmtes CI einzugrenzen. Sie können auch auswählen, welche Eigenschaftsspalten in den Abfrageergebnissen angezeigt werden.

    Beim Erstellen einer Abfrage werden Listenoptionen und andere Anwenderoberflächenelemente des CMDB-Abfragegenerators entsprechend Ihrer Auswahl dynamisch gefiltert.

    Weitere Informationen zur Verwendung des Abfragegenerators finden Sie unter CMDB-Abfragegenerator – Abfragen und Reporting – Platform Analytics Academy ServiceNow Community Video. Eine Schritt-für-Schritt-Anleitung zum Erstellen von CMDB-Abfragen im Abfragegenerator, einschließlich Abfragen mit Anwendungsservices, finden Sie unter Beispielanfragen.

    Prozedur

    1. Navigieren zu Alle > Konfiguration Und wählen Sie aus CMDB-Abfragegenerator .
    2. Auf der CMDB-Abfragegenerator Seite Führen Sie einen der folgenden Schritte aus:
      • Wählen Sie Neu erstellen. Geben Sie ein Name , Wählen Sie CMDB-Abfrage Als Abfragetyp , Und wählen Sie dann aus Erstellen .
      • Wählen Sie ein Widget einer gespeicherten Abfrage aus, um mit der Erstellung einer vorhandenen Abfrage fortzufahren. Suchen Sie nach einer gespeicherten Abfrage Zuerst bei Bedarf.
      • Zeigen Sie auf die obere rechte Ecke eines gespeicherten Abfrage-Widgets, und wählen Sie aus Doppelte Abfrage Symbol zum Bearbeiten einer Kopie einer gespeicherten Abfrage. Der Standardname der neuen Abfrage enthält die Zeichenfolge „Copy“.
    3. Auf der Canvas können Sie einen der folgenden Vorgänge ausführen:
      • Fügen Sie der Abfrage CI-Klassen hinzu: Auf der CMDB-Klassen Wählen Sie Klassen aus der Hierarchieliste aus, und ziehen Sie sie in die Canvas.

      • Fügen Sie der Abfrage ein Anwendungsservice-CI hinzu: Auf der CMDB-Klassen Wählen Sie die Registerkarte aus Anwendungsservice Klasse aus der Hierarchieliste und ziehen Sie sie in die Canvas.

        In Anwendungsservice-Eigenschaften in der rechten Leiste können Sie auswählen Konvertieren Sie angehängte Knoten in Muster Dient zum Abfragen von Mustern zwischen dem Anwendungsservice und anderen CMDB-Klassenknoten. Bei der Abfrage eines Musters können die Knoten an beiden Enden der Musterverbindung eine beliebige Anzahl von Ebenen voneinander entfernt sein. Wenn Konvertieren Sie angehängte Knoten in Muster Ist nicht ausgewählt, stellt die Verbindung zwischen dem Anwendungsserviceknoten und anderen CMDB-Klassenknoten direkte Beziehungen dar.

      • Fügen Sie der Abfrage nicht-CMDB-Tabellen hinzu: Wählen Sie eine Tabelle aus Nicht-CMDB-Tabellen Listen Sie sie auf, und ziehen Sie sie in die Canvas.
        Hinweis:
        Eine nicht-CMDB-Tabelle kann nicht der Startknoten in der Abfrage sein.
      • Fügen Sie Verbindungen (Beziehungen oder Muster für Anwendungsservices) zwischen zwei Knoten im Canvas hinzu:
        1. Wählen Sie auf dem ersten Knoten in der Verbindung das kleine Quadrat in der Mitte der rechten Seite aus.
        2. Wählen Sie auf dem zweiten Knoten in der Verbindung das kleine Quadrat in der Mitte der linken Seite aus, um die Verbindung zu erstellen.
        Tabelle : 1. Verbindungs-UI-Notationen
        Notation Beschreibung
        Durchgezogene Linie Eine Beziehung in einer CMDB-Abfrage.
        Rotes Sternchen in der Mitte der Verbindungslinie Informationen wie beispielsweise „Der Beziehungstyp fehlt“, wodurch die Abfrage ungültig wird.
        Ebenen:<n>-Typen:<n> Oder ein <Reference type> Schreibweise in der Verbindungszeile

        Gegebenenfalls: Die Anzahl der Beziehungsebenen und die Anzahl der Beziehungstypen, die für die Verbindung enthalten sind. Oder ein Referenztyp für eine Beziehung, die eine Referenz ist.
        Gestrichelte Linie Eine Musterverbindung zwischen einem Anwendungsserviceknoten und einem anderen Knoten.
      • Konfigurieren Sie in den Verbindungseigenschaften in der rechten Seitenleiste Beziehungseinstellungen (wählen Sie bei Bedarf die Verbindungsleitung aus):
        1. Wählen Sie im Abschnitt Beziehungsrichtung die aus Übergeordnet Knoten (die Untergeordnet Knoten wird automatisch angepasst).
        2. Legen Sie im Abschnitt Beziehungsebenen fest Ebene Bis Beziehungen der ersten Ebene Wenn die CIs direkt verbunden sind. Oder, Bis zu Beziehungen der 2. Ebene Wenn die CIs entweder direkt oder indirekt über ein anderes CI verbunden sind.
        3. Wählen Sie im Abschnitt Beziehungstypen und zugehörige Elemente eine der folgenden Optionen aus:
          Option Beschreibung
          Keine Beziehungen Zum Abfragen von CIs ohne verbindende Beziehungen, z. B. Alle Tomcat-WAR-CIs, die nicht mit einem Windows-Server verbunden sind .
          Beziehungstypen hinzufügen Zum Auswählen eines bestimmten oder eines beliebigen Beziehungstyps.
          Ein zugehöriges Element hinzufügen Zum Abfragen von zugehörigen CIs zwischen den Knoten.
      • Konfigurieren Sie die CI-Referenzspalte für eine Verbindung zu einer nicht-CMDB-Tabelle: Wählen Sie in der rechten Leiste Verbindungseigenschaften im Abschnitt CI-Referenzspalte die Spalte mit einem Verweis auf ein CI aus Verwenden Sie die CI-Referenzspalte Liste. Wenn nur eine Option verfügbar ist, wird sie automatisch ausgewählt.
      • Konfigurieren Sie das Muster zwischen einem Anwendungsserviceknoten, der mit festgelegt wurde Konvertieren Sie angehängte Knoten in Muster Option und einen nicht-CMDB-Tabellenknoten: Wählen Sie aus Anwenden <table>Referenzfilter für alle Knoten im Muster Dient zum Anwenden der Abfrage auf das Anwendungsservice-CI selbst und auf die CIs innerhalb des Anwendungsservice.
      • Filter zu einem Klassenknoten hinzufügen: Wenden Sie Filter an, um eine Klassenabfrage auf einen bestimmten Satz von CIs oder ein einzelnes bestimmtes CI einzugrenzen.
        1. Zeigen Sie auf den Knoten, dem Sie einen Filter hinzufügen möchten, und wählen Sie dann aus Filter anwenden Symbol, das über dem Knoten angezeigt wird.
        2. Fügen Sie im Abschnitt Filter Attribute und hinzu Zugehörige Listenbedingungen .
        3. Schließen Sie Filter Abschnitt.
        Beispiel: Fügen Sie einen Filter für den Datenbankspeicherort hinzu, um Datenbanken in Seattle abzufragen.

        Wählen Sie Aus Angewendete Filter In der rechten Seitenleiste, um alle Filter für jeden Knoten im Canvas anzuzeigen.

      • Fügen Sie der Abfrage und/oder Operatoren hinzu:
        1. Verbinden Sie einen Knoten mit zwei anderen Knoten.
        2. Wählen Sie aus Und Feld, das in der Verbindungszeile angezeigt wird, um zwischen umzuschalten Und / Oder Operatoren.
        Beispiel: C1 ist Tomcat WAR, C2 ist Linux Server und C3 ist Windows Server. Abfrage für Alle Tomcat-WAR-CIs, die entweder mit einem Linux-Server oder einem Windows-Server verbunden sind .
      • Fügen Sie Eigenschaftsspalten für einen Knoten hinzu, die in den Abfrageergebnissen angezeigt werden sollen:
        Hinweis:
        Für eine Beziehung enthalten die Abfrageergebnisse die parent, child, Und typeSpalten. Sie können keine anderen Spalten aus der Tabelle [cmdb_rel_ci] hinzufügen.
        1. Wählen Sie Aus Eigenschaften Im rechten Seitenbereich.
        2. Wählen Sie einen Knoten einmal oder zweimal aus, damit der Abschnitt Berichtsspalten in der rechten Seitenleiste angezeigt wird, und wählen Sie dann aus Fügen Sie Spalten Hinzu .
        3. Wählen Sie Eigenschaften aus, und wählen Sie dann außerhalb der Eigenschaftenliste aus, um sie zu schließen.
      • Erstellen Sie eine kombinierte Abfrage, indem Sie eine Service-Mapping-Abfrage in eine CMDB-Abfrage integrieren:
        1. Wählen Sie beim Erstellen einer CMDB-Abfrage aus Gespeicherte Serviceabfragen In der linken Leiste.
        2. Wählen Sie ein aus, und ziehen Sie es dann Service-Mapping Abfrage des Canvas.
        Diese Abfrage gibt alle CIs zurück, die die CMDB-Abfrage erfüllen und in den Services enthalten sind, die vom eingebetteten zurückgegeben werden Service-Mapping Abfrage.
      • Fügen Sie ein Such-Tag hinzu, das dann als Suchkriterium für gespeicherte Abfragen verwendet werden kann:
        1. Wählen Sie aus Tags Hinzufügen Symbol oben auf der Canvas.
        2. Wählen Sie Aus Tag Hinzufügen Und in Abfrage-Tags Geben Sie im Dialogfeld eine oder mehrere Tag-Zeichenfolgen ein.
        3. Wählen Sie aus Tags Hinzufügen Symbol zum Schließen von erneut Abfrage-Tags Dialogfeld.
    4. Wählen Sie Speichern.

      Auf der Gespeicherte Abfragen Registerkarte zeigen Sie auf ein gespeichertes Abfrage-Widget, und wählen Sie aus Abfrageinformationen . Abfragedetails wie Abfragetyp, Datum der letzten Aktualisierung, CMDB-Gruppen, die der Abfrage zugeordnet sind, und Abfragezeitpläne werden angezeigt.

    Nächste Maßnahme

    • Wählen Sie Ausführen.

      Nur die ersten 100 Ergebnisse der Abfrage werden im Ergebnisbereich angezeigt.
      • Wählen Sie Aus Laden Sie Weitere Ergebnisse Zum Anzeigen des nächsten Satzes von 100 Ergebnissen.
      • Wählen Sie Aus Alle Ergebnisse Laden Zum Anzeigen der restlichen Abfrageergebnisse bis zu der von angegebenen Anzahl Glide.cmdb.query.max_results_limit Systemeigenschaft (standardmäßig 10.000).

      Wählen Sie ein CI aus, um das CI-Formular zu öffnen, und wählen Sie im CI-Formular die Option aus Öffnen Sie im CMDB-Arbeitsbereich Dient zum Anzeigen der CI-Integrität in der Kachel „CI-Integrität“ im CMDB-Arbeitsbereich. Dieser Vorgang erfordert die Rolle sn_cmdb_user (CMDB-Anwender).

      Hinweis:
      • Stellen Sie sicher, dass glide.security.use_csrf_token Eigenschaft ist auf „wahr“ festgelegt, sodass alle Ergebnisse angezeigt werden können.
      • Wenn Ebene Ist auf festgelegt Bis zu Beziehungen der 2. Ebene , Der Beziehungstyp wird nicht in den Abfrageergebnissen angezeigt.
      • Wenn eine Abfrage ausgeführt wird, warten Sie, bis die Abfrage abgeschlossen ist oder eine Zeitüberschreitung auftritt, bevor Sie eine andere Abfrage öffnen oder ausführen.
    • Ändern Sie die Einstellungen des Abfragegenerators : Wählen Sie aus Symbol „Einstellungen“.( Einstellungen )-Symbol zum Öffnen von Einstellungen Des Abfragegenerators Dialogfeld.
    • Kopieren Sie die URL einer gespeicherten Abfrage, und geben Sie sie für Anwender frei, die Zugriff auf den CMDB-Abfragegenerator haben. Durch das Einfügen der freigegebenen URL in ein neues Internetbrowserfenster wird die gespeicherte Abfrage direkt im CMDB-Abfragegenerator geöffnet.
    • Erstellen Sie einen Bericht im CMDB-Abfragegenerator.
    • Erstellen Sie einen Zeitplan, um die Abfrage zu einem späteren Zeitpunkt auszuführen und die Ergebnisse per E-Mail an interessierte Parteien zu senden.
    • Abfrageergebnisse exportieren:

      Wählen Sie das Kontextmenü Abfrageergebnisse aus, und wählen Sie aus Exportieren . Auch wenn Laden Sie Weitere Ergebnisse Die Schaltfläche ist sichtbar und gibt an, dass zusätzliche Abfrageergebnisse vorhanden sind. Nur die sichtbaren Ergebnisse werden exportiert.

    • Exportieren und importieren Sie eine CMDB-Abfrage Dient zum Portieren einer Abfragedefinition zwischen Instanzen.
    • Füllen Sie eine CMDB-Gruppe aus Mithilfe einer gespeicherten Abfrage.
    • Löschen Sie eine CMDB-Abfrage.