Erstellen Sie eine CMDB-Abfrage mit dem CMDB-Abfragegenerator

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 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 zum Anzeigen und Ausführen gespeicherter Abfragen und cmdb_query_Builder zum Erstellen und Speichern von Abfragen, Ändern gespeicherter Abfragen und Ausführen von Abfragen. Für die Berichterstellung zu Abfragen sind Berichtsbezogene 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 je nach Auswahl dynamisch gefiltert.

    Weitere Informationen zur Verwendung des Abfragegenerators finden Sie unter CMDB-Abfragegenerator – Abfragen und Berichterstellung – 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 Beispielabfragen.

    Prozedur

    1. Navigieren zu Alle > Konfiguration Und wählen Sie aus CMDB-Abfragegenerator .
    2. Auf CMDB-Abfragegenerator Seite Führen Sie einen der folgenden Schritte aus:
      • Wählen Sie Neu erstellen. Geben Sie ein Name , Wählen Sie aus 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, falls erforderlich.
      • 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 dem Canvas können Sie einen der folgenden Vorgänge ausführen:
      • Fügen Sie der Abfrage CI-Klassen hinzu: Auf CMDB-Klassen Wählen Sie Klassen aus der Hierarchieliste aus, und ziehen Sie sie in den Canvas.

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

        In den 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 getrennt 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 den 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 auf der 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
        Darstellung Beschreibung
        Vollständige Zeile Eine Beziehung in einer CMDB-Abfrage.
        Rotes Sternchen in der Mitte der Verbindungsleitung Informationen wie Beziehungstyp fehlen, wodurch die Abfrage ungültig wird.
        Ebenen:<n>-Typen:<n> Oder a <Reference type> Schreibweise in der Verbindungsleitung

        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 Leiste Beziehungseinstellungen (wählen Sie bei Bedarf die Verbindungsleitung aus):
        1. Wählen Sie im Abschnitt „Beziehungsrichtung“ 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 Ob 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 Verbindungsbeziehungen, z. B. Alle Tomcat-WAR-CIs, die nicht mit einem Windows-Server verbunden sind .
          Fügen Sie Beziehungstypen Hinzu Zum Auswählen eines bestimmten oder eines beliebigen Beziehungstyps.
          Fügen Sie ein zugehöriges Element hinzu Zum Abfragen zugehöriger 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 Anwendungsservice-Knoten, der mit festgelegt wurde Konvertieren Sie angehängte Knoten in Muster Option und ein nicht-CMDB-Tabellenknoten: Auswählen 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, zu dem ein Filter hinzugefügt werden soll, und wählen Sie dann aus Filter anwenden Symbol, das über dem Knoten angezeigt wird.
        2. Fügen Sie im Abschnitt Filter Attribut und hinzu Zugehörige Listenbedingungen .
        3. Schließen Sie Filter Abschnitt.
        Beispiel: Fügen Sie einen Filter für den Datenbankstandort hinzu, um nach Datenbanken in Seattle abzufragen.

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

      • Und/oder-Operatoren zur Abfrage hinzufügen:
        1. Verbinden Sie einen Knoten mit zwei anderen Knoten.
        2. Wählen Sie aus Und Feld, das in der Verbindungslinie 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 Bereich.
        2. Wählen Sie einen Knoten einmal oder zweimal aus, damit der Abschnitt „Berichtsspalten“ in der rechten Leiste 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 Kombinationsabfrage, indem Sie eine integrieren Service-Mapping CMDB-Abfrage abfragen:
        1. Wählen Sie beim Erstellen einer CMDB-Abfrage aus Gespeicherte Serviceabfragen In der linken Leiste.
        2. Wählen Sie aus, und ziehen Sie dann ein Service-Mapping Abfrage des Canvas.
        Diese Abfrage gibt alle CIs zurück, die die CMDB-Abfrage erfüllen und in den von der eingebetteten zurückgegebenen Services enthalten sind Service-Mapping Abfrage.
      • Fügen Sie ein Such-Tag hinzu, das dann als Suchkriterien für gespeicherte Abfragen verwendet werden kann:
        1. Wählen Sie aus Fügen Sie Tags Hinzu Symbol oben im Canvas.
        2. Wählen Sie Aus Tag Hinzufügen Und in Abfrage-Tags Dialogfeld Geben Sie eine oder mehrere Tag-Zeichenfolgen ein.
        3. Wählen Sie aus Fügen Sie Tags Hinzu Symbol zum Schließen von erneut Abfrage-Tags Dialogfeld.
    4. Wählen Sie Speichern.

      Auf 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.
        Hinweis:
        Diese Option ist nur im Ausführungsmodus der V1-Engine verfügbar. Weitere Informationen zu den Ausführungsmodi der CMDB-Abfrage-Engine finden Sie unter Legen Sie den Ausführungsmodus für die Ausführung einer Abfrage fest.
      • Wählen Sie Aus Alle Ergebnisse Laden Zum Anzeigen der restlichen Abfrageergebnisse bis zur 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 aus Öffnen Sie im CMDB-Arbeitsbereich Dient zum Anzeigen der CI-Integrität auf 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.
      • Wann 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 sie 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 das Symbol „Einstellungen“ aus, um zu öffnen 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 Zum Portieren einer Abfragedefinition zwischen Instanzen.
    • Füllen Sie eine CMDB-Gruppe aus Mit einer gespeicherten Abfrage.
    • Löschen Sie eine CMDB-Abfrage.