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 die Eigenschaftsspalten auswählen, die in den Abfrageergebnissen angezeigt werden.
Während Sie schrittweise durch die Erstellung einer Abfrage geführt werden, werden Listenoptionen und andere Benutzeroberflächenelemente des CMDB-Abfragegenerators je nach Erfordernis Ihrer Auswahl dynamisch 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 'copy'.
-
Auf der 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 der Beziehungstyp fehlen, wodurch die Abfrage ungültig wird. |
| Ebenen:<n> Typen: oder a<Reference type> Notation in der Verbindungszeile |
Nach Bedarf: die Anzahl der Beziehungsebenen und die Anzahl der Beziehungstypen, die für die Verbindung enthalten sind. Oder ein Referenztyp für eine Beziehung, die einen Verweis darstellt. |
| 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 |
Um eine Abfrage nach CIs ohne Beziehungsverbindung auszuwählen, z. B. Alle Tomcat WAR-CIs, die nicht mit einem Windows-Server verbunden sind. |
| Beziehungstypen hinzufügen |
Um spezifische oder beliebige Beziehungstypen auszuwählen. |
| Ein zugehöriges Element hinzufügen |
Um Abfragen nach zugehörigen CIs zwischen den Knoten durchzuführen. |
- 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<table> anwenden, um die Abfrage auf das Anwendungsservice-CI selbst und die CIs anzuwenden innerhalb des Anwendungsservice.
- Filter einem Klassenknoten hinzufügen: Wenden Sie Filter an, um eine Klassenabfrage auf eine bestimmte Gruppe von CIs oder eine einzige spezifische 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.
Fügen Sie beispielsweise 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 And/Or-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.
Beispielsweise ist C1 Tomcat WAR, C2 Linux-Server und C3 Windows-Server. Führen Sie eine Abfrage nach
allen Tomcat WAR-CIs durch, 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, und ziehen Sie sie dann auf die Canvas.
Diese Abfrage gibt alle CIs zurück, die die CMDB-Abfrage erfüllen und in den von der
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.
Nur die ersten 100 Ergebnisse der Abfrage werden im Ergebnisbereich 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 und teilen Sie die URL der gespeicherten Abfrage für Benutzer, die auf den CMDB-Abfragegenerator zugreifen können. Wenn Sie die freigegebene URL in ein neues Internetbrowser-Fenster eingeben, 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 der gespeicherten Abfrage aus.
- Löscht eine CMDB-Abfrage.