SQL-Abfragen mit dem DB Query Client ausführen

Gehen Sie wie folgt vor, um SQL-Abfragen mit dem DB Query Client auszuführen:

1. Starten Sie den DB Query Client mit der folgenden URL:

   https://<hostname:port>/smcfs/yfshttpdbi/sterlingdbqueryclient.jsp

2. Geben Sie die Benutzer-ID und das Kennwortein. Die Benutzerauthentifizierung ist gültig, bis die aktuelle Sitzung abläuft oder bis die aktuelle Sitzung geschlossen wird. Wenn die aktuelle Browsersitzung abläuft, können Sie Ihre Anmeldeberechtigungsnachweise eingeben und Abfragen auf derselben Seite ausführen.
3. Geben Sie im Feld SQL-Abfrage eingebeneine SQL-Abfrage ein und klicken Sie auf Abfrage ausführen.

   Geben Sie im Feld Anzahl Zeilen an, wie viele Zeilen pro Seite angezeigt werden. Der Standardwert ist 100. Wenn Sie einen höheren Wert eingeben, wird die Paginierung automatisch aktiviert. Sie können einen Maximalwert von 10000 Zeilen angeben, die pro Seite angezeigt werden.

   • Sortieren Sie das Abfrageergebnis nach Spalte, wenn DISTINCT mit der Klausel SELECT verwendet wird.
   • DISTINCT ermöglicht Ihnen die Ausführung der folgenden Abfrage:
     select distinct <organization_code> from yfs_item where 1=1;
     Hinweis: Für die Abfrage DISTINCT ohne ausgewählte Primärschlüsselspalte wird die Paginierung nicht unterstützt. Der Standardwert ist 100. Wenn Sie jedoch mehr Datensätze anzeigen möchten, erhöhen Sie die Seitengröße. Es können maximal 10000 Datensätze angezeigt werden.
   • Abfragen, die Aggregationsfunktionen wie UNION-, INTERSECT-oder WITH -Klauseln enthalten, werden von der Paginierung nicht unterstützt. Solche Abfragen werden im nicht paginierten Modus ausgeführt. Wenn Sie jedoch mehr Datensätze anzeigen möchten, erhöhen Sie die Seitengröße auf einen Maximalwert von 10000 Datensätzen.

   Hinweis:

   • Sie können keine Tabellen abfragen, die sensible oder irrelevante Daten oder keine Geschäftsdaten enthalten.
   • Sie können keine Abfragen ausführen, die die Tabellen ändern.
   Es folgen einige Beispielabfragen:

   
   select * from yfs_resource fetch first 10 rows only;
   select * from yfs_resource_permission fetch first 10 rows only;
   select * from yfs_user fetch first 10 rows only;

   • Abfragetabellen zum Sortieren des Ergebnisses nach nicht primärer Spalte. Beispiel:

     select * from yfs_user order by loginid fetch first 10 rows only;

   • Erstellen Sie Joins mithilfe von Unterabfragen. Beispiel:

     
     select u.user_key, ug.USERGROUP_KEY, u.loginid, ug. USERGROUP_NAME from (SELECT * FROM
     omdb.YFS_USER)  as u RIGHT OUTER JOIN (SELECT * FROM omdb.YFS_USER_GROUP) as ug ON
     u.USERGROUP_KEY = ug.USERGROUP_KEY fetch first 10 rows only;

   • Abfrage von Spaltenaliasnamen verwenden. Beispiel: select order_no as Docket from yfs_order_header;

   • Abrufen von Indexinformationen aus Tabellen mithilfe von describe -Anweisungen. Beispiel: describe table YFS_USER;. Diese Abfrage gibt nur die grundlegenden Tabellenschemadetails wie den Datentyp, null oder ungleich null und nicht die Indexinformationen zurück. Sie können jedoch describe indexes for table YFS_USER ausführen, um die Indexdetails der Tabelle abzurufen.

   • Abfragetabellen aus dem Schema SYSCAT. Sie können die folgenden Tabellen aus dem Schema SYSCAT abfragen:
     • SCHEMATA
     • TABLES-Bei der Abfrage dieser Tabelle wird empfohlen, eine Klausel WHERE mit tabschema = 'OMDB' hinzuzufügen.
     • VIEWS-Beim Abfragen dieser Tabelle wird empfohlen, eine Klausel WHERE mit viewschema = 'OMDB' hinzuzufügen.
     • COLUMNS-Beim Abfragen dieser Tabelle wird empfohlen, eine Klausel WHERE mit tabschema = 'OMDB' hinzuzufügen.
     • INDEXES-Beim Abfragen dieser Tabelle wird empfohlen, eine Klausel WHERE mit tabschema = 'OMDB' hinzuzufügen.
     • TABCONST-Beim Abfragen dieser Tabelle wird empfohlen, eine Klausel WHERE mit tabschema = 'OMDB' hinzuzufügen.

     Standardmäßig werden im nicht paginierten Modus nur die ersten 100 Datensätze angezeigt. Sollen mehr Datensätze angezeigt werden, geben Sie im DB Query Client die Gesamtzahl der anzuzeigenden Datensätze an.

   Alternative Methoden zum Ausführen von Abfragen

   • Klicken Sie auf Letzte ausgeführte Abfragen , um alle Abfragen anzuzeigen, die Sie zuvor ausgeführt haben. Die letzten 100 zuvor ausgeführten Abfragen werden gespeichert und 10 Abfragen pro Seite angezeigt. Sie können eine Abfrage aus der Liste ausführen.
   • Geben Sie im Feld Nach Abfragen suchen die entsprechenden Begriffe wie Abfrageschlüsselwörter oder Tabellennamen ein, um Ihre Abfrage zu suchen, und klicken Sie auf Abfrage ausführen. Suchbegriffe können beispielsweise YFS_USER, SELECTlauten. Alternativ können Sie in der Liste blättern und auf Weiter oder Zurück klicken, um Ihre Abfrage zu suchen.
   • Abfrage importieren und ausführen.
   Hinweis:

   • Wenn Sie eine Abfrage nicht mit einem Semikolon beenden, wird sie intern angehängt.
   • Standardmäßig ist die Paginierung aktiviert. Wenn bei bestimmten Abfragen ein Problem auftritt, wird die Paginierung automatisch inaktiviert und das Abfrageergebnis basierend auf der Anzahl der eingegebenen Zeilen angezeigt.
   • Wenn es momentane Probleme mit der Datenbankkonnektivität gibt, versucht das Tool dreimal, eine Verbindung zur Datenbank herzustellen. Ist dies nicht erfolgreich, wird eine entsprechende Nachricht angezeigt.
   • Das Abfragezeitlimit beträgt 2 Minuten.
   Ergebnisse:

   • Um eine optimale Leistung in der Produktionsumgebung sicherzustellen, werden nur die ersten 100 Zeilen für Abfragen mit CLOB-Spalten angezeigt.
   • Bei SQL-Abfragen mit CLOB-Spalten werden maximal 100 Datensätze angezeigt und können exportiert werden.
   • BLOB-Spalten werden in der Ausgabe als --BLOB Data-- angezeigt, anstatt einen Zeichenfolgewert des binären Objekts auf der Ergebnisseite anzuzeigen.
   • Das Tool gibt die genauen SQL-Fehlercodes zurück, sodass die Benutzer verstehen können, was mit einer Abfrage falsch ist. Wenn Sie beispielsweise select * from YFS_USER_DETAILSausführen, gibt das Tool die folgende Fehlernachricht zurück:

     Ausnahmebedingung beim Ausführen der Abfrage. Überprüfen Sie die Abfragesyntax bzw. die Serverprotokolle.
     "OMDB.YFS_USER_DETAILS" ist ein nicht definierter Name. SQLCODE=-204, SQLSTATE=42704, DRIVER=3.69.49

4. Optional: Das Kontrollkästchen Zahlen als Text exportieren (nur zur Anzeige in Microsoft Excel) ist standardmäßig ausgewählt. Um das Abfrageergebnis in eine CSV-Datei zu exportieren, wählen Sie das Markierungsfeld ab und klicken Sie anschließend auf Exportieren. Die Abfrageergebnisse werden in .csvexportiert. Beispiel: queryResult--2020-8-5-13-19-19.csv.

   In der CSV-Datei werden lange Zahlen im Exponentialformat angezeigt. Beispiel: 12345678901234567890 wird als 1.23457E+19dargestellt.

   Um Ihre Abfrageergebnisse in eine schreibgeschützte CSV-Datei zu exportieren, wählen Sie das Kontrollkästchen Zahlen als Text exportieren (nur zur Anzeige in Microsoft Excel) aus. Beispiel: queryResult--2020-8-5-13-19-19_view-only-on-ms-excel.csv.

   Die CSV-Datei kann nur in Microsoft Excel-Datei geöffnet werden. In der exportierten CSV-Datei wird ein Hochkomma (') als Präfix für Zahlen mit mehr als 11 Ziffern verwendet, sodass die ganzen Zahlen als Text in Microsoft Excel angezeigt werden. Zahlen mit weniger als 11 Ziffern werden jedoch als ganze Zahlen angezeigt und enthalten kein Hochkomma. Bei Zahlen mit führenden Nullen schneidet Microsoft Excel die Nullen ab und zeigt nur Zahlen an. Beispielsweise wird "0001" als "1" angezeigt.