Übergeben Sie die folgenden Paare von Schlüsseln und Werten über diese URL an die API: https://localhost/tuning/compareworkload
| Kategorie | Key (Schlüssel) | Wert | Mögliche Werte | Optional? |
|---|---|---|---|---|
| Verbindung 1 | dbType | Der Typ des Datenservers. | ZOS | Nein |
| dbHost | Der Host des Datenservers. | Domänenname oder IP-Adresse | Nein | |
| dbPort | Die Portnummer des Datenservers | Nein | ||
| dbName | Der Name des Datenservers | Nein | ||
| dbUser | Die bei der Herstellung einer Verbindung zum Datenserver zu verwendende ID. | Nein | ||
| dbPassword | Das bei der Herstellung einer Verbindung zum Datenserver zu verwendende Kennwort. | Nein | ||
| Verbindung 2 | dbHost2 | Der Host des Datenservers. | Nur für Vergleiche des Typs 3. | |
| dbPort2 | Die Portnummer des Datenservers | Nur für Vergleiche des Typs 3. | ||
| dbName2 | Der Name des Datenservers | Nur für Vergleiche des Typs 3. | ||
| dbUser2 | Die bei der Herstellung einer Verbindung zum Datenserver zu verwendende ID. | Nur für Vergleiche des Typs 3. | ||
| dbPassword2 | Das bei der Herstellung einer Verbindung zum Datenserver zu verwendende Kennwort. | Nur für Vergleiche des Typs 3. | ||
| Abfrageworkloads | workload | Der Name der Abfrageworkload mit der früheren EXPLAIN-Momentaufnahme, die im Vergleich verwendet werden soll. | Nein | |
| workload2 | Der Name der Abfrageworkload mit der späteren EXPLAIN-Momentaufnahme, die im Vergleich verwendet werden soll. Der Name kann mit dem ersten Namen identisch sein, wenn Sie zwei EXPLAIN-Momentaufnahmen einer einzelnen Abfrageworkload vergleichen wollen. | Nur für Vergleiche des Typs 1 und 2. | ||
| Optionen zum Filtern von SQL-Anweisungen | apChanged | Gibt an, dass die SQL-Anweisungen angezeigt werden sollen, für die die Zugriffspläne sich geändert haben. | true oder false. Die Groß-/Kleinschreibung muss nicht beachtet werden. | Ja |
| costRegressed | Gibt an, dass die SQL-Anweisungen angezeigt werden sollen, für die der geschätzte Aufwand sich um einen Betrag erhöht hat, der mindestens gleich dem von Ihnen angegebenen Prozentsatz ist. | Eine Ganzzahl von 0 bis 100. | ||
| operator | Gibt an, ob die SQL-Anweisungen angezeigt werden sollen, die mit dem Wert übereinstimmen, der für die Schlüssel apChanged und costRegressed festgelegt wurde, oder ob SQL-Anweisungen angezeigt werden sollen, die mit dem Wert übereinstimmen, der für einen der beiden Schlüssel festgelegt wurde. | and oder or. Die Groß-/Kleinschreibung muss nicht beachtet werden. | und |
Die API übergibt die folgenden Paare von Schlüsseln und Werten:
| Schlüssel | Wert |
|---|---|
| code | Der Rückkehrcode vom Web-API.
|
| state |
|
| link | Die URL für den Bericht, der die Zugriffspläne in den beiden EXPLAIN-Momentaufnahmen vergleicht. Der Link läuft standardmäßig nach 7 Tagen ab. Sie können diesen Zeotraum in der Datei tuning_service.properties ändern. |
| output | Die Anzahl von SQL-Anweisungen, die die Filterkriterien erfüllen und für die Informationen im Bericht vorhanden sind. |
| message | Fehler- oder Warnnachrichten. |
| exception | Informationen zu einer eventuell aufgetretenen Ausnahmebedingung. Diese Informationen können dem IBM Support während der Arbeit für Sie bei der Fehlerbehebung helfen. |
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
dbType:ZOS,
dbHost:Host,
dbPort:Portnummer,
dbName:Subsystem,
dbUser:Benutzer-ID,
dbPassword:Kennwort,
workload:Sample_Workload_1,
apChanged:\"true\"
costRegressed:30,
operator:\"and\"
}"
https://localhost/tuning/compareworkload
{
"code" :4 ,
"state" :2,
"output" :"11" ,
"link" :"http://localhost:8080/tuning/download/wapc/1394687451884-
14798931739894/ComparisonReport_1.html"}
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
dbType:ZOS,
dbHost:Host,
dbPort:Portnummer,
dbName:Subsystem,
dbUser:Benutzer-ID,
dbPassword:Kennwort,
workload:Sample_Workload,
workload2:Sample_Workload2,
costRegressed:20,
apChanged:\"true\"
}"
https://localhost/tuning/compareworkload
Die Ausgabe der API gleicht der Ausgabe in Beispiel 1.
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
dbType:ZOS,
dbHost:Host_für_die_erste_Verbindung,
dbPort:Portnummer,
dbName:Subsystem,
dbUser:Benutzer-ID,
dbPassword:Kennwort,
dbHost2:Host_für_die_zweite_Verbindung,
dbPort2:Portnummer,
dbName2:Subsystem,
dbUser2:Benutzer-ID,
dbPassword2:Kennwort,
workload:Sample_Workload,
workload2:Sample_Workload2,
costRegressed:50,
apChanged:\"true\",
operator:\"or\"
}"
https://localhost/tuning/compareworkload
Die Ausgabe der API gleicht der Ausgabe in Beispiel 1.