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 gespeicherte Abfragen nur anzuzeigen und auszuführen, und cmdb_query_builder (enthalten in itil, itil_admin und asset), um Abfragen zu erstellen und zu speichern, gespeicherte Abfragen zu ändern und Abfragen auszuführen. Für die Berichterstellung für Abfragen sind berichtsbezogene ACLs erforderlich.
Autorisierte Benutzer können eine von einem anderen Benutzer erstellte Abfrage aktualisieren und löschen.
Warum und wann dieser Vorgang ausgeführt wird
Erstellen Sie die Abfrage, indem Sie die CI-Klassen und Nicht-CMDB-Tabellen, die Sie in die Abfrage aufnehmen möchten, ziehen. Dann werden sie als Knoten auf dem Canvas abgelegt und Beziehungseigenschaften zwischen ihnen definiert. Sie können nach den Attributen jedes Knotens filtern, um die Ergebnisse auf einen bestimmten Satz von CIs dieser Klasse oder auf ein einzelnes spezifisches CI einzugrenzen. Sie können auch auswählen, welche Eigenschaftsspalten in den Abfrageergebnissen angezeigt werden.
Während Sie die Erstellung einer Abfrage schrittweise durchlaufen, werden Listenoptionen und andere Anwenderoberflächenelemente des CMDB-Abfragegenerators dynamisch entsprechend Ihrer Auswahl gefiltert.
Weitere Informationen zur Verwendung des Abfragegenerators finden Sie im Video CMDB-Abfragegenerator – Abfragen und Berichte – Platform Analytics Academy ServiceNow Community. Eine schrittweise Anleitung zum Erstellen von CMDB-Abfragen im Abfragegenerator, einschließlich Abfragen mit Anwendungsservices, finden Sie unter Beispielanfragen.
Prozedur
-
Navigieren zu und wählen Sie CMDB-Abfragegeneratoraus.
-
Führen Sie auf der Seite „CMDB-Abfragegenerator“ einen der folgenden Schritte aus:
- Wählen Sie Neu erstellen. Geben Sie einen Namenein, wählen Sie CMDB-Abfrage als Abfragetypaus, und wählen Sie dann Erstellenaus.
- Wählen Sie ein Widget einer gespeicherten Abfrage aus, um mit dem Erstellen einer vorhandenen Abfrage fortzufahren. Sucht nach einer gespeicherten Abfrage bei Bedarf zuerst.
- Zeigen Sie auf die rechte obere Ecke eines gespeicherten Abfrage-Widgets, und wählen Sie das Symbol „Abfrage duplizieren“ aus, um eine Kopie einer gespeicherten Abfrage zu bearbeiten. Der Standardname der neuen Abfrage enthält die Zeichenfolge „Kopie“.
-
Im Canvas können Sie einen der folgenden Vorgänge ausführen:
- Fügen Sie der Abfrage CI-Klassen hinzu: Wählen Sie auf der Registerkarte CMDB-Klassen Klassen aus der Hierarchieliste aus, und ziehen Sie sie auf die Canvas.
Fügen Sie der Abfrage ein Anwendungsservice-CI hinzu: Wählen Sie auf der Registerkarte CMDB-Klassen die Anwendungsservice- Klasse aus der Hierarchieliste aus, und ziehen Sie sie auf die Canvas.
Unter Eigenschaften des Anwendungsservice können Sie in der rechten Leiste Angehängte Knoten in Muster konvertieren auswählen, um Muster zwischen dem Anwendungsservice und anderen CMDB-Klassenknoten abzufragen. Bei der Abfrage eines Musters können die Knoten an beiden Enden der Musterverbindung beliebig viele Ebenen voneinander entfernt sein. Wenn Angehängte Knoten in Muster konvertieren nicht ausgewählt ist, stellt die Verbindung zwischen dem Anwendungsservice-Knoten und anderen CMDB-Klassenknoten direkte Beziehungen dar.
- Fügen Sie der Abfrage Nicht-CMDB-Tabellen hinzu: Wählen Sie eine Tabelle aus der Liste der Nicht-CMDB-Tabellen aus, 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:
- Wählen Sie auf dem ersten Knoten in der Verbindung das kleine Quadrat in der Mitte auf der rechten Seite aus.
- Wählen Sie im zweiten Knoten der Verbindung das kleine Quadrat in der Mitte der linken Seite aus, um die Verbindung zu erstellen.
Tabelle : 1. UI-Notationen für Verbindungen
| Darstellung |
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: oder a<Reference type> Notation 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 unter Verbindungseigenschaften auf der rechten Leiste die Beziehungseinstellungen (wählen Sie bei Bedarf die Verbindungsleitung aus):
- Wählen Sie im Abschnitt „Beziehungsrichtung“ den übergeordneten Knoten aus (der untergeordnete Knoten wird automatisch angepasst).
- Wenn die CIs direkt verbunden sind, legen Sie im Abschnitt „Beziehungsebenen“ für Ebene die Option für Beziehungen der ersten Ebene fest. Oder: Bis zu Beziehungen der 2. Ebene, wenn die CIs direkt oder indirekt über ein anderes CI verbunden sind.
Wählen Sie im Abschnitt „Beziehungstypen und zugehörige Elemente“ eine der folgenden Optionen aus:
| Option |
Beschreibung |
| Keine Beziehungen |
Dient zum Abfragen von CIs ohne Verbindungsbeziehungen, z. B. alle Tomcat-WAR-CIs, die nicht mit einem Windows-Server verbunden sind. |
| Beziehungstypen hinzufügen |
Auswahl eines bestimmten oder eines beliebigen Beziehungstyps. |
| Ein zugehöriges Element hinzufügen |
Dient 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 mit den Verbindungseigenschaften im Abschnitt „CI-Referenzspalte“ in der Liste „CI-Referenzspalte verwenden“ die Spalte mit einem Verweis auf ein CI aus. Wenn nur eine Option verfügbar ist, wird sie automatisch ausgewählt.
- Konfigurieren Sie das Muster zwischen einem Anwendungsservice-Knoten, für den die Option Angehängte Knoten in Muster konvertieren festgelegt ist, und einem Nicht-CMDB-Tabellenknoten: Wählen Sie Referenzfilter auf alle Knoten im Muster anwenden<table>, um die Abfrage auf das Anwendungsservice-CI selbst und die CIs anzuwenden innerhalb des Anwendungsservice.
- Klassenknoten Filter hinzufügen: Wenden Sie Filter an, um eine Klassenabfrage auf einen bestimmten Satz von CIs oder auf ein einzelnes spezifisches CI einzugrenzen.
- Zeigen Sie auf den Knoten, dem ein Filter hinzugefügt werden soll, und wählen Sie dann das Symbol Filter anwenden, das über dem Knoten eingeblendet wird.
- Fügen Sie im Abschnitt „Filter“ das Attribut und zugehörige Listenbedingungenhinzu.
- Schließen Sie den Abschnitt Filter.
Beispiel: Fügen Sie einen Filter für den Datenbankspeicherort hinzu, um Datenbanken in Seattle abzufragen.
Wählen Sie in der rechten Leiste Angewendete Filter aus, um alle Filter für jeden Knoten im Canvas anzuzeigen.
- Fügen Sie der Abfrage UND/ODER-Operatoren hinzu:
- Verbinden Sie einen Knoten mit zwei anderen Knoten.
- Wählen Sie das Kontrollkästchen Und in der Verbindungszeile aus, um zwischen den Operatoren UND/Oder zu wechseln.
Beispiel: C1 bedeutet Tomcat WAR, C2 bedeutet Linux Server und C3 bedeutet Windows Server. Abfrage
aller 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 Spalten parent, childund type. Sie können keine anderen Spalten aus der Tabelle [cmdb_rel_ci] hinzufügen.
- Wählen Sie im rechten Seitenbereich Eigenschaften.
- Wählen Sie ein oder zweimal einen Knoten aus, sodass der Abschnitt „Berichtsspalten“ in der rechten Leiste angezeigt wird, und wählen Sie dann „Spalten hinzufügen“aus.
- 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:
- Wählen Sie beim Erstellen einer CMDB-Abfrage in der linken Leiste Gespeicherte Serviceabfragen aus.
- Wählen Sie eine Service-Mapping -Abfrage aus, und ziehen Sie sie dann auf den Canvas.
Diese Abfrage gibt alle CIs zurück, die die CMDB-Abfrage erfüllen und in den von der eingebetteten
Service-Mapping -Abfrage zurückgegebenen Services enthalten sind.
- Fügen Sie ein Such-Tag hinzu, das dann als Suchkriterium für gespeicherte Abfragen verwendet werden kann:
- Wählen Sie das Symbol Tags hinzufügen oben in der Canvas aus.
- Wählen Sie „Tag hinzufügen“, und geben Sie im Dialogfeld „Abfrage-Tags“ mindestens eine Tag-Zeichenfolge ein.
- Wählen Sie erneut das Symbol Tags hinzufügen, um das Dialogfeld Abfrage-Tags zu schließen.
-
Wählen Sie Speichern.
Zeigen Sie auf der Registerkarte Gespeicherte Abfragen auf ein gespeichertes Abfrage-Widget, und wählen Sie Abfrageinformationenaus. Es werden Abfragedetails wie Abfragetyp, Datum der letzten Aktualisierung, CMDB-Gruppen, die der Abfrage zugeordnet sind, und Abfragezeitpläne angezeigt.
Nächste Maßnahme
Wählen Sie Ausführen.
Im Ergebnisbereich werden nur die ersten 100 Ergebnisse der Abfrage angezeigt.
- Wählen Sie Weitere Ergebnisse laden aus, um den nächsten Satz von 100 Ergebnissen anzuzeigen.
- Wählen Sie Alle Ergebnisse laden aus, um die restlichen Abfrageergebnisse anzuzeigen, bis zu der in der Systemeigenschaft „glide.cmdb.query.max_results_limit“ angegebenen Anzahl (standardmäßig 10.000).
Wählen Sie ein CI aus, um das zugehörige CI-Formular zu öffnen, und wählen Sie im CI-Formular In CMDB-Arbeitsbereich öffnen, um die CI-Integrität auf der Kachel „CI-Integrität“ im CMDB-Arbeitsbereich anzuzeigen. Dieser Vorgang erfordert die Rolle sn_cmdb_user (CMDB-Benutzer).
Hinweis:
- Stellen Sie sicher, dass die Eigenschaft „glide.security.use_csrf_token“ auf „wahr“ festgelegt ist, damit alle Ergebnisse angezeigt werden können.
- Wenn die Ebene auf Bis zu Beziehungen 2. Ebenefestgelegt ist, wird der Beziehungstyp 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.
- Einstellungen für Abfragegenerator ändern: Wählen Sie das
Symbol (Einstellungen) zum Öffnen des Dialogfelds „Abfragegeneratoreinstellungen “
- Kopieren Sie die URL einer gespeicherten Abfrage, und geben Sie sie für Anwender frei, die Zugriff auf den CMDB-Abfragegenerator haben. Durch 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 und anschließend Exportierenaus. Selbst wenn die Schaltfläche Weitere Ergebnisse laden sichtbar ist und darauf hinweist, dass zusätzliche Abfrageergebnisse vorhanden sind, werden nur die sichtbaren Ergebnisse exportiert.
- Exportieren und importieren Sie eine CMDB-Abfrage um eine Abfragedefinition zwischen Instanzen zu portieren.
- Füllen Sie eine CMDB-Gruppe mit einer gespeicherten Abfrage aus.
- Löscht eine CMDB-Abfrage.