Procedura memorizzata in SAP HANA (Tutorial SQL)

By: Muratore Garcia Muratore Garcia
Hours aggiornato

⚡ Riepilogo intelligente

SAP Una stored procedure SQL di HANA è un blocco di codice SQLScript riutilizzabile e denominato che esegue una specifica operazione sui dati. Accetta parametri IN, OUT e INOUT, può essere contrassegnata come di sola lettura con READS SQL DATA e viene creata a livello di schema o di pacchetto utilizzando la sintassi CREATE PROCEDURE.

  • 🧱 Scegli dove creare: Definire le procedure a livello di schema (Catalogo) o di pacchetto (Contenuto) a seconda di dove appartengono nel SAP Modello dati HANA.
  • 📥 Utilizzare i parametri intenzionalmente: IN trasmette l'input, OUT restituisce l'output, INOUT fa entrambe le cose: assegnate un nome a questi gruppi per chiarezza in ogni firma.
  • 🔐 Scegliete con attenzione SQL SECURITY: DEFINER viene eseguito con i privilegi del creatore; INVOKER viene eseguito con quelli del chiamante: la scelta dipende dalla politica di accesso ai dati.
  • 📚 Se possibile, contrassegnare come di sola lettura: READS SQL DATA documenta l'intento, ottimizza la pianificazione e consente di esporre la procedura tramite una vista dei risultati.
  • 🤖 Utilizzare l'intelligenza artificiale per redigere le procedure: Gli assistenti basati sull'intelligenza artificiale trasformano la logica in linguaggio naturale in modelli CREATE PROCEDURE con parametri, gestori di eccezioni e visualizzazioni dei risultati.
Scopri di più

SAP Procedure memorizzate SQL HANA

Che cos'è una stored procedure SQL?

A Stored procedure è un'unità di codice denominata e riutilizzabile che esegue un compito specifico. Le procedure possono essere composte in programmi più grandi, che costituiscono il fondamento di design modulare. Una procedura può chiamarne un'altra: il chiamante è detto il programma di chiamata.

Le procedure sono blocchi di elaborazione riutilizzabili con una sequenza definita di trasformazioni di dati. Possono accettare più parametri di input e output e possono essere dichiarate di sola lettura o di lettura/scrittura.

An SQL procedura dentro SAP HANA può essere creato a:

  • Livello dello schema (Nodo del catalogo) — gestito tramite il catalogo e visibile a ogni consumatore dotato dei privilegi appropriati.
  • Livello del pacchetto (Nodo di contenuto) — gestito come artefatto in fase di progettazione all'interno di un pacchetto applicativo.

SAP Sintassi delle stored procedure HANA

La sintassi generale per la creazione di una procedura in SAP HANA è mostrato di seguito.

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 }

Migliori CREATE PROCEDURE l'istruzione crea una procedura utilizzando il linguaggio di programmazione specificato da <lang>Il linguaggio predefinito è SQLScript.

Spiegazione degli elementi sintattici

La tabella seguente descrive ogni clausola utilizzata nella sintassi CREATE PROCEDURE.

elemento Descrizione
<proc_name> Nome della procedura.
<parameter_clause> Elenco dei parametri, ciascuno contrassegnato come IN, OUT o INOUT:
· XNUMX€ IN — input di sola lettura passato alla procedura.
· XNUMX€ OUT — output restituito dalla procedura.
· XNUMX€ IN USCITA — entrambi accettano un valore in ingresso e restituiscono il valore modificato.
LANGUAGE <lang> Linguaggio di programmazione utilizzato nella procedura. Predefinito: SQLSCRIPT.
SQL SECURITY <mode> Modalità di sicurezza (Predefinita: DEFINER):
· XNUMX€ Definitore — viene eseguito con i privilegi del creatore della procedura.
· XNUMX€ INVOCATORE — viene eseguito con i privilegi del chiamante.
DEFAULT SCHEMA <default_schema_name> Schema utilizzato per risolvere gli oggetti non qualificati nel corpo della procedura. Se omesso, viene utilizzato lo schema della sessione corrente.
READS SQL DATA Contrassegna la procedura come di sola lettura. Non può modificare dati o schema, non contiene istruzioni DDL o DML e può solo richiamare altre procedure di sola lettura.
WITH RESULT VIEW <view_name> Definisce la vista dei risultati utilizzata come output della procedura. Quando è presente una vista dei risultati, la procedura può essere interrogata da un'altra SQL dichiarazione come se fosse una tabella o una vista.
SEQUENTIAL EXECUTION Costringe il corpo della procedura a essere eseguito in sequenza senza parallelismo.
<procedure_body> Corpo principale della procedura, scritto nel linguaggio di programmazione selezionato.
HEADER ONLY Crea solo le proprietà della procedura con un OID, senza compilare il corpo. Utile per le dichiarazioni anticipate.

Esempio: Creare una stored procedure semplice

L'esempio seguente crea una procedura di sola lettura che restituisce il totale delle vendite per un determinato cliente.

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;

Richiamare la procedura con:

CALL GET_CUSTOMER_SALES ('C0001', ?);

SAP HANA Studio (o qualsiasi client JDBC/ODBC) restituisce il valore di ev_total nel parametro di output.

ARTICOLI CORRELATI

Chiamata di una stored procedure

Una volta creata, una stored procedure viene richiamata tramite CALL istruzione, facoltativamente all'interno di un'altra procedura, una funzione SQLScript o un client esterno. I quattro modelli di invocazione più comuni sono:

  • Da SQL: CALL my_proc(p1, p2, ?); — i segnaposto restituiscono valori OUT.
  • Da un'altra procedura: CALL another_proc(:in1, :out1);
  • Da un'applicazione: Associa i parametri di input e leggi l'output tramite JDBC, ODBC o Cloud SDK.
  • Come tavolo virtuale: Quando viene dichiarata una vista dei risultati, interroga la procedura con una query SELECT sul nome della vista.

Migliori pratiche per le stored procedure HANA

Le abitudini descritte di seguito mantengono le procedure HANA leggibili, performanti e di facile manutenzione:

  • Denominare i parametri con i prefissi: iv_ per l'input, ev_ per l'esportazione e iov_ per input/output.
  • Contrassegna l'intento con READS SQL DATA ovunque la procedura sia effettivamente di sola lettura.
  • Utilizzare SQL SECURITY INVOKER per procedure condivise che devono rispettare i privilegi del chiamante.
  • Avvolgi ogni blocco in BEGIN/END e mantieni il corpo del codice breve: suddividi la logica complessa in procedure ausiliarie.
  • Gestire le eccezioni: uso DECLARE EXIT HANDLER per una segnalazione degli errori elegante.
  • Evita SELECT * Procedure interne: nomina le colonne di cui hai effettivamente bisogno affinché i piani rimangano stabili.

DOMANDE FREQUENTI

Una procedura può avere più parametri OUT, può eseguire istruzioni DML e viene richiamata con CALL. Una funzione restituisce un singolo valore scalare o di tabella, viene eseguita senza effetti collaterali e viene utilizzata all'interno di SELECT, WHERE o altre espressioni.

Il linguaggio predefinito e più comune è SQLScript. HANA supporta anche R per le procedure che necessitano di librerie statistiche e L per lo scripting di basso livello. SQLScript è la scelta giusta per quasi tutte le procedure aziendali.

DEFINER esegue la procedura con i privilegi dell'utente che l'ha creata, il che è utile quando la procedura deve accedere a tabelle che il chiamante non può visualizzare direttamente. INVOKER viene eseguito con i privilegi del chiamante, il che è più sicuro per le procedure di utilità condivise.

Utilizzare READS SQL DATA ogni volta che la procedura legge i dati e non li scrive mai. Questa opzione documenta l'intento, consente di visualizzare i risultati e permette all'ottimizzatore di pianificare la procedura in modo più aggressivo.

Utilizzare l'istruzione CALL: CALL proc_name (in_val, out_param);Da un'applicazione, è possibile associare input e output tramite il driver JDBC, ODBC o Cloud SDK, oppure esporre la procedura tramite OData per i client REST.

Elimina una procedura con DROP PROCEDURE proc_name; e ricrearlo con la procedura CREATE OR REPLACE. SAP HANA non supporta ALTER PROCEDURE; il modello standard è CREATE OR REPLACE.

Gli assistenti basati sull'IA generano modelli CREATE PROCEDURE, suggeriscono nomi di parametri, scrivono gestori di eccezioni e traducono la logica in linguaggio naturale in SQLScript. Inoltre, segnalano la mancanza di qualifiche dello schema e le operazioni DML rischiose all'interno di contesti di sola lettura.

Sì. Gli strumenti di intelligenza artificiale annotano SQLScript riga per riga, spiegando la funzione di ciascun parametro, il motivo della scelta di una particolare join e i punti in cui la procedura potrebbe fallire in presenza di input errati, rendendo la revisione del codice e l'onboarding molto più rapidi.

Riassumi questo post con: