SAP Tutoriel sur les scripts SQL HANA : syntaxe et exemples

Qu'est-ce que le script SQL ?

SQL Script est une collection d'extensions de SQL. Il peut être utilisé dans une procédure stockée à la place du SQL brut. Il détermine les extensions fonctionnelles et procédurales.

In SQL L'utilisateur de script peut définir des variables locales pour la structure et les tables qui sont principalement utilisées pour la création de procédures stockées.

Le script SQL peut également être utilisé dans la vue Calcul. Dans SQL Script, il existe deux conteneurs logiques différents :

• Procédure (Les procédures permettent de décrire une séquence de transformations de données sur les données passées en entrée et en tables de base de données).
• Fonction définie par l'utilisateur (le conteneur de fonctions définies par l'utilisateur est séparé en fonction définie par l'utilisateur scalaire et en fonction définie par l'utilisateur de table).

Les éléments du langage de script SQL sont les suivants :

Logique de script SQL déclarative (extension fonctionnelle)

• Il permet la définition de types de tables sans référencer les tables de base de données.
• Déclaration typique comme SELECT.
• Fonctions du moteur de calcul (CE).

Logique de script SQL d'orchestration (extension fonctionnelle)

La logique d'orchestration est utilisée pour implémenter le flux de données à l'aide d'instructions de requête DDL, DML et SQL et pour contrôler la logique de flux à l'aide de constructions de langage impératives telles que des boucles et des conditions.

• Déclaration du langage de définition de données. Par exemple, créer un schéma.
• Langage de manipulation de données (par exemple, insertion).

Logique de script SQL impérative (extension procédurale)

La logique impérative divise la logique entre plusieurs flux de données. Par exemple, IF, ELSEIF, ELSE, CASE, FOR (boucle) et exceptions.

Importance du script SQL

Seul SQL Script fournit les éléments nécessaires pour migrer la logique gourmande en données ou le fonctionnement du serveur d'applications vers le serveur de base de données.

Points clés du script SQL

• Le script SQL est exécuté et traité dans le moteur de calcul de la base de données HANA.
• SQL Script est capable d'effectuer des calculs complexes.
• Dans SQL Script, une variable locale peut être déclarée pour contenir le résultat intermédiaire.
• La procédure de script SQL peut renvoyer plus de résultats en utilisant le « paramètre de SORTIE », tandis que la procédure SQL normale ne peut en renvoyer qu'un seul.
• Dans SQL Script, vous pouvez définir des types de tables globales ou locales qui peuvent être utilisées comme paramètres.

En utilisant SQL Script, le mode de traitement parallèle peut être obtenu.

Exemple de procédure de script SQL

Une procédure est le conteneur le plus courant. L'exemple ci-dessous lit les données des employés, les filtre et renvoie le résultat via un paramètre de table de sortie.

CREATE PROCEDURE DHK_SCHEMA.GET_HIGH_EARNERS (
  IN  im_min_salary DECIMAL(15,2),
  OUT ex_employees  TABLE (EMP_NAME NVARCHAR(100), SALARY DECIMAL(15,2)),
  OUT ex_row_count  INTEGER
)
LANGUAGE SQLSCRIPT
READS SQL DATA
AS
BEGIN
  -- Declarative logic: a table variable, not a physical table
  lt_all = SELECT EMP_NAME, SALARY
             FROM DHK_SCHEMA.EMPLOYEE
            WHERE SALARY >= :im_min_salary;

  -- Imperative logic: branch on the result
  SELECT COUNT(*) INTO ex_row_count FROM :lt_all;

  IF :ex_row_count = 0 THEN
    ex_employees = SELECT '' AS EMP_NAME, 0 AS SALARY FROM DUMMY WHERE 1 = 0;
  ELSE
    ex_employees = SELECT * FROM :lt_all ORDER BY SALARY DESC;
  END IF;
END;

Il convient de noter trois conventions. Un deux-points précède toute lecture d'une variable, donc :lt_all lit la variable de table pendant que lt_all L'instruction `reads SQL DATA` à gauche indique à l'optimiseur que la procédure n'a pas d'effets de bord, ce qui permet une parallélisation plus poussée. Or, une procédure renvoyant plusieurs paramètres de sortie est précisément une capacité qui fait défaut au SQL standard.

Le terme est simple :

CALL DHK_SCHEMA.GET_HIGH_EARNERS (50000, ?, ?);

Fonctions scalaires et tabulaires définies par l'utilisateur

Lorsqu'une procédure exécute des actions, une fonction renvoie une valeur et peut être utilisée dans une requête. SQL Script propose deux formes qui ne sont pas interchangeables.

-- Scalar function: returns one value
CREATE FUNCTION DHK_SCHEMA.ADD_BONUS (im_salary DECIMAL(15,2))
  RETURNS total DECIMAL(15,2)
  LANGUAGE SQLSCRIPT AS
BEGIN
  total := :im_salary * 1.10;
END;

SELECT EMP_NAME, DHK_SCHEMA.ADD_BONUS(SALARY) AS WITH_BONUS
  FROM DHK_SCHEMA.EMPLOYEE;

Une fonction de table est définie avec RETURNS TABLE et est ensuite interrogée dans la clause FROM, ce qui en fait la méthode naturelle pour construire un ensemble de données paramétré et réutilisable. vue de calcul ou le rapport peut consommer.

Meilleures pratiques en matière de scripts SQL

Le code SQL Script est performant lorsqu'il est conçu pour permettre au moteur de paralléliser le traitement, et médiocre lorsqu'il est écrit comme du code applicatif. Six habitudes font toute la différence.

1. Privilégiez le style déclaratif au style impératif. Une instruction ensembliste unique surpasse une boucle traitant les lignes une à une, souvent de façon considérable. N'utilisez une boucle FOR que lorsque la logique ne peut véritablement pas être exprimée comme une opération ensembliste.
2. Évitez les curseurs. Ils imposent un traitement ligne par ligne et neutralisent complètement le moteur de calcul. Presque chaque curseur peut être réécrit sous forme de jointure ou d'agrégation.
3. Veillez à ce que les déclarations restent indépendantes. Deux variables de table non liées entre elles sont calculées en parallèle. L'enchaînement de chaque étape sur la précédente sérialise l'ensemble de la procédure.
4. Déclarez READS SQL DATA où vrai. Cela indique que la procédure n'a pas d'effets secondaires, ce qui permet une optimisation plus poussée.
5. Filtrer le plus tôt possible. Réduire le nombre de lignes dans la première variable de tableau réduit tout ce qui suit, alors que le filtrage à la fin a déjà payé le coût.
6. Abandonnez les fonctions CE_. Elles sont obsolètes, ne peuvent pas être librement combinées avec du SQL dans une même instruction, et l'optimiseur SQL gère désormais mieux le même travail.

La syntaxe au niveau des instructions est abordée dans SAP HANASQL, les fonctions disponibles à l'intérieur d'une procédure dans SAP Fonctions SQL HANA, et les objets de modélisation qui consomment ces procédures dans le SAP Modélisation HANA tutoriel.

FAQ