SQL-Abfragen speichern, freigeben und exportieren

Sie können eine SQL-Abfrage jederzeit speichern und zu einem späteren Zeitpunkt weiter daran arbeiten. Sie können auch eine abgeschlossene Abfrage speichern und die Abfrage als Suchwidget für die zukünftige Verwendung durch Sie oder andere Benutzer freigeben.

Wenn Sie das Widget basierend auf einem festen Zeitraum erstellt haben, werden bei jedem Öffnen des Widgets die Ergebnisse für den in der Suche angegebenen Zeitraum angezeigt. Wenn Sie das Widget für einen relativen Zeitraum erstellt haben (z.B. die letzten 7 Tage), werden in jedem Öffnen des Widgets die aktuellen Ergebnisse gemäß der Zeitauswahl (Letzte 7 Tage) angezeigt. Wenn das Widget in einem Dashboard referenziert wird, spiegelt es die Einstellung für den Seitenzeitselektor wider.

Voraussetzungen:

Im SQL Explorer-Menü Aktionen können Sie Ihre SQL-Suchen speichern und für andere freigeben.

Abgeschlossene Suche speichern und zu einem Dashboard hinzufügen

So speichern Sie eine SQL-Abfrage und fügen sie einem Dashboard hinzu:

  1. Wählen Sie im Menü Aktionen die OptionSpeichern aus. Das Dialogfeld Suche speichern wird angezeigt.
  2. Wählen Sie ein Compartment aus, in dem die Suche gespeichert werden soll.
    Hinweis

    Es ist keine Verknüpfung zwischen dem ausgewählten Compartment der gespeicherten Suche und den zugrunde liegenden Daten vorhanden, die abgefragt werden.
  3. Geben Sie einen Namen und eine Beschreibung für das Widget ein.

    Optional können Sie das Suchwidget speichern und zu einem Dashboard hinzufügen.

  4. Klicken Sie auf die Option Zum Dashboard hinzufügen.
  5. Wählen Sie aus, ob Sie das Widget einem vorhandenen Dashboard hinzufügen möchten (wählen Sie das Dashboard-Compartment und ein bestimmtes Dashboard aus), oder erstellen Sie ein neues Dashboard, und geben Sie die erforderlichen Informationen an.
    Hinweis

    Ops Insights stellt die folgenden Out-of-the-box-Dashboards für Exadata bereit:
    • Exadata Cell-Dashboard - Stündlich

      Stündliches Granularitäts-Dashboard für Cell Disk-Metriken.

    • Exadata-IORM-Dashboard - Stündlich

      Dashboard mit stündlicher Granularität für Exadata-IORM-Metriken.

  6. Klicken Sie auf Speichern.

Zuvor gespeicherte oder vordefinierte Suche öffnen

  1. Wählen Sie im Menü Aktionen die Option Öffnen aus. Das Dialogfeld Suche öffnen wird angezeigt.
  2. Wählen Sie eine zuvor gespeicherte Suche oder eines der vordefinierten Such-Widgets aus, das im SQL Explorer enthalten ist.
  3. Klicken Sie auf Open.

Gespeicherte Suche entfernen

  1. Wählen Sie im Menü Aktionen die Option Löschen aus. Das Dialogfeld Suche löschen wird angezeigt.
  2. Wählen Sie eine zuvor gespeicherte Suche aus.
  3. Klicken Sie auf Löschen.

Wichtig: Wenn Sie ein gespeichertes Suchwidget löschen, das derzeit von einem vorhandenen Dashboard referenziert wird, beachten Sie, dass es nicht automatisch aus dem Dashboard gelöscht wird. Dies führt zu einem Fehler beim Zugriff auf das Dashboard.

Hinweis

Sie können eine vordefinierte Out-of-the-box-Suche nicht löschen.

Gespeicherte Suche aus vorhandener Suchabfrage erstellen

Mit der Option Speichern unter können Sie eine benutzerdefinierte Suche aus einer vorhandenen Suche erstellen.

  1. Wählen Sie im Menü Aktionen die Option Öffnen aus. Das Dialogfeld Suche öffnen wird angezeigt.
  2. Wählen Sie eine zuvor gespeicherte oder vordefinierte Suche aus der Liste aus.
  3. Klicken Sie auf Open. Die Suchkriterien werden im SQL Explorer angezeigt.
  4. Aktualisieren Sie die Suchkriterien nach Bedarf.
  5. Wählen Sie im Menü "Aktionen" Speichern unter aus.
  6. Geben Sie einen neuen Namen für die aktualisierte Suche ein.
  7. Klicken Sie auf Speichern.

Name und Beschreibung einer vorhandenen Suche aktualisieren

Während der Entwicklung einer SQL-Abfrage können Sie den Namen und die zugehörigen beschreibenden Informationen des Suchwidgets ändern. Mit der Option Bearbeiten können Sie diese Änderungen vornehmen.

  1. Wählen Sie im Menü Aktionen die Option Öffnen aus, wenn Sie ein vorhandenes Suchwidget aktualisieren. Das Dialogfeld Suche öffnen wird angezeigt.
  2. Wählen Sie ein Compartment aus, in dem sich das Suchwidget befindet.
    Hinweis

    Es ist keine Verknüpfung zwischen dem ausgewählten Compartment der gespeicherten Suche und den zugrunde liegenden Daten vorhanden, die abgefragt werden.
  3. Wählen Sie ein Suchwidget aus, und klicken Sie auf Öffnen, um die Suche im SQL Explorer anzuzeigen.
  4. Wählen Sie im Menü Aktionen die OptionBearbeiten. Das Dialogfeld Suche bearbeiten wird angezeigt.
  5. Geben Sie einen neuen Suchnamen und/oder eine neue Suchbeschreibung ein.
  6. Klicken Sie auf Bearbeiten, um die Änderungen zu speichern.

Neue Suche erstellen

Um vorhandene Suchkriterien zu löschen und eine neue Suche zu starten, wählen Sie im Menü Aktionen die Option Neu erstellen aus.

Daten exportieren

Um die aus einer Suche abgerufenen Daten zu exportieren, klicken Sie im Menü Gespeicherte Suche auf In CSV exportieren. Der Datenexport beschränkt sich darauf, dass nur maximal 10.000 Zeilen für eine einzelne Abfrage abgerufen werden können (mit Limit=1000 und Seiten=10). Alternativ können Sie Daten über die CLI (Befehlszeilenschnittstelle) exportieren. Der Export über die CLI ist sehr leistungsstark und einfach zu bedienen. Informationen zum Abrufen von Daten mit der CLI finden Sie im folgenden Beispiel:
  • Beispiel mit einer JSON-Datei:
    oci opsi
    opsi-data-objects query-data-templatized-query 
    --from-json file://./<file name>
    --compartment-id <compartment id>
    --limit 1000
    Dabei enthält die JSON-Datei Folgendes:
    {
       "dataObjectIdentifier":"opsidataobject.dbinsights.f0819908-5ae3-4cb5-8a81-80a4ba888881",
       "query":{
          "queryType":"TEMPLATIZED_QUERY",
          "selectList":[
             "DB_DISPLAY_NAME, CDB_NAME, EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"
          ],
          "whereConditionsList":[
              
          ],
          "groupByList":[
              
          ],
          "havingConditionsList":[
              
          ],
          "orderByList":[
             "ROLLUP_TIME_UTC ASC"
          ],
          "timeFilters":{
             "timeStart":"2024-01-05T00:00:00.000Z",
             "timeEnd":"2024-01-12T00:00:00.000Z"
          }
       },
       "resourceFilters":{
          "compartmentIdInSubtree":false
       }
    }
  • Beispiel für den Aufruf der Abfrage direkt im CLI-Befehl:
    oci opsi
    opsi-data-objects query-data-templatized-query 
    --compartment-id <compartment id>
    --data-object-identifier <data object id>
    --query-select-list '["DB_DISPLAY_NAME, CDB_NAME,EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"]'
    --query-order-by-list '["ROLLUP_TIME_UTC ASC"]'
    --limit 1000