Oracle Cloud Infrastructure-Dokumentation

Erweiterten Abfrageersteller verwenden

In diesem Modus wird das SQL-Abfragefeld als Freitexteditor angezeigt, mit dem Sie Standard-SELECT SQL-Abfragen in Ihrem eigenen Design und Ihrer eigenen Komplexität erstellen können. Diese Option ist für SQL Explorer, Data Object Explorer, Database Explorer, Host Explorer und Exadata Explorer verfügbar.

Mit Advanced Query Creator können Sie die Bind-Parameter als Filter speichern und in den Daten-Explorer laden. Außerdem ermöglichen Bind-Parameter das Hinzufügen von Filtern im Dashboard für erweiterte Explorer-Abfragen.

Hauptbildschirm "Erweiterte Datenobjekte" mit angezeigtem Textfeld "Erweiterte Auswahl" und Freitextabfrage"

Abfrage schreiben

Mit dem Advanced Query Creator können Sie Standard-Freitextabfragen von SELECT erstellen, sodass Sie verschiedene Ansichten zu einer einzigen Abfrage zusammenführen können. Führen Sie im Hauptabfragebereich zum Aktualisieren und Eingeben neuer Abfragen folgende Schritte aus:
Hinweis

Bei der Entwicklung von Abfragen muss Folgendes berücksichtigt werden:
  • SELECT oder WITH muss das erste Schlüsselwort sein, das im Feld "Erweiterte SQL-Abfrage" verwendet wird.
  • Wenn die Klausel WITH verwendet wird, muss sie am Anfang der Abfrage verwendet werden. Eine verschachtelte Klausel WITH wird nicht unterstützt.
  • Wenn der Datenobjektname in der Abfrage mehrmals referenziert werden muss, müssen Sie einen CTE-Namen der WITH-Klausel definieren und den CTE-Namen in der Abfrage verwenden. Beispiel: WITH MYDO AS (SELECT * FROM OPSIDO$HOSTINSIGHTS$HOST_CPU_AND_MEMORY_DAILY))
  1. Wählen Sie unter "Modus" die Option Erweitert aus, um auf den Freitextabfrageeditor zuzugreifen.
  2. Löschen Sie die aktuelle Abfrage, und klicken Sie auf die Schaltfläche Löschen.
  3. Erstellen Sie eine neue SELECT-Standardabfrage.
  4. Klicken Sie auf die Schaltfläche Run, um die neue Abfrage auszuführen.
  5. Mit dem Bereich Visualisierung rechts neben den Abfrageergebnissen zwischen verschiedenen Diagrammtypen umschalten. So können Sie Ihre Daten auf unterschiedliche Weise visualisieren.

Ansichten, Spalten und Beispielabfragen verwenden

Vordefinierte Beispielabfragen sowie der View- und Spaltenname sind für die verschiedenen Typen von Datenobjekten verfügbar und können als Basis für Ihre personalisierten Abfragen verwendet werden. Um die Beispielabfragen im erweiterten Modus zu verwenden, klicken Sie oben rechts im Fenster "SQL-Editor" auf ?. Dadurch wird das Popup-Fenster "Ansicht & Spalte" und "Beispielabfragen" geöffnet.

Fenster "Ansicht", "Spalte" und "Beispielabfragen"

Klicken Sie auf die Registerkarte Ansichten und Spalten, um eine vollständige Liste der verfügbaren Parameter für Ansicht und Spalte sowie den Typ und die Beschreibung der Ansichten und Spalten anzuzeigen. Sie können auch Ansichten erweitern, sodass Sie alle mit dieser Ansicht verknüpften Spalten anzeigen können. Nachdem Sie die Ansicht oder Spalte ausgewählt haben, klicken Sie auf Kopieren, um den Namen in die Abfrage zu kopieren.

Im Feld Suchen können Sie nach bestimmten Ansichtsnamen und Spaltennamen suchen.

Wählen Sie den Ressourcentyp aus, den Sie filtern und prüfen möchten. Der Datenobjektselektor und die Ansicht/Spaltentabelle werden entsprechend nach Ressourcentyp gefiltert. Ressourcentypen sind für die folgenden Explorer verfügbar:
  • SQL Explorer: Oracle und MySQL
  • Database Explorer: Oracle und MySQL
  • Datenobjekt-Explorer: Datenbank - Oracle, Datenbank - MySQL, Exadata und Host.

Klicken Sie auf eine beliebige Beispielabfrage, um Abfragebeispiele anzuzeigen. Klicken Sie auf Kopieren, wenn Sie eine Abfrage als Basis für Ihre eigenen Abfragen verwenden möchten.

Nachdem Sie das gewünschte Element kopiert haben, klicken Sie auf Schließen, um zum Explorer-Fenster zurückzukehren und mit dem Erstellen der Abfrage fortzufahren.

Bind-Parameter im erweiterten Abfrageersteller verwenden

Sie können der erweiterten Freiformabfrage Bind-Parameter hinzufügen. Auf diese Weise können Sie die Abfragenotation : als Platzhalter verwenden und Datenwerte zu einem späteren Zeitpunkt eingeben. Mit Advanced Query Creator können Sie die Bind-Parameter als Filter speichern und in den Daten-Explorer laden.

Abbildung 12-1 Bind-Parameter mit Data Explorer hinzufügen

Bind-Parameter mit Data Explorer zu einer SQL-Anweisung hinzufügen
  1. Wählen Sie unter "Modus" die Option Erweitert aus, um auf den Freitextabfrageeditor zuzugreifen.
  2. Klicken Sie auf die Schaltfläche Bind-Parameter hinzufügen auf der rechten Seite des Bildschirms. Dadurch wird der Slideout des Add Bind-Parameters geöffnet. Sie können wählen:
    • Vorhandenen Bind-Parameter auswählen: Wählen Sie das Widget Compartment aus, und wählen Sie dann den gewünschten Filter aus. Klicken Sie auf Hinzufügen.

      Abbildung 12-2: Vorhandenen Bind-Parameter hinzufügen

      Vorhandenen Bind-Parameter hinzufügen
    • Neuen Parameter konfigurieren: Wählen Sie eine von zwei Optionen aus.

      Abbildung 12-3 Neuen Bind-Parameter hinzufügen

      Neuen Bind-Parameter und zugehörige Werte hinzufügen
      1. Werteliste basierend auf Datenobjekt: Wählen Sie das Datenobjekt aus, das gewünschte Dimensionsfeld, das mit den eindeutigen Werten für dieses Feld aufgefüllt wird. Geben Sie einen Bind-Parameternamen ein. Unter Parametereinstellungen können die folgenden Optionen konfiguriert werden:
        • Auswahlmodus: Bestimmt, ob die Dropdown-Liste für Bind-Variablen eine oder mehrere Auswahlen unterstützt.
        • Ist erforderlich: Bestimmt, ob für den Bind-Parameterwert eine Auswahl erforderlich ist.
        • Leeren Wert automatisch ersetzen: Bestimmt, ob die Auswahl leerer Bind-Parameter automatisch verarbeitet werden soll. Wenn "Automatisch ersetzen" aktiviert ist, werden leere Bind-Variablenwerte, die nach "=" (Equals To-Operator) verwendet werden, zur Laufzeit automatisch verarbeitet. Sie können Beispiele für das automatische Ersetzen im Slideout anzeigen, indem Sie den Abschnitt Beispiele einblenden.
          Hinweis

          Gilt nur, wenn der Parameter nicht erforderlich ist.
      2. Angegebenen Wert verwenden: Geben Sie den Bind-Parameternamen und den Typ (STRING, NUMBER, DATETIME) ein. Unter Parametereinstellungen können die folgenden Optionen konfiguriert werden:
        • Ist erforderlich: Bestimmt, ob für den Bind-Parameterwert eine Auswahl erforderlich ist.
        • Leeren Wert automatisch ersetzen: Bestimmt, ob die Auswahl leerer Bind-Parameter automatisch verarbeitet werden soll. Gilt nur, wenn der Parameter nicht erforderlich ist.
  3. Nachdem alle Informationen eingegeben wurden, klicken Sie auf Hinzufügen. Dadurch wird der Bind-Parameter zum Data Explorer hinzugefügt. Daraufhin werden die Optionen für Bind-Parameter angezeigt. Sie können einen Wert für den Bind-Parameter auswählen oder die Werte für das Freitexteingabefeld manuell eingeben.

    Bind-Parameter funktionieren nur, wenn sie in einer Abfrage mit der Annotation ':' vor dem Namen des Bind-Parameters verwendet werden, damit sie ordnungsgemäß in der Abfrage verwendet werden. Aktualisieren Sie die Abfrage, und klicken Sie auf Ausführen. Dadurch wird die Abfrage mit den Bind-Parametern ausgeführt

  4. Außerdem können Sie die aktuelle Suche sowie den Bind-Parameter als gespeicherten Suchfilter speichern, indem Sie im Aktionsschaltflächenabschnitt auf Speichern oder Speichern unter klicken.

    Gespeicherte Suchen, die Bind-Parameter verknüpfen, laden automatisch die verknüpften Bind-Parameter in Explorer. Ebenso werden beim Hinzufügen einer gespeicherten Suche zu einem Dashboard die Bind-Parameterfilter automatisch hinzugefügt. Bind-Parameter werden einem Dashboard nur dann automatisch hinzugefügt, wenn dies für die gespeicherte Suche erforderlich ist.

    Informationen zum Hinzufügen optionaler Bind-Parameter zu einem Dashboard-Widget finden Sie unter Optionalen Bind-Parameter in einem Dashboard hinzufügen.