Net.Data Verwaltung und Programmierung für OS/400

Gespeicherte Prozeduren

Eine gespeicherte Prozedur ist ein kompiliertes Programm, das auf dem lokalen oder fernen DB2-Server gespeichert ist und SQL-Anweisungen ausführen kann. In Net.Data werden gespeicherte Prozeduren von Net.Data-Funktionen mit Hilfe der SQL-Anweisung CALL aufgerufen. Parameter für gespeicherte Prozeduren werden aus der Parameterliste der Net.Data-Funktion übergeben. Sie können gespeicherte Prozeduren einsetzen, um die Leistung und die Integrität zu verbessern, indem Sie kompilierte SQL-Anweisungen auf dem Datenbank-Server speichern.

In diesem Abschnitt werden folgende Themen behandelt:

Syntax für gespeicherte Prozeduren
Aufrufen einer gespeicherten Prozedur
Übergeben von Parametern
Verarbeiten von Ergebnismengen

Syntax für gespeicherte Prozeduren

Die Syntax für die gespeicherte Prozedur verwendet die Anweisung FUNCTION, die Anweisung CALL und wahlfrei einen REPORT-Block.

%function (dtw_sql) function_name ([IN datatype arg1, INOUT datatype arg2,
    OUT tablename, ...])
  CALL stored_procedure
[%REPORT(resultsetname...)]

Dabei gilt folgendes:

function_name: Ist der Name der Net.Data-Funktion, die den Aufruf der gespeicherten Prozedur initialisiert.
stored_procedure: Ist der Name der gespeicherten Prozedur.
datatype: Ist einer der von Net.Data unterstützten Datentypen der Datenbank wie in Tabelle 2 gezeigt. Die in der Parameterliste angegebenen Datentypen müssen mit den Datentypen in der gespeicherten Prozedur übereinstimmen. Weitere Informationen zu diesen Datentypen finden Sie in Ihrer Datenbankdokumentation.
tablename: Ist der Name einer Net.Data-Tabelle, in der die Ergebnismenge gespeichert werden soll (wird nur verwendet, wenn die Ergebnismenge in einer Net.Data-Tabelle gespeichert werden soll). Wenn dieser Parametername angegeben ist, muß er mit dem zugehörigen Parameternamen für resultsetname übereinstimmen.
resultsetname: Ist ein Name, der eine von der gespeicherten Prozedur zurückgegebene Ergebnismenge einem REPORT-Block zuordnet. Wenn dieser Parameter angegeben ist, muß er mit dem zugehörigen Parameternamen für tablename übereinstimmen.

Tabelle 2. Datentypen für gespeicherte Prozeduren

CHAR FLOAT TIME
DATE GRAPHIC TIMESTAMP
DECIMAL INTEGER VARCHAR
DOUBLE REAL VARGRAPHIC
DOUBLEPRECISION SMALLINT

Aufrufen einer gespeicherten Prozedur

Gehen Sie wie folgt vor, um eine gespeicherte Prozedur aufzurufen:

Definieren Sie eine Funktion, die einen Aufruf an die gespeicherte Prozedur initialisiert.
```
%function (dtw_sql) function_name()
```
Geben Sie wahlfrei IN-, INOUT- oder OUT-Parameter für die gespeicherte Prozedur an, einschließlich des Namens von Ergebnismengen, die von der gespeicherten Prozedur zurückgegeben werden.
```
%function (dtw_sql) function_name (IN datatype
arg1, INOUT datatype arg2, OUT tablename...)
```
Geben Sie mit Hilfe der Anweisung CALL den Namen der gespeicherten Prozedur an.
```
 CALL stored_procedure
```
Wenn die gespeicherte Prozedur nur eine Ergebnismenge generiert, können Sie wahlfrei einen REPORT-Block angeben, um zu definieren, wie Net.Data die Ergebnismenge anzeigen soll.
```
%report  {
...
%}
```
Beispiel:
```
%function (dtw_sql) mystoredproc (IN CHAR(30) arg1 OUT mytable)  {
     CALL  myproc
 %report {
  ...
 %row {  ...   %}
  ...
 %}
%}
```
Wenn die gespeicherte Prozedur mehrere Ergebnismengen generiert, haben Sie folgende Möglichkeiten:
- Geben Sie die Ergebnismengen als OUT-Parameter in der FUNCTION-Anweisung an. Die Ergebnismengen werden als lokale Tabellen gespeichert.
```
%function (dtw_sql) function_name (OUT tablename, ...)
```
- Geben Sie wahlfrei einen oder mehrere REPORT-Blöcke an, um zu definieren, wie Net.Data die Ergebnismengen anzeigen soll.
```
%REPORT(resultsetname1) {
...
%}
```
  Beispiel:
```
%function (dtw_sql) mystoredproc (IN CHAR(30) arg1, OUT table1, table2) {
     CALL  myproc
 %report (table1) {
      ...
 %row {  ...   %}
      ...
 %}
 %report (table1) {
      ...
 %row {  ...   %}
      ...
 %}
%}
```

Übergeben von Parametern

Sie können Parameter an eine gespeicherte Prozedur übergeben und die gespeicherte Prozedur die Parameterwerte aktualisieren lassen, so daß die neuen Werte an das Net.Data-Makro zurückgegeben werden. Ein Parameter wird an eine gespeicherte Prozedur übergeben, indem der Parametername mit dem Schlüsselwort IN angegeben wird. Wenn eine gespeicherte Prozedur den Parameter aktualisiert, müssen Sie den Parameter für den zurückzugebenden Wert mit dem Schlüsselwort INOUT bzw. OUT übergeben. Der Datentyp, der für einen Parameter angegeben wird, muß mit dem übereinstimmen, den die gespeicherte Prozedur erwartet.

Beispiel 1: Übergeben eines Parameterwerts an die gespeicherte Prozedur

%function (dtw_sql) mystoredproc (IN CHAR(30) valuein)  {
     CALL  myproc
...

Beispiel 2: Zurückgeben eines Werts aus einer gespeicherten Prozedur

%function (dtw_sql) mystoredproc (OUT VARCHAR(9) retvalue)  {
     CALL  myproc
...

Verarbeiten von Ergebnismengen

Sie können angeben, ob eine oder mehrere Ergebnismengen von einer gespeicherten Prozedur zurückgegeben werden. Die Ergebnismengen können in Net.Data-Tabellen zur weiteren Verarbeitung innerhalb Ihres Makros gespeichert oder mit Hilfe eines REPORT-Blocks angezeigt werden. Sie müssen jeder durch eine gespeicherte Prozedur generierten Ergebnismenge einen Namen zuordnen. Dies geschieht durch die Angabe von Parametern in der FUNCTION-Anweisung. Der Name, den Sie für eine Ergebnismenge angeben, kann anschließend einem REPORT-Block oder einer Net.Data-Tabelle zugeordnet werden, so daß Sie festlegen können, wie die einzelnen Ergebnismengen von Net.Data verarbeitet werden. Sie haben folgende Möglichkeiten:

Sie können das Ergebnis im Standardformat für Net.Data-Berichte anzeigen, indem Sie keinen REPORT-Block für die Ergebnismenge definieren.
Sie können eine Ergebnismenge einem REPORT-Block zuweisen, damit Net.Data die Ergebnismenge in einem Bericht anzeigt. In diesem Fall können Sie mit Net.Data-Variablen, -Textverarbeitungsanweisungen wie HTML oder JavaScript oder anderen Funktionen angeben, wie die Berichtsdaten vom Browser angezeigt werden sollen.

Ergebnismengen werden immer in lokalen Tabellen gespeichert, so daß eine andere Funktion die Daten später in der Makrodatei verwenden kann. Zum Beispiel können Sie die Net.Data-Tabelle an eine andere Funktion übergeben, die die Daten zu Berechnungen und zum Anzeigen der berechneten Ergebnisse verwenden kann.

Richtlinien und Einschränkungen hinsichtlich der Verwendung mehrerer REPORT-Blöcke finden Sie im Abschnitt Richtlinien und Einschränkungen für mehrere REPORT-Blöcke.

Wenn nur eine Ergebnismenge zurückgegeben und diese in einem Standardbericht angezeigt werden soll:

Verwenden Sie die folgende Syntax:

%function (dtw_sql) function_name (OUT tablename) {
    CALL stored_procedure
%}

Beispiel:

 %function (dtw_sql) mystoredproc(OUT mytable1) {
     CALL  myproc
%}

Wenn nur eine Ergebnismenge zurückgegeben und ein REPORT-Block für die Verarbeitung der Anzeige angegeben werden soll:

Verwenden Sie die folgende Syntax:

%function (dtw_sql) function_name (OUT tablename) {
     CALL stored_procedure
 %REPORT (resultsetname) {
  ...
 %}
%}

Beispiel:

%function (dtw_sql) mystoredproc (OUT mytable1) {
     CALL  myproc
 %REPORT (mytable1) {
      ...
      %row {  ...   %}
      ...
 %}
%}

Alternativ kann die folgende Syntax verwendet werden:

%function (dtw_sql) function_name () {
    CALL stored_procedure

 %REPORT () {
  ...
 %}
%}

Beispiel:

%function (dtw_sql) mystoredproc () {
    CALL myproc
 %REPORT  {
  ...
 %row {  ...   %}
  ...
 %}
%}

Wenn mehrere Ergebnismengen zurückgegeben und diese im Standardberichtsformat angezeigt werden sollen:

Verwenden Sie die folgende Syntax:

%function (dtw_sql) function_name (OUT tablename1, tablename2) {
    CALL stored_procedure
%}

Dabei wird kein REPORT-Block angegeben.

Beispiel:

%define DTW_DEFAULT_REPORT = "MULTIPLE"
%function (dtw_sql) mystoredproc (OUT mytable1, mytable2) {
    CALL myproc
%}

Wenn mehrere Ergebnismengen zurückgegeben und REPORT-Blöcke für die Verarbeitung der Anzeige angegeben werden sollen:

Jeder Ergebnismenge wird ein eigener REPORT-Block zugeordnet. Verwenden Sie die folgende Syntax:

%function (dtw_sql) function_name (OUT tablename1, tablename2) {
   CALL stored_procedure
 %REPORT (resultsetname1)
   ...
   %row {  ...   %}
   ...
 %}
 %REPORT (resultsetname2)
   ...
   %row {  ...   %}
   ...
 %}
%}

Beispiel:

%function (dtw_sql) mystoredproc (OUT mytable1, mytable2) {
   CALL myproc

 %REPORT (mytable1) {
  ...
 %row {  ...   %}
  ...
 %}

 %REPORT(mytable2) {
  ...
 %row {  ...   %}
  ...
 %}
%}

[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]

CHAR	FLOAT	TIME
DATE	GRAPHIC	TIMESTAMP
DECIMAL	INTEGER	VARCHAR
DOUBLE	REAL	VARGRAPHIC
DOUBLEPRECISION	SMALLINT