Hive存儲過程HQL/SQL（一）–hplsql命令行

PL/HQL主要是經過命令行工具來執行一個SQL查詢語句或者是一個SQL腳本。

進入hplsql-0.3.11，執行./ hplsql便可顯示命令行的用法：

1. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql
2. usage: hplsql
3. -d,--define <key=value> Variable subsitution e.g. -d A=B or --define A=B
4. -e HPL/SQL from command line
5. -f HPL/SQL from a file
6. -H,--help Print help information
7. --hiveconf <property=value> Value for given property
8. --hivevar <key=value> Variable subsitution e.g. --hivevar A=B
9. -main Entry point (procedure or function name)
10. -offline,--offline Offline mode - skip SQL execution
11. -trace,--trace Print debug information
12. -version,--version Print HPL/SQL version

1.1 -d,–define

-d,–define <key=value> 選項能夠指定變量名及變量值，它和–hiveconf <property=value>以及–hivevar <key=value>的效果等價。

1. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -e "PRINT a || ', ' || b" -d a=Hello -d b=lxw1234.com
2. Hello, lxw1234.com
3. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -e "PRINT a || ', ' || b" --hiveconf a=Hello --hiveconf b=lxw1234.com
4. Hello, lxw1234.com
5. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -e "PRINT a || ', ' || b" --hivevar a=Hello --hivevar b=lxw1234.com
6. Hello, lxw1234.com

1.2 -e <quoted-query-string>

同hive –e，用於執行HQL語句；

1. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -e "SELECT * FROM liuxiaowen.dual"
2. Open connection: jdbc:hive2://172.16.212.17:10000 (109 ms)
3. Starting query
4. Query executed successfully (182 ms)
5. X
6. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -e "PRINT 'Hello, lxw1234.com'"
7. Hello, lxw1234.com

1.3 –f <filename>

同hive –f，執行一個文件中保存的HQL語句。

1. [liuxiaowen@dev hplsql-0.3.11]$ cat lxw1234.sql
2. PRINT 'Hello, lxw1234.com';
3. SELECT * FROM liuxiaowen.dual;
4. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -f lxw1234.sql
5. Hello, lxw1234.com
6. Open connection: jdbc:hive2://172.16.212.17:10000 (109 ms)
7. Starting query
8. Query executed successfully (165 ms)
9. X

1.4 -trace,–trace

打印debug信息。

1. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -e "PRINT 'Hello, lxw1234.com'" -trace
2. Configuration file: file:/home/liuxiaowen/hplsql-0.3.11/hplsql-site.xml
3. Parser tree: (program (block (stmt (print_stmt PRINT (expr (expr_atom (string 'Hello, lxw1234.com')))))))
4. Ln:1 PRINT
5. Hello, lxw1234.com

1.5 –main <procname>

-main <procname>

只執行指定函數或存儲過程內的語句。

好比：lxw1234.sql文件內容以下：

1. [liuxiaowen@dev hplsql-0.3.11]$ cat lxw1234.sql
2. CREATE PROCEDURE set_message(IN arg STRING)
3. BEGIN
4. SET result = 'Hello, lxw的大數據田地!';
5. PRINT result || ' ' || arg;
6. END;
7.  
8. PRINT 'Hello, lxw1234.com! at beginning .. ';
9. CALL set_message(' by CALL ..');
10. SELECT * FROM liuxiaowen.dual;
11.  

1．建立存儲過程set_message；

2．打印’Hello, lxw1234.com! at beginning .. ‘;

3．調用存儲過程，並傳入參數；

4．查詢Hive表liuxiaowen.dual；

看看使用-main選項和不使用的執行結果：

1. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -f lxw1234.sql
2. Hello, lxw1234.com! at beginning ..
3. Hello, lxw的大數據田地! by CALL ..
4. Open connection: jdbc:hive2://172.16.212.17:10000 (125 ms)
5. Starting query
6. Query executed successfully (166 ms)
7. X
8. [liuxiaowen@dev hplsql-0.3.11]$ ./hplsql -f lxw1234.sql -main set_message
9. Hello, lxw的大數據田地!
10.  

若是不指定-main選項，那麼則將lxw1234.sql中的語句從頭至尾執行完。
若是指定了-main選項，則會執行指定存儲過程內的語句。

 

-H,–help爲打印幫助信息。-version,–version 打印HPL/SQL版本。

-offline,–offline選項的功能還未搞明白。