SQLScript Syntax For SAP HANA

Download as pdf or txt
Download as pdf or txt
You are on page 1of 11

07/08/2017 SQLScript Syntax for SAP HANA

8th November 2012 SQLScript Syntax for SAP HANA


SQLScript Syntax for SAP HANA

Table Type De inition


SQLScripts datatype extension also allows the deni on of table types. These table types are used to dene parameters
for a procedure that represent tabular results.

In contrast to definitions of database tables, table types do not have an instance that is created when the table
type is created (i.e., no Data Manipulation Language (DML) statements (INSERT, UPDATE, DELETE) are
supported on table types).

A table type can be dropped using the DROP TYPE statement.

Example:
CREATE TYPE tt_publishers AS TABLE ( publisher INTEGER, name VARCHAR(50), price
DECIMAL, cnt INTEGER);

CREATE TYPE tt_years AS TABLE ( year VARCHAR(4), price DECIMAL, cnt INTEGER);

DROP TYPE {schema.}name {CASCADE}

Create Procedure

It is a callable statement, and so it can be called using a CALL statement. Read-only procedures with one
table output parameter support the additional creation of a result view.

CREATE PROCEDURE getOutput( IN cnt INTEGER, IN currency VARCHAR(3), OUT


output_pubs tt_publishers, OUT output_year tt_years) LANGUAGE SQLSCRIPT READS SQL
DATA AS

BEGIN

big_pub_ids = SELECT publisher AS pid FROM books -- Query Q1 GROUP BY publisher


HAVING COUNT(isbn) > :cnt;

big_pub_books = SELECT title, name, publisher, -- Query Q2 year, price FROM


:big_pub_ids, publishers, books WHERE pub_id = pid AND pub_id = publisher AND
crcy = :currency;

output_pubs = SELECT publisher, name, -- Query Q3 SUM(price) AS price,


COUNT(title) AS cnt FROM :big_pub_books GROUP BY publisher, name;

output_year = SELECT year, SUM(price) AS price, -- Query Q4 COUNT(title) AS cnt


FROM :big_pub_books GROUP BY year;

END;

The SQLScript above defines a read-only procedure which has 2 scalar input parameters and 2 output
parameters of type table. As different languages are supported in the body of the procedure, the
implementation language is defined to be SQLScript. Moreover, the procedure is a read-only procedure.
Hence it is free of side effects and can be called by other read-only procedures.

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 1/11
07/08/2017 SQLScript Syntax for SAP HANA

Syntax:
CREATE PROCEDURE {schema.}name {({IN|OUT|INOUT} param_name data_type {,...})}
{LANGUAGE <LANG>} {SQL SECURITY <MODE>} {READS SQL DATA {WITH RESULT VIEW
<view_name>}} AS
BEGIN
...
END

The implementation language is by default SQLSCRIPT. You can specify the security mode. Privileges are
always checked with the privileges of the definer of a procedure when the procedure is created. With security
mode definer, which is the default, execution of the procedure is then performed with the privileges of the
definer of the procedure. The other alternative is mode invoker.

If a read-only procedure has exactly one table output parameter a RESULT VIEW can be specified.

CREATE PROCEDURE ProcWithResultView(IN id INT, OUT o1 CUSTOMER) LANGUAGE SQLSCRIPT


READS SQL DATA WITH RESULT VIEW ProcView AS
BEGIN
o1 = SELECT * FROM CUSTOMER WHERE CUST_ID = :id;
END;

Normally, procedures can only be executed via the call statement. By using WITH RESULT VIEW it is possible to
query the result of a procedure as part of a SQL statement. Please no ce that no variable references are supported in
the WITH PARAMETERS clause and that all constants are passed as string constants (i.e. enclosed in single quotes). Also,
parameter names are lower case independent from the original capitaliza on in the procedure signature.

Example:

SELECT * FROM ProcView WITH PARAMETERS ('placeholder' = ('$$id$$', '5'))

DROP PROCEDURE
Syntax:
DROP PROCEDURE {schema.}name {CASCADE}

ALTER PROCEDURE
Syntax:

ALTER PROCEDURE {schema.}name RECOMPILE {WITH PLAN}

Procedure Calls

A procedure can be called by a client on the outer-most level, using any of the supported client interfaces, or
within the body of a procedure.

CALL...WITH OVERVIEW From Client

A common requirement is to write the result of a procedure call directly into a physical table. For this purpose
a procedure can be called using the CALL WITH OVERVIEW syntax. This flavor of calling a procedure
returns one result set that holds the information of which table contains the result of a particular tables output

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 2/11
07/08/2017 SQLScript Syntax for SAP HANA

variable. Scalar outputs will be represented as temporary tables with only one cell. CALL WITH OVERVIEW
is the replacement for the former CALLS statement. When passing existing tables to the output parameters
CALL WITH OVERVIEW will insert the result set tuples of the procedure into the given tables. When
passing NULL to the output parameters, temporary tables holding the result sets will be generated. These
tables will be dropped automatically once the session is closed. The semantics of the optional IN DEBUG
MODE clause is the same as for the call without WITH OVERVIEW clause.

Example:
CALL getOutput (1000, 'EUR', ot_publishers, NULL) WITH OVERVIEW;
Returns the following table: Variable Table
OUPPUT_PUBS "SYSTEM"."OT_PUBLISHERS"
OUTPUT_YEAR "SYSTEM"."OUTPUT_YEAR_4CF5FA0BF9397F8
8E10000000A12737F"

CALL - Internal Procedure Call


Syntax:
CALL {schema.}name (:in_param1, out_param {, ...})

Example:

CALL addDiscount (:lt_expensive_books, lt_on_sale);

When procedure addDiscount is called, the variable :lt_expensive_books is assigned to the func on and the
variable lt_on_sales is bound by this func on call.

Implementing Functional Logic

The body of a procedure consists of a sequence of statements separated by semicolons:


CREATE PROCEDURE {schema.}name({IN|OUT|INOUT} param_name data_type {,...})
LANGUAGE SQLSCRIPT ... AS BEGIN
statement1; statement2; {...}
END

Scalar Variables

scalar variables can also be defined as local variables.

CREATE PROCEDURE sql_proc() LANGUAGE SQLSCRIPT AS


v_count INT := 0;
v_isbn VARCHAR(20);
v_title VARCHAR(50) := ' ';
v_price decimal(5,2) := 0;
v_crcy VARCHAR(3) := 'XXX';

BEGIN
v_isbn := '978-3-8266-1664-8';

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 3/11
07/08/2017 SQLScript Syntax for SAP HANA

SELECT isbn, title, price, crcy INTO v_isbn, v_title, v_price, v_crcy FROM books
WHERE isbn = :v_isbn;

SELECT COUNT(*) INTO v_count FROM books;

DELETE FROM books; SELECT COUNT(*) INTO v_count FROM books;

v_isbn := '978-3-642-19362-0';

v_title := 'In-Memory Data Management';

v_price := 42.75;

INSERT into books VALUES (v_isbn, :v_title, 1, 1, '2011', :v_price, 'EUR');

SELECT isbn, title, price, crcy INTO v_isbn, v_title, v_price, v_crcy FROM books
WHERE isbn = :v_isbn;

UPDATE books SET price = price * 1.1 WHERE isbn = :v_isbn;

SELECT isbn, title, price, crcy INTO v_isbn, v_title, v_price, v_crcy FROM books
WHERE isbn = :v_isbn;

END;

Control Structures
Conditionals
Syntax:
IF <bool-expr1>
THEN {then-stmts1}
{ELSEIF <bool-expr2>
THEN
{then-stmts2}}
{ELSE
{else-stmts3}}
END IF

The IF statement consists of a boolean expression bool-expr1. If this expression evaluates to true then the
statements then-stmts1 in the mandatory THEN block are executed. The IF statement ends with END IF. The
remaining parts are op onal.
If the Boolean expression bool-expr1 does not evaluate to true the ELSE-branch is evaluated. In most cases this
branch starts with ELSE. The statements else-stmts3 are executed without further checks. A er an else branch no
further ELSE branch or ELSEIF branch is allowed.
Alterna vely, when ELSEIF is used instead of ELSE another boolean expression bool-expr2 is evaluated. If it
evaluates to true, the statements then-stmts2 is executed. In this fashion an arbitrary number of ELSEIF clauses
can be added.
This statement can be used to simulate the switch-case statement known from many programming languages.

CREATE PROCEDURE upsert_proc (IN v_isbn VARCHAR(20)) LANGUAGE SQLSCRIPT AS


found INT := 1;
BEGIN
SELECT count(*) INTO found FROM books WHERE isbn = :v_isbn;

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 4/11
07/08/2017 SQLScript Syntax for SAP HANA

IF :found = 0
THEN INSERT INTO books VALUES (:v_isbn, 'In-Memory Data Management', 1, 1,
'2011', 42.75, 'EUR');
ELSE UPDATE books SET price = 42.75 WHERE isbn =:v_isbn;
END IF;
END;

While Loop
Syntax:
WHILE <bool-stmt> DO {stmts} END WHILE

v_index1 := 0;
WHILE :v_index1 < 5 DO
v_index2 := 0;
WHILE :v_index2 < 5 DO
v_index2 := :v_index2 + 1;
END WHILE;
v_index1 := :v_index1 + 1;
END WHILE;

For Loop
Syntax:
FOR <loop-var> IN {REVERSE} <start> .. <end> DO
{stmts}
END FOR

The for loop iterates a range of numeric values denoted by start and end in the syntax and binds the
current value to a variable (loop-var) in ascending order. Iteration starts with value start and is incremented by
one until the loop-var is larger than end. Hence, if start is larger than end, the body loop will not be evaluated.

FOR v_index1 IN -2 .. 2 DO
FOR v_index2 IN REVERSE 0 .. 5 DO
CALL ins_msg_proc('Here is ' ||:v_index1 || '~' ||:v_index2 || '.');
END FOR;
END FOR;

Break and Continue


Syntax:
BREAK
CONTINUE
Descrip on:
This is internal control func onality for loops. You can use break to immediately leave the loop and con nue to
immediately resume with the next itera on.
Example:
FOR x IN 0 .. 10 DO
IF :x < 3 THEN
CONTINUE;
END IF;
ins_msg_proc('Inside loop, after CONTINUE: x = ' || :x);
IF :x = 5 THEN
BREAK;

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 5/11
07/08/2017 SQLScript Syntax for SAP HANA

END IF;
END FOR;

Cursors
Cursors are used to fetch single rows from the result set returned by a query. When the cursor is declared, it is bound to
a query. It is possible to parameterize the query to which the cursor is bound.

Cursors are defined like local variables, i.e. after the signature of the procedure and before the procedures
body. The cursor is defined with a name, optionally a list of parameters, and a SQL SELECT statement. The
cursor provides the functionality to iterate through a query result row-by-row. Updating cursors is not
supported.

Open Cursor
Syntax:
OPEN <cursor-name>{(arg1, ...)}

Close Cursor
Syntax:
CLOSE <cursor-name>

A ribute Descrip on
cur::ISCLOSED Is true if cursor cur is closed, true otherwise.
cur::NOTFOUND Is true if the previous fetch opera on returned
no valid row, false otherwise. Before calling OPEN
or a er calling CLOSE on a cursor this will always
return true.
cur::ROWCOUNT Returns the number of rows in the result set of
the query bound to the cursor. This value is
available a er the rst FETCH opera on.

CREATE PROCEDURE cursor_proc LANGUAGE SQLSCRIPT AS


v_isbn VARCHAR(20);
CURSOR c_cursor1 (v_isbn VARCHAR(20)) FOR
SELECT isbn, title, price, crcy FROM books WHERE isbn = :v_isbn ORDER BY isbn;

BEGIN
OPEN c_cursor1('978-3-86894-012-1');

IF c_cursor1::ISCLOSED
THEN
CALL ins_msg_proc('WRONG: cursor not open'); ELSE CALL ins_msg_proc('OK: cursor
open');
END IF;
FETCH c_cursor1 INTO v_isbn, v_title, v_price, v_crcy;

IF c_cursor1::NOTFOUND
THEN
CALL ins_msg_proc('WRONG: cursor contains no valid data');
ELSE

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 6/11
07/08/2017 SQLScript Syntax for SAP HANA

CALL ins_msg_proc('OK: cursor contains valid data');


END IF;
CLOSE c_cursor1;
END

Looping over Result Sets


Syntax:
FOR <row-var> AS <cursor-name>{(arg1, ...)} DO <stmts> <row-var>.<column> --
attribute access END FOR

CREATE PROCEDURE foreach_proc() LANGUAGE SQLSCRIPT AS v_isbn VARCHAR(20) := '';


CURSOR c_cursor1 (v_isbn VARCHAR(20)) FOR
SELECT isbn, title, price, crcy FROM books ORDER BY isbn;
BEGIN
FOR cur_row as c_cursor1 DO
CALL ins_msg_proc('book title is: ' || cur_row.title);
END FOR;
END;

Dynamic SQL
With dynamic SQL it is possible to construct SQL statements at run me of a SQLScript procedure.
Syntax:
EXEC '<sql-statement>'

Opportuni es for op miza ons are limited.


The statement is poten ally recompiled every me the statement is executed.
One cannot use SQLScript variables in the SQL statement (but when construc ng the SQL statement string).
One cannot bind the result of a dynamic SQL statement to a SQLScript variable.
One must be very careful to avoid SQL injec on bugs that might harm the integrity or security of the database.

It is recommended to avoid dynamic SQL because it might have a negative impact on security or performance.

Catalog Information
When a procedure or func on is created, this will be reected in the database catalog. One can use this informa on for
debugging purposes. For procedures informa on are stored in system views summarized below.

View SYS.PROCEDURES:

View SYS. PROCEDURE_PARAMAMETERS:

Tracing and Debugging SQLScript

typically required to understand errors returned by the SQLScript compiler or unexpected runtime behavior of
SQLScript procedures.

menu View Open Perspective Administration Console. In this perspective tracing information is
available in the panel called Diagnosis Files.

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 7/11
07/08/2017 SQLScript Syntax for SAP HANA

sqlscript: informa on related to the SQLScript compiler, i.e. the early phases of compiling SQLScript into calcula on
models
calcengineinstan ate: informa on collected during instan a on of a calcula on model, i.e. the nal phase of
compiling SQLScript into calcula on models and when the SQLScript procedure is invoked.
calcengine: informa on collected by the calcula on engine at run me. This is relevant for the parts of SQLScript that
are translated into calcula on models.
llang: informa on collected by the L component. This is relevant for all aspect of SQLScript the relate to L, i.e.
compila on into L and execu on of L code.

Performance Trace
To analyze the performance characteris cs of a given workload it is possible to collect performance informa on. It
allows specialists to associate long-running SQLScript or SQL features with code fragments. Based on this informa on
rewrites of the SQL / SQLScript code can be proposed or performance issues in the database engine can be iden ed.

Tracing SQL Statements


During the compila on of SQLScript mul ple SQL statements may be combined into larger ones, or statements may be
reordered for be er performance. Because of this, it is some mes useful to trace the SQL statements executed by the
SAP HANA database for debugging purposes. Another reason for using this feature would be to examining the
performance of certain SQL statements.

select * from #PROCEDURE_DATAFLOWS_

The temporary table #PROCEDURE_DATAFLOWS_ can be used to iden fy the data ows into which the SQLScript
compiler translated the SQLScript source. In our example, the compiler creates a single dataow, which is op mal for
op mizing the script into an ecient plan.

select * from #PROCEDURE_MAPPING_

Tracing SQLScript Invocation

CALL getOutput(0, 'EUR', NULL, NULL) WITH OVERVIEW IN DEBUG MODE;

select * from M_CE_DEBUG_NODE_MAPPING;

select * from M_CE_DEBUG_JSONS

Manually Tracing Intermediate Results

Achieved by adding TRACE-operators into the SQLScript code

CREATE PROCEDURE getOutput2( IN cnt INTEGER, IN currency VARCHAR(3), OUT


output_pubs tt_publishers, OUT output_year tt_years) LANGUAGE SQLSCRIPT READS SQL
DATA AS

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 8/11
07/08/2017 SQLScript Syntax for SAP HANA

BEGIN
t_big_pub_ids = SELECT publisher AS pid FROM books -- Query Q1 GROUP BY publisher
HAVING COUNT(isbn) > :cnt;
big_pub_ids = TRACE(:t_big_pub_ids);
t_big_pub_books = SELECT title, name, publisher, -- Query Q2 year, price FROM
:big_pub_ids, publishers, books WHERE pub_id = pid AND pub_id = publisher AND
crcy = :currency;
big_pub_books = TRACE(:t_big_pub_books);
output_pubs = SELECT publisher, name, -- Query Q3 SUM(price) AS price,
COUNT(title) AS cnt FROM :big_pub_books GROUP BY publisher, name;
output_year = SELECT year, SUM(price) AS price, -- Query Q4 COUNT(title) AS cnt
FROM :big_pub_books GROUP BY year;
END;

select * from sqlscript_trace;

If you want to clear the content you may call the following built-in procedure.
call truncate_sqlscript_trace;
Posted 8th November 2012 by JD

18 View comments

BASIS LABS January 8, 2014 at 12:03 AM


very useful information by you thank you swathi
Reply

yektek January 8, 2014 at 2:26 AM


nice post thanks
Reply

SinduBindu com January 23, 2014 at 1:38 AM


SQL Script Syntax for SAP HANA is too good. Thank you
Reply

Keylabs SAP training February 5, 2014 at 8:55 PM


thanks for sharing this valuable information bindu
Reply

yektek training February 12, 2014 at 1:05 AM


looking great sir thanks - siri
Reply

yektek.com March 6, 2014 at 2:24 AM


Valuable info Latha Pallavi
Reply
http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 9/11
07/08/2017 SQLScript Syntax for SAP HANA

yektek.com April 3, 2014 at 3:28 AM


Nice post thank you very much Lathapallavi
Reply

Ramys July 4, 2014 at 3:50 AM


Thanks to Sharing the SAP Material for Freshers and Experiences,
Link as,
saptraininginchennai
Reply

rekha kommaka July 17, 2014 at 11:21 PM


HI,
Thanks for your valuable information.
Sap Training in Chennai
Reply

Rajesh November 13, 2014 at 2:15 AM


Selenium Training in chennai,

Hi,i hope to your information really understand.

Please refer this link below,


Seleniumtraininginchennai
Reply

Raja Kathiresan November 17, 2014 at 1:19 AM


Thanks to Share the QTP Material for Freshers,
qtptrainingchennai
Reply

Raju November 21, 2014 at 1:53 AM


Thanks to Share the LoadRunner Material for Freshers,Link as,
LoadRunnerTraining in Chennai
Reply

Raju November 21, 2014 at 1:57 AM


Thanks to Share the Java Material for Freshers,Link as,
javatraininginchennai
Reply

Albert Andrada April 28, 2015 at 6:39 AM


Really Nice Information,Thank You Very Much For Sharing.
Wordpress Development
Reply

Albert Andrada April 28, 2015 at 6:40 AM

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 10/11
07/08/2017 SQLScript Syntax for SAP HANA

Really Nice Information,Thank You Very Much For Sharing.


Wordpress Development Company
Reply

RS Trainings March 8, 2016 at 2:21 AM


Thanks for posting this valuable information. It is useful to beginners for SAP ..... SAP HANA Online Training |
SAP online Training
Reply

Rahul July 9, 2016 at 2:25 AM


Thanks for sharing this Informative content. Well explained. Got to learn new things from your Blog on SAP MM.
SAP MM
Reply

GrayMatter Software Services July 25, 2017 at 12:07 AM


Nice Article on HANA. Useful Information about SAP HANA Implementation and Services.
Do you want free demo on SAP HANA Implementation, then please contact SAP HANA Services
Reply

Enter your comment...

Comment as: Unknown (Google) Sign out

Publish Preview Notify me

http://inmemoryhana.blogspot.in/2012/11/sqlscript-syntax-for-sap-hana.html 11/11

You might also like