CREATE PROCEDURE   Sie können permanent gespeicherte Prozeduren erstellen, die externe oder native, mit unterschiedlichen Programmiersprachen erstellte Prozeduren aufrufen. PROC kann als Synonym für PROCEDURE verwendet werden.

Parameternamen müssen den Regeln für andere Datenbankbezeichner, wie z.B. Spaltennamen, entsprechen. Es muss sich dabei um einen gültigen SQL-Datentyp handeln. Eine Liste der gültigen Datentypen finden Sie unter SQL-Datentypen.

Parameter können eines der Schlüsselwörter IN, OUT oder INOUT vorangestellt haben. Wenn Sie keinen dieser Werte angeben, sind die Parameter standardmäßig INOUT. Die Schlüsselwörter haben die folgenden Bedeutungen:

Wenn Prozeduren mit der CALL-Anweisung ausgeführt werden, müssen nicht alle Parameter angegeben werden. Wenn in der CREATE PROCEDURE-Anweisung ein Standardwert bereitgestellt wird, werden fehlenden Parametern die Standardwerte zugeordnet. Falls kein Argument in der CALL-Anweisung angegeben wurde und kein Standardwert gesetzt ist, wird ein Fehler ausgegeben.

SQLSTATE und SQLCODE sind spezielle OUT-Parameter, die den SQLSTATE- oder SQLCODE-Wert ausgeben, wenn die Prozedur beendet wird. Die Spezialwerte SQLSTATE und SQLCODE können sofort geprüft werden, nachdem ein Prozeduraufruf abgeschlossen wurde, um den Rückgabestatus der Prozedur zu testen.

Die Spezialwerte SQLSTATE und SQLCODE werden durch die nächste SQL-Anweisung geändert. Indem SQLSTATE oder SQLCODE als Prozedurargumente bereitgestellt werden, kann die Rückmeldung in einer Variablen gespeichert werden.

Wenn Sie OR REPLACE (CREATE OR REPLACE PROCEDURE) angeben, wird eine neue Prozedur erstellt oder eine bestehende Prozedur mit demselben Namen ersetzt. Diese Klausel ändert die Definition der Prozedur, lässt aber bestehende Berechtigungen unberührt. Ein Fehler wird zurückgegeben, wenn Sie eine Prozedur ersetzen, die gerade verwendet wird.

Sie können keine extern aufgerufenen TEMPORARY-Prozeduren erstellen.

RESULT-Klausel   Die RESULT-Klausel deklariert die Anzahl und den Typ der Spalten in der Ergebnismenge. Mit der Liste in Klammern nach dem Schlüsselwort RESULT werden die Namen und Typen der Ergebnisspalten festgelegt. Diese Angaben werden von Embedded SQL DESCRIBE oder von ODBC SQLDescribeCol zurückgegeben, wenn eine CALL-Anweisung beschrieben wird. Eine Liste der Datentypen finden Sie unter SQL-Datentypen.

Externe Prozeduren in Embedded SQL (LANGUAGE C_ESQL32, LANGUAGE C_ESQL64) or ODBC (LANGUAGE C_ODBC32, LANGUAGE C_ODBC64) können 0 oder 1 Ergebnismenge zurückgeben.

Externe Prozeduren in Perl oder PHP (LANGUAGE PERL, LANGUAGE PHP) können keine Ergebnismengen zurückgeben. Prozeduren, die vom Datenbankserver geladene native Funktionen aufrufen, können ebenfalls keine Ergebnismengen zurückgeben.

Externe CLR- oder Java-Prozeduren (LANGUAGE CLR, LANGUAGE JAVA) können 0, 1 oder mehr Ergebnismengen zurückgeben.

Einige Prozeduren können mehr als eine Ergebnismenge mit unterschiedlicher Spaltenanzahl zurückgeben, je nachdem, wie sie ausgeführt werden. Die folgende Prozedur gibt beispielsweise unter bestimmten Bedingungen zwei Spalten und in anderen Fällen nur eine Spalte zurück.

CREATE PROCEDURE names( IN formal char(1))
BEGIN
   IF formal = 'n' THEN
      SELECT GivenName
      FROM Employees
   ELSE
      SELECT Surname, GivenName
      FROM Employees
   END IF
END;

Prozeduren mit variablen Ergebnismengen müssen ohne RESULT-Klausel oder in Transact-SQL geschrieben werden. Ihre Verwendung ist den folgenden Einschränkungen unterworfen:

Wenn Ihre Prozedur nur eine Ergebnismenge zurückgibt, sollten Sie eine RESULT-Klausel verwenden. Das Vorhandensein dieser Klausel verhindert, dass ODBC- und Open Client-Anwendungen die Ergebnismenge noch einmal beschreiben, nachdem der Cursor geöffnet wurde.

Um mehrere Ergebnismengen verarbeiten zu können, muss ODBC den aktuell ausgeführten Cursor beschreiben, nicht die definierte Ergebnismenge der Prozedur. Deshalb beschreibt ODBC die Spaltennamen nicht immer so, wie sie in der RESULT-Klausel der gespeicherten Prozedur definiert sind. Um dieses Problem zu vermeiden, verwenden Sie Spaltenaliasnamen in der SELECT-Anweisung, die die Ergebnismenge erzeugt.

Weitere Hinweise zum Zurückgeben von Ergebnismengen aus Prozeduren finden Sie unter Ergebnisse aus Prozeduren zurückgeben.

NO RESULT SET-Klausel   Deklariert, dass von dieser Prozedur keine Ergebnismenge zurückgegeben wird. Diese Deklaration kann zu einer Performanceverbesserung führen.

DYNAMIC RESULT SETS-Klausel   Verwenden Sie diese Klausel mit LANGUAGE CLR- und LANGUAGE JAVA-Aufrufen. Wenn die Klausel DYNAMIC RESULT SETS nicht angegeben ist, wird angenommen, dass von der Methode keine Ergebnismengen zurückgegeben werden.

Beachten Sie, dass Prozeduren, die externe Funktionen in Perl oder PHP (LANGUAGE PERL, LANGUAGE PHP) aufrufen, keine Ergebnismengen zurückgeben können. Prozeduren, die native Funktionen aufrufen, die vom Datenbankserver geladen werden, können ebenfalls keine Ergebnismengen zurückgeben.

SQL SECURITY-Klausel   Die SQL SECURITY-Klausel legt fest, ob die Prozedur als INVOKER (der Benutzer, der die Prozedur aufruft) oder als DEFINER (der Eigentümer der Prozedur) aufgrufen wird. Standardwert ist DEFINER. Bei externen Aufrufen richtet diese Klausel den Eigentümerkontext für nicht qualifizierte Objektreferenzen in der externen Umgebung ein.

Wenn SQL SECURITY INVOKER angegeben ist, wird mehr Speicher verwendet, weil für jeden Benutzer, der die Prozedur aufruft, ein Vermerk erfolgen muss. Außerdem erfolgt bei SQL SECURITY INVOKER auch eine Namensauflösung als Aufrufer. Sie sollten daher mit Umsicht vorgehen und alle Objektnamen (Tabellen, Prozeduren etc.) mit ihrem richtigen Eigentümer qualifizieren. Beispiel: Der Benutzer user1 erstellt die folgende Prozedur:

CREATE PROCEDURE user1.myProcedure()
   RESULT( columnA INT )
   SQL SECURITY INVOKER
   BEGIN
     SELECT columnA FROM table1;
   END;

Wenn der Benutzer user2 versucht, diese Prozedur auszuführen, und eine Tabelle user2.table1 nicht existiert, kommt es zu einem Tabellensuchfehler. Wenn eine Tabelle user2.table1 existiert, wird diese Tabelle anstelle der beabsichtigten user1.table1 verwendet. Um dies zu verhindern, qualifizieren Sie die Tabellenreferenz in der Anweisung (user1.table1 anstelle von table1).

EXTERNAL NAME-Klausel   Eine Prozedur, die die EXTERNAL NAME-Klausel ohne LANGUAGE-Attribut verwendet, definiert eine Schnittstelle zu einer nativen Funktion, die in einer Programmiersprache wie C geschrieben ist. Die native Funktion wird vom Datenbankserver in seinen Adressenspeicher geladen.

Der Bibliotheksname kann eine Dateierweiterung enthalten. In der Regel handelt es sich um .dll unter Windows und .so unter Unix. Wenn keine Dateierweiterung angegeben ist, hängt die Software die plattformspezifische Dateierweiterung für Bibliotheken an. Es folgt ein formelles Beispiel.

CREATE PROCEDURE mystring( IN instr LONG VARCHAR )
EXTERNAL NAME 'mystring@mylib.dll;Unix:mystring@mylib.so';

Eine einfachere Methode, die oben genannte EXTERNAL NAME-Klausel mit plattformspezifischen Standardwerten zu schreiben, lautet wie folgt:

CREATE PROCEDURE mystring( IN instr LONG VARCHAR )
EXTERNAL NAME 'mystring@mylib';

Nach ihrem Aufruf wird die Bibliothek, die die Funktion enthält, in den Adressenspeicher des Datenbankservers geladen. Die native Funktion wird als Teil des Servers ausgeführt. In diesem Fall wird, falls die Funktion einen Fehler verursacht, der Datenbankserver beendet. Aus diesem Grund wird empfohlen, Funktionen in einer externen Umgebung mit dem LANGUAGE-Attribut zu laden und auszuführen. Wenn eine Funktion einen Fehler in einer externen Umgebung verursacht, läuft der Datenbankserver weiter.

Hinweis zur Syntax bei Verwendung von Betriebssystem: Wenn Sie Betriebssystem nicht festlegen, dann wird angenommen, dass die Prozedur auf allen Plattformen läuft. Wenn Sie Unix für einen der Aufrufe festlegen, dann wird angenommen, dass der andere Aufruf für Windows vorgesehen ist.

Weitere Hinweise zu nativen Bibliotheksaufrufen finden Sie unter SQL Anywhere-Schnittstelle für externe Aufrufe.