Lagret procedure i SAP HANA (SQL-vejledning)

Af: Murer Garcia Murer Garcia
Hours Opdateret

⚡ Smart opsummering

SAP HANA SQL Stored Procedure er en genbrugelig, navngivet blok af SQLScript, der udfører en specifik dataoperation. Den accepterer IN-, OUT- og INOUT-parametre, kan markeres som skrivebeskyttet med READS SQL DATA og oprettes på skema- eller pakkeniveau ved hjælp af CREATE PROCEDURE-syntaksen.

  • 🧱 Vælg hvor du vil oprette: Definer procedurer på skema- (katalog-) eller pakke- (indholds-) niveau afhængigt af, hvor de hører hjemme i SAP HANA-datamodel.
  • 📥 Brug parametre bevidst: IN sender input, OUT returnerer output, INOUT gør begge dele — navngiv dem for klarhedens skyld i hver signatur.
  • 🔐 Vælg SQL SECURITY omhyggeligt: DEFINER kører med opretterens privilegier; INVOKER kører med den, der kalder - valg baseret på dataadgangspolitik.
  • 📚 Markér som skrivebeskyttet, når det er muligt: LÆSER SQL DATA dokumenterer intention, optimerer planlægning og tillader, at proceduren vises via en resultatvisning.
  • 🤖 Brug AI til at udarbejde procedurer: AI-assistenter omdanner almindelig engelsk logik til CREATE PROCEDURE-skabeloner med parametre, undtagelseshåndterere og resultatvisninger.
Læs mere

SAP HANA SQL-lagret procedure

Hvad er en SQL-lagret procedure?

A lagret procedure er en navngiven, genanvendelig kodeenhed, der udfører en specifik opgave. Procedurer kan sammensættes til større programmer, hvilket er fundamentet for Modulært designÉn procedure kan kalde en anden — den, der kalder den, kaldes opkaldsprogram.

Procedurer er genanvendelige behandlingsblokke med en defineret rækkefølge af datatransformationer. De kan acceptere flere input- og outputparametre og kan deklareres som skrivebeskyttede eller læse-skrivebeskyttede.

An SQL procedure i SAP HANA kan oprettes på:

  • Skemaniveau (Katalognode) — administreres via kataloget og er synlig for alle forbrugere med de rette rettigheder.
  • Pakkeniveau (Indholdsnode) — administreret som et designtidsartefakt i en applikationspakke.

SAP HANA-lagret proceduresyntaks

Den generelle syntaks for oprettelse af en procedure i SAP HANA er vist nedenfor.

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 }

CREATE PROCEDURE sætning opretter en procedure ved hjælp af det programmeringssprog, der er angivet af <lang>Standardsproget er SQLScript.

Syntakselementer forklaret

Tabellen nedenfor beskriver alle klausuler, der bruges i CREATE PROCEDURE-syntaksen.

Element Beskrivelse
<proc_name> Procedurens navn.
<parameter_clause> Liste over parametre, hver markeret med IN, OUT eller INOUT:
• IN — skrivebeskyttet input sendt til proceduren.
• OUT — output returneret fra proceduren.
• IND UD — både sender en værdi ind og returnerer den ændrede værdi ud.
LANGUAGE <lang> Programmeringssprog brugt i proceduren. Standard: SQLSCRIPT.
SQL SECURITY <mode> Sikkerhedstilstand (Standard: DEFINER):
• DEFINER — kører med procedurens opretters rettigheder.
• INVOKER — kører med den, der ringer op, sine privilegier.
DEFAULT SCHEMA <default_schema_name> Skema brugt til at fortolke ukvalificerede objekter i procedurens brødtekst. Hvis det udelades, bruges det aktuelle sessionsskema.
READS SQL DATA Markerer proceduren som skrivebeskyttet. Den kan ikke ændre data eller skema, indeholder ingen DDL eller DML og kan kun kalde andre skrivebeskyttede procedurer.
WITH RESULT VIEW <view_name> Definerer den resultatvisning, der bruges som procedurens output. Når en resultatvisning er til stede, kan proceduren forespørges af en anden SQL sætning, som om det var en tabel eller en visning.
SEQUENTIAL EXECUTION Tvinger procedurens indhold til at udføres sekventielt uden parallelisme.
<procedure_body> Hoveddelen af ​​proceduren, skrevet i det valgte programmeringssprog.
HEADER ONLY Opretter kun procedurens egenskaber med et OID, uden at kompilere brødteksten. Nyttig til fremadrettedeklarationer.

Eksempel: Opret en simpel lagret procedure

Eksemplet nedenfor opretter en skrivebeskyttet procedure, der returnerer det samlede salg for en given kunde.

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;

Kald proceduren med:

CALL GET_CUSTOMER_SALES ('C0001', ?);

SAP HANA Studio (eller enhver JDBC/ODBC-klient) returnerer værdien af ev_total i outputparameteren.

RELATEREDE ARTIKLER

Kald af en lagret procedure

Når en lagret procedure er oprettet, kaldes den via CALL sætning, eventuelt i en anden procedure, en SQLScript-funktion eller en ekstern klient. De fire mest almindelige kaldsmønstre er:

  • Fra SQL: CALL my_proc(p1, p2, ?); — pladsholdere returnerer OUT-værdier.
  • Fra en anden procedure: CALL another_proc(:in1, :out1);
  • Fra en applikation: binde inputparametre og læse output via JDBC, ODBC eller Cloud SDK.
  • Som en virtuel tabel: Når en resultatvisning erklæres, skal proceduren forespørges med en SELECT mod visningsnavnet.

Bedste praksis for HANA Stored Procedures

Nedenstående vaner holder HANA-procedurer læsbare, effektive og nemme at vedligeholde:

  • Navngiv parametre med præfikser: iv_ til input, ev_ til eksport, og iov_ til input/output.
  • Marker intention med READS SQL DATA hvor proceduren reelt er skrivebeskyttet.
  • Brug SQL SECURITY INVOKER for delte procedurer, der skal respektere den, der ringer op, sine privilegier.
  • Ombryd hver blok i BEGIN/SLUT og hold kroppen kort — opdel tung logik i hjælpeprocedurer.
  • Håndter undtagelser: brug DECLARE EXIT HANDLER for elegant fejlrapportering.
  • Undgå VÆLG * inde i procedurer — navngiv de kolonner, du rent faktisk har brug for, så planerne forbliver stabile.

Ofte Stillede Spørgsmål

En procedure kan have flere OUT-parametre, kan udstede DML og kaldes med CALL. En funktion returnerer en enkelt skalar- eller tabelværdi, kører uden bivirkninger og bruges i SELECT, WHERE eller andre udtryk.

Standardsproget og det mest almindelige sprog er SQLScript. HANA understøtter også R til procedurer, der kræver statistiske biblioteker, og L til lavniveau-scripting. SQLScript er det rigtige valg til næsten alle forretningsprocedurer.

DEFINER kører proceduren med rettighederne fra den bruger, der oprettede den – nyttigt, når proceduren skal have adgang til tabeller, som den kaldende ikke kan se direkte. INVOKER kører med den kaldendes rettigheder, hvilket er sikrere for procedurer med delte værktøjer.

Brug READS SQL DATA, når proceduren kun læser data og aldrig skriver dem. Det dokumenterer intentionen, tillader resultatvisninger og lader optimeringsprogrammet planlægge proceduren mere aggressivt.

Brug CALL-sætningen: CALL proc_name (in_val, out_param);Fra en applikation kan du binde input og output via JDBC-, ODBC- eller Cloud SDK-driveren, eller eksponere proceduren via OData til REST-klienter.

Drop en procedure med DROP PROCEDURE proc_name; og genskab den med CREATE OR REPLACE PROCEDURE. SAP HANA understøtter ikke ALTER PROCEDURE; standardmønsteret er CREATE OR REPLACE.

AI-assistenter genererer CREATE PROCEDURE-skabeloner, foreslår parameternavne, skriver undtagelseshandlere og oversætter logik på almindelig engelsk til SQLScript. De påpeger også manglende skemakvalifikationer og risikabel DML i skrivebeskyttede kontekster.

Ja. AI-værktøjer annoterer SQLScript linje for linje – og forklarer, hvad hver parameter gør, hvorfor en bestemt join blev valgt, og hvor proceduren kan fejle med forkerte input – hvilket gør kodegennemgang og onboarding meget hurtigere.

Opsummer dette indlæg med: