當(dāng)前位置：首頁(yè) > 运维知识 > 数据库 >内容正文

数据库

第 17 章 Native SQL查询

發(fā)布時(shí)間：2025/7/14 数据库 13 豆豆

生活随笔收集整理的這篇文章主要介紹了第 17 章 Native SQL查询小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,幫大家做個(gè)參考.

第?17?章?Native SQL查詢

你也可以使用你的數(shù)據(jù)庫(kù)的Native SQL語(yǔ)言來(lái)查詢數(shù)據(jù)。這對(duì)你在要使用數(shù)據(jù)庫(kù)的某些特性的時(shí)候(比如說(shuō)在查詢提示或者Oracle中的 CONNECT關(guān)鍵字)，這是非常有用的。這就能夠掃清你把原來(lái)直接使用SQL/JDBC 的程序遷移到基于 Hibernate應(yīng)用的道路上的障礙。

Hibernate3允許你使用手寫(xiě)的sql來(lái)完成所有的create,update,delete,和load操作（包括存儲(chǔ)過(guò)程）

17.1.?創(chuàng)建一個(gè)基于SQL的Query

SQL查詢是通過(guò)SQLQuery接口來(lái)控制的，它是通過(guò)調(diào)用Session.createSQLQuery()方法來(lái)獲得

List cats = sess.createSQLQuery("select {cat.*} from cats cat").addEntity("cat", Cat.class);.setMaxResults(50);.list();

這個(gè)查詢指定了:

SQL查詢語(yǔ)句，它帶一個(gè)占位符，可以讓Hibernate使用字段的別名.
查詢返回的實(shí)體，和它的SQL表的別名.

addEntity()方法將SQL表的別名和實(shí)體類(lèi)聯(lián)系起來(lái)，并且確定查詢結(jié)果集的形態(tài)。

addJoin()方法可以被用于載入其他的實(shí)體和集合的關(guān)聯(lián)，TODO:examples!

原生的SQL查詢可能返回一個(gè)簡(jiǎn)單的標(biāo)量值或者一個(gè)標(biāo)量和實(shí)體的結(jié)合體。

Double max = (Double) sess.createSQLQuery("select max(cat.weight) as maxWeight from cats cat").addScalar("maxWeight", Hibernate.DOUBLE);.uniqueResult();

17.2.?別名和屬性引用

上面使用的{cat.*}標(biāo)記是 "所有屬性" 的簡(jiǎn)寫(xiě).你可以顯式地列出需要的字段,但是你必須讓Hibernate 為每一個(gè)屬性注入字段的別名.這些字段的站位符是以字段別名為前導(dǎo),再加上屬性名.在下面的例子里,我們從一個(gè)其他的表(cat_log) 中獲取Cat對(duì)象,而非Cat對(duì)象原本在映射元數(shù)據(jù)中聲明的表.注意我們甚至在where子句中也可以使用屬性別名. 對(duì)于命名查詢,{}語(yǔ)法并不是必需的.你可以在第?17.3?節(jié) “命名SQL查詢”得到更多的細(xì)節(jié).

String sql = "select cat.originalId as {cat.id}, " +"cat.mateid as {cat.mate}, cat.sex as {cat.sex}, " +"cat.weight*10 as {cat.weight}, cat.name as {cat.name} " +"from cat_log cat where {cat.mate} = :catId"List loggedCats = sess.createSQLQuery(sql).addEntity("cat", Cat.class).setLong("catId", catId).list();

注意:如果你明確地列出了每個(gè)屬性,你必須包含這個(gè)類(lèi)和它的子類(lèi)的屬性! and its subclasses!

17.3.?命名SQL查詢

可以在映射文檔中定義查詢的名字,然后就可以象調(diào)用一個(gè)命名的HQL查詢一樣直接調(diào)用命名SQL查詢.在這種情況下,我們不需要調(diào)用addEntity()方法.

<sql-query name="mySqlQuery"><return alias="person" class="eg.Person"/>SELECT person.NAME AS {person.name},person.AGE AS {person.age},person.SEX AS {person.sex}FROM PERSON person WHERE person.NAME LIKE 'Hiber%' </sql-query> List people = sess.getNamedQuery("mySqlQuery").setMaxResults(50).list();

一個(gè)命名查詢可能會(huì)返回一個(gè)標(biāo)量值.你必須使用<return-scalar>元素來(lái)指定字段的別名和 Hibernate類(lèi)型

<sql-query name="mySqlQuery"><return-scalar column="name" type="string"/><return-scalar column="age" type="long"/>SELECT p.NAME AS name,p.AGE AS age,FROM PERSON p WHERE p.NAME LIKE 'Hiber%' </sql-query>

<return-join>和<load-collection>元素分別用作外連接和定義那些初始化集合的查詢

17.3.1.?使用return-property來(lái)明確地指定字段/別名

使用<return-property>你可以明確的告訴Hibernate使用哪些字段,這和使用{}-語(yǔ)法來(lái)讓Hibernate注入它自己的別名是相反的.

<sql-query name="mySqlQuery"><return alias="person" class="eg.Person"><return-property name="name" column="myName"/><return-property name="age" column="myAge"/><return-property name="sex" column="mySex"/></return>SELECT person.NAME AS myName,person.AGE AS myAge,person.SEX AS mySex,FROM PERSON person WHERE person.NAME LIKE :name </sql-query> <return-property>也可用于多個(gè)字段,它解決了使用{}-語(yǔ)法不能細(xì)粒度控制多個(gè)字段的限制 <sql-query name="organizationCurrentEmployments"><return alias="emp" class="Employment"> <return-property name="salary"> <return-column name="VALUE"/><return-column name="CURRENCY"/> </return-property><return-property name="endDate" column="myEndDate"/></return>SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer}, STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCYFROM EMPLOYMENTWHERE EMPLOYER = :id AND ENDDATE IS NULLORDER BY STARTDATE ASC </sql-query>

注意在這個(gè)例子中,我們使用了<return-property>結(jié)合{}的注入語(yǔ)法. 允許用戶來(lái)選擇如何引用字段以及屬性.

如果你映射一個(gè)識(shí)別器(discriminator),你必須使用<return-discriminator>來(lái)指定識(shí)別器字段

17.3.2.?使用存儲(chǔ)過(guò)程來(lái)查詢

Hibernate 3引入了對(duì)存儲(chǔ)過(guò)程查詢的支持. 存儲(chǔ)過(guò)程必須返回一個(gè)結(jié)果集,作為Hibernate能夠使用的第一個(gè)外部參數(shù). 下面是一個(gè)Oracle9和更高版本的存儲(chǔ)過(guò)程例子.

CREATE OR REPLACE FUNCTION selectAllEmployments RETURN SYS_REFCURSOR AS st_cursor SYS_REFCURSOR; BEGIN OPEN st_cursor FOR SELECT EMPLOYEE, EMPLOYER, STARTDATE, ENDDATE, REGIONCODE, EID, VALUE, CURRENCY FROM EMPLOYMENT; RETURN st_cursor; END;

在Hibernate里要要使用這個(gè)查詢,你需要通過(guò)命名查詢來(lái)映射它.

<sql-query name="selectAllEmployees_SP" callable="true"><return alias="emp" class="Employment"><return-property name="employee" column="EMPLOYEE"/><return-property name="employer" column="EMPLOYER"/> <return-property name="startDate" column="STARTDATE"/><return-property name="endDate" column="ENDDATE"/> <return-property name="regionCode" column="REGIONCODE"/> <return-property name="id" column="EID"/> <return-property name="salary"> <return-column name="VALUE"/><return-column name="CURRENCY"/> </return-property></return>{ ? = call selectAllEmployments() } </sql-query>

注意存儲(chǔ)過(guò)程當(dāng)前僅僅返回標(biāo)量和實(shí)體.現(xiàn)在不支持<return-join>和<load-collection>

17.3.2.1.?使用存儲(chǔ)過(guò)程的規(guī)則和限制

為了在Hibernate中使用存儲(chǔ)過(guò)程,你必須遵循一些規(guī)則.不遵循這些規(guī)則的存儲(chǔ)過(guò)程將不可用.如果你仍然想要使用他們, 你必須通過(guò)session.connection()來(lái)執(zhí)行他們.這些規(guī)則針對(duì)于不同的數(shù)據(jù)庫(kù).因?yàn)閿?shù)據(jù)庫(kù) 提供商有各種不同的存儲(chǔ)過(guò)程語(yǔ)法和語(yǔ)義.

對(duì)存儲(chǔ)過(guò)程進(jìn)行的查詢無(wú)法使用setFirstResult()/setMaxResults()進(jìn)行分頁(yè)。

對(duì)于Oracle有如下規(guī)則:

存儲(chǔ)過(guò)程必須返回一個(gè)結(jié)果集.它通過(guò)返回SYS_REFCURSOR實(shí)現(xiàn)(在Oracle9或10),在Oracle里你需要定義一個(gè)REF CURSOR 類(lèi)型
推薦的格式是 { ? = call procName(<parameters>) } 或 { ? = call procName }(這更像是Oracle規(guī)則而不是Hibernate規(guī)則)

對(duì)于Sybase或者M(jìn)S SQL server有如下規(guī)則:

存儲(chǔ)過(guò)程必須返回一個(gè)結(jié)果集。.注意這些servers可能返回多個(gè)結(jié)果集以及更新的數(shù)目.Hibernate將取出第一條結(jié)果集作為它的返回值，其他將被丟棄。
如果你能夠在存儲(chǔ)過(guò)程里設(shè)定SET NOCOUNT ON，這可能會(huì)效率更高，但這不是必需的。

17.4.?定制SQL用來(lái)create，update和delete

Hibernate3能夠使用定制的SQL語(yǔ)句來(lái)執(zhí)行create,update和delete操作。在Hibernate中，持久化的類(lèi)和集合已經(jīng) 包含了一套配置期產(chǎn)生的語(yǔ)句(insertsql, deletesql, updatesql等等)，這些映射標(biāo)記 <sql-insert>, <sql-delete>, and <sql-update>重載了這些語(yǔ)句。

<class name="Person"><id name="id"><generator class="increment"/></id><property name="name" not-null="true"/><sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-insert><sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update><sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete> </class>

這些SQL直接在你的數(shù)據(jù)庫(kù)里執(zhí)行，所以你可以自由的使用你喜歡的任意語(yǔ)法。但如果你使用數(shù)據(jù)庫(kù)特定的語(yǔ)法，這當(dāng)然會(huì)降低你映射的可移植性。

如果設(shè)定callable，則能夠支持存儲(chǔ)過(guò)程了。

<class name="Person"><id name="id"><generator class="increment"/></id><property name="name" not-null="true"/><sql-insert callable="true">{call createPerson (?, ?)}</sql-insert><sql-delete callable="true">{? = call deletePerson (?)}</sql-delete><sql-update callable="true">{? = call updatePerson (?, ?)}</sql-update> </class>

參數(shù)的位置順序是非常重要的，他們必須和Hibernate所期待的順序相同。

你能夠通過(guò)設(shè)定日志調(diào)試級(jí)別為org.hiberante.persister.entity,來(lái)查看Hibernate所期待的順序。在這個(gè)級(jí)別下， Hibernate將會(huì)打印出create,update和delete實(shí)體的靜態(tài)SQL。如果想看到預(yù)想中的順序。記得不要將定制SQL包含在映射文件里，因?yàn)樗麄儠?huì)重載Hibernate生成的靜態(tài)SQL。

在大多數(shù)情況下(最好這么做)，存儲(chǔ)過(guò)程需要返回插入/更新/刪除的行數(shù)，因?yàn)镠ibernate對(duì)語(yǔ)句的成功執(zhí)行有些運(yùn)行時(shí)的檢查。 Hibernate常會(huì)把進(jìn)行CUD操作的語(yǔ)句的第一個(gè)參數(shù)注冊(cè)為一個(gè)數(shù)值型輸出參數(shù)。

CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2)RETURN NUMBER IS BEGINupdate PERSONsetNAME = uname,whereID = uid;return SQL%ROWCOUNT;END updatePerson;

17.5.?定制裝載SQL

你可能需要聲明你自己的SQL(或HQL)來(lái)裝載實(shí)體

<sql-query name="person"><return alias="p" class="Person" lock-mode="upgrade"/>SELECT NAME AS {p.name}, ID AS {p.id} FROM PERSON WHERE ID=? FOR UPDATE </sql-query>

這只是一個(gè)前面討論過(guò)的命名查詢聲明，你可以在類(lèi)映射里引用這個(gè)命名查詢。

這也可以用于存儲(chǔ)過(guò)程

TODO: 未完成的例子

<sql-query name="organizationEmployments"><load-collection alias="empcol" role="Organization.employments"/>SELECT {empcol.*}FROM EMPLOYMENT empcolWHERE EMPLOYER = :idORDER BY STARTDATE ASC, EMPLOYEE ASC </sql-query><sql-query name="organizationCurrentEmployments"><return alias="emp" class="Employment"/><synchronize table="EMPLOYMENT"/>SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},REGIONCODE as {emp.regionCode}, ID AS {emp.id}FROM EMPLOYMENTWHERE EMPLOYER = :id AND ENDDATE IS NULLORDER BY STARTDATE ASC </sql-query>

轉(zhuǎn)載于:https://www.cnblogs.com/nieshanfeng/archive/2011/08/23/2151265.html

總結(jié)

以上是生活随笔為你收集整理的第 17 章 Native SQL查询的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。

SQL
native