Gespeicherte Prozedur in SAP HANA (SQL-Tutorial)

⚡ Intelligente Zusammenfassung

SAP Eine HANA SQL Stored Procedure ist ein wiederverwendbarer, benannter SQLScript-Block, der eine bestimmte Datenoperation ausführt. Sie akzeptiert IN-, OUT- und INOUT-Parameter, kann mit READS SQL DATA als schreibgeschützt markiert werden und wird auf Schema- oder Paketebene mit der Syntax CREATE PROCEDURE erstellt.

  • 🧱 Wählen Sie den Erstellungsort aus: Prozeduren werden auf Schema- (Katalog-) oder Paketebene (Inhalt) definiert, je nachdem, wo sie hingehören. SAP HANA-Datenmodell.
  • 📥 Parameter bewusst einsetzen: IN übergibt die Eingabe, OUT gibt die Ausgabe zurück, INOUT macht beides – benennen Sie sie zur Verdeutlichung in jeder Signatur.
  • 🔐 Wählen Sie die SQL-Sicherheit sorgfältig aus: DEFINER wird mit den Berechtigungen des Erstellers ausgeführt; INVOKER wird mit den Berechtigungen des Aufrufers ausgeführt – wählen Sie basierend auf der Datenzugriffsrichtlinie.
  • 📚 Wenn möglich, als schreibgeschützt markieren: READS SQL DATA dokumentiert die Absicht, optimiert die Planung und ermöglicht die Darstellung der Prozedur über eine Ergebnisansicht.
  • 🤖 KI zur Erstellung von Verfahrensanweisungen nutzen: KI-Assistenten wandeln Logik in natürlicher Sprache in CREATE PROCEDURE-Vorlagen mit Parametern, Ausnahmebehandlungsroutinen und Ergebnisansichten um.

SAP HANA SQL-gespeicherte Prozedur

Was ist eine SQL-gespeicherte Prozedur?

A gespeicherte Prozedur Eine Prozedur ist eine benannte, wiederverwendbare Codeeinheit, die eine bestimmte Aufgabe ausführt. Prozeduren können zu größeren Programmen zusammengesetzt werden, was die Grundlage für … bildet. modulares DesignEine Prozedur kann eine andere aufrufen – der Aufrufer wird als Prozedur bezeichnet. Anrufprogramm.

Prozeduren sind wiederverwendbare Verarbeitungsblöcke mit einer definierten Abfolge von Datentransformationen. Sie können mehrere Eingabe- und Ausgabeparameter akzeptieren und als schreibgeschützt oder lesbar/schreibbar deklariert werden.

An SQL Verfahren in SAP HANA kann erstellt werden unter:

  • Schemaebene (Katalogknoten) — wird über den Katalog verwaltet und ist für jeden Konsumenten mit den entsprechenden Berechtigungen sichtbar.
  • Paketebene (Inhaltsknoten) — wird als Entwurfszeitartefakt innerhalb eines Anwendungspakets verwaltet.

SAP HANA-Syntax für gespeicherte Prozeduren

Die allgemeine Syntax zum Erstellen einer Prozedur in SAP HANA wird unten dargestellt.

CREATE PROCEDURE <proc_name> [(<parameter_clause>)] [LANGUAGE <lang>]
    [SQL SECURITY <mode>] [DEFAULT SCHEMA <default_schema_name>]
    [READS SQL DATA [WITH RESULT VIEW <view_name>]] AS
    { BEGIN [SEQUENTIAL EXECUTION]
        <procedure_body>
      END
    | HEADER ONLY }

Das CREATE PROCEDURE Die Anweisung erstellt eine Prozedur in der angegebenen Programmiersprache. <lang>Die Standardsprache ist SQLScript.

Erläuterung der Syntaxelemente

Die folgende Tabelle beschreibt jede Klausel, die in der CREATE PROCEDURE-Syntax verwendet wird.

Element Beschreibung
<proc_name> Name des Verfahrens.
<parameter_clause> Liste der Parameter, jeweils gekennzeichnet mit IN, OUT oder INOUT:
• IN — schreibgeschützte Eingabe, die an die Prozedur übergeben wird.
• OUT — Ausgabe, die von der Prozedur zurückgegeben wird.
• EIN AUS — beide übergeben einen Wert als Eingabe und geben den geänderten Wert als Ausgabe zurück.
LANGUAGE <lang> In der Prozedur verwendete Programmiersprache. Standard: SQLSCRIPT.
SQL SECURITY <mode> Sicherheitsmodus (Standard: DEFINER):
• DEFINIERER — wird mit den Privilegien des Erstellers des Verfahrens ausgeführt.
• AUFRUFER — wird mit den Berechtigungen des Aufrufers ausgeführt.
DEFAULT SCHEMA <default_schema_name> Schema zur Auflösung nicht qualifizierter Objekte im Prozedurrumpf. Wird es weggelassen, wird das Schema der aktuellen Sitzung verwendet.
READS SQL DATA Kennzeichnet die Prozedur als schreibgeschützt. Sie kann weder Daten noch Schema ändern, enthält keine DDL- oder DML-Anweisungen und kann nur andere schreibgeschützte Prozeduren aufrufen.
WITH RESULT VIEW <view_name> Definiert die Ergebnisansicht, die als Ausgabe der Prozedur verwendet wird. Wenn eine Ergebnisansicht vorhanden ist, kann die Prozedur von einer anderen Prozedur abgefragt werden. SQL Eine Anweisung, als wäre es eine Tabelle oder eine Ansicht.
SEQUENTIAL EXECUTION Erzwingt die sequentielle Ausführung des Prozedurkörpers ohne Parallelität.
<procedure_body> Hauptteil der Prozedur, geschrieben in der gewählten Programmiersprache.
HEADER ONLY Erzeugt lediglich die Eigenschaften der Prozedur mit einer OID, ohne den Prozedurrumpf zu kompilieren. Nützlich für Vorwärtsdeklarationen.

Beispiel: Erstellen einer einfachen gespeicherten Prozedur

Das folgende Beispiel erstellt eine schreibgeschützte Prozedur, die den Gesamtumsatz für einen bestimmten Kunden zurückgibt.

CREATE PROCEDURE GET_CUSTOMER_SALES (
    IN  iv_customer_id NVARCHAR(10),
    OUT ev_total       DECIMAL(15,2)
)
LANGUAGE SQLSCRIPT
SQL SECURITY INVOKER
READS SQL DATA AS
BEGIN
    SELECT SUM(NET_VALUE) INTO ev_total
    FROM   "SALES"."ORDERS"
    WHERE  CUSTOMER_ID = :iv_customer_id;
END;

Rufen Sie die Prozedur mit folgendem Befehl auf:

CALL GET_CUSTOMER_SALES ('C0001', ?);

SAP HANA Studio (oder ein beliebiger JDBC/ODBC-Client) gibt den Wert von ev_total im Ausgabeparameter.

Aufruf einer gespeicherten Prozedur

Nach ihrer Erstellung wird eine gespeicherte Prozedur über die CALL Die Anweisung kann optional innerhalb einer anderen Prozedur, einer SQLScript-Funktion oder eines externen Clients erfolgen. Die vier häufigsten Aufrufmuster sind:

  • Aus SQL: CALL my_proc(p1, p2, ?); — Platzhalter geben OUT-Werte zurück.
  • Aus einem anderen Verfahren: CALL another_proc(:in1, :out1);
  • Aus einer Anwendung: Eingabeparameter binden und Ausgaben über JDBC, ODBC oder das Cloud SDK lesen.
  • Als virtueller Tisch: Wenn eine Ergebnisansicht deklariert wird, fragen Sie die Prozedur mit einer SELECT-Anweisung gegen den Ansichtsnamen ab.

Best Practices für HANA-gespeicherte Prozeduren

Die folgenden Gewohnheiten sorgen dafür, dass HANA-Prozeduren lesbar, performant und wartungsfreundlich bleiben:

  • Namensparameter mit Präfixen: iv_ für Eingabe ev_ für den Export und iov_ für Ein-/Ausgabe.
  • Markieren Sie die Absicht mit READS SQL DATA überall dort, wo das Verfahren tatsächlich schreibgeschützt ist.
  • Verwenden Sie den SQL-Sicherheitsaufrufer. für gemeinsame Verfahren, die die Privilegien des Anrufers respektieren sollten.
  • Umschließen Sie jeden Block mit BEGIN/END. und halten Sie den Hauptteil kurz – teilen Sie komplexe Logik in Hilfsprozeduren auf.
  • Ausnahmen behandeln: - DECLARE EXIT HANDLER für eine elegante Fehlerberichterstattung.
  • Vermeiden Sie SELECT * Innerhalb der Prozeduren – benennen Sie die Spalten, die Sie tatsächlich benötigen, damit die Pläne stabil bleiben.

Häufig gestellte Fragen

Eine Prozedur kann mehrere OUT-Parameter haben, DML-Anweisungen ausführen und wird mit CALL aufgerufen. Eine Funktion gibt einen einzelnen Skalar- oder Tabellenwert zurück, hat keine Seiteneffekte und wird innerhalb von SELECT-, WHERE- oder anderen Ausdrücken verwendet.

Die Standardsprache und am häufigsten verwendete Sprache ist SQLScript. HANA unterstützt außerdem R für Prozeduren, die statistische Bibliotheken benötigen, und L für Low-Level-Skripte. SQLScript ist für nahezu alle Geschäftsprozesse die richtige Wahl.

DEFINER führt die Prozedur mit den Berechtigungen des Benutzers aus, der sie erstellt hat – nützlich, wenn die Prozedur auf Tabellen zugreifen soll, die der Aufrufer nicht direkt sehen kann. INVOKER wird mit den Berechtigungen des Aufrufers ausgeführt, was für gemeinsam genutzte Hilfsprozeduren sicherer ist.

Verwenden Sie READS SQL DATA, wenn die Prozedur Daten nur liest und niemals schreibt. Dies dokumentiert die Absicht, ermöglicht Ergebnisansichten und erlaubt dem Optimierer eine aggressivere Planung der Prozedur.

Verwenden Sie die CALL-Anweisung: CALL proc_name (in_val, out_param);Binden Sie aus einer Anwendung heraus Eingaben und Ausgaben über den JDBC-, ODBC- oder Cloud SDK-Treiber oder stellen Sie die Prozedur über OData für REST-Clients bereit.

Lassen Sie einen Eingriff abbrechen mit DROP PROCEDURE proc_name; und erstellen Sie es mit CREATE OR REPLACE PROCEDURE neu. SAP HANA unterstützt ALTER PROCEDURE nicht; das Standardmuster ist CREATE OR REPLACE.

KI-Assistenten generieren CREATE PROCEDURE-Vorlagen, schlagen Parameternamen vor, schreiben Ausnahmebehandlungsroutinen und übersetzen Logik in SQLScript. Sie weisen außerdem auf fehlende Schema-Qualifizierungen und riskante DML-Anweisungen in schreibgeschützten Kontexten hin.

Ja. KI-Tools annotieren SQLScript Zeile für Zeile – sie erklären die Funktion jedes Parameters, warum ein bestimmter Join gewählt wurde und wo die Prozedur bei fehlerhaften Eingaben fehlschlagen könnte – wodurch Code-Review und Onboarding deutlich beschleunigt werden.

Fassen Sie diesen Beitrag mit folgenden Worten zusammen: