本文轉自http://blog.csdn.net/double2hao/article/details/50281273,在此感謝作者
query(table, columns, selection, selectionArgs, groupBy, having, orderBy, limit)方法各參數的含義:
table:表名。相當於select語句from關鍵字后面的部分。如果是多表聯合查詢,可以用逗號將兩個表名分開。
columns:要查詢出來的列名。相當於select語句select關鍵字后面的部分。
selection:查詢條件子句,相當於select語句where關鍵字后面的部分,在條件子句允許使用占位符“?”
selectionArgs:對應於selection語句中占位符的值,值在數組中的位置與占位符在語句中的位置必須一致,否則就會有異常。
groupBy:相當於select語句group by關鍵字后面的部分
having:相當於select語句having關鍵字后面的部分
orderBy:相當於select語句order by關鍵字后面的部分,如:personid desc, age asc;
limit:指定偏移量和獲取的記錄數,相當於select語句limit關鍵字后面的部分。
首先我們假設我們有如下表格,表格名稱“Employees”:
| Id | LastName | FirstName | Address | City |
|---|---|---|---|---|
| 1 | Adams | John | Oxford Street | London |
| 2 | Bush | George | Fifth Avenue | New York |
| 3 | Carter | Thomas | Changan Street | Beijing |
SQL基本格式如下:
- SELECT 列名稱 FROM 表名稱
最基本SQL語句,就是從表中選取要返回的列數據,不加任何過濾條件。當然如果我們的“列名稱”是"*",那么將返回整個表格數據。在 Android上,SQL相關的method通常有一個參數就是String[] columns,而這個參數對應的就是SQL語句中的“列名稱”。我們可以看一個Android中的method - query:
- public Cursor query (String table, String[] columns, String selection, String[] selectionArgs,
- String groupBy, String having, String orderBy, String limit)
假設我們想獲取人員的全名,那么SQL語句如下:
- SELECT FirstName, LastName FROM Employees
當然一般地我們會有條件的過濾我們想要的結果,例如我只想返回city為Beijing的人員信息,那么我就需要用WHERE來過濾:
- SELECT * FROM Employees WHERE City= 'Beijing'
這里where后面跟的字符串就是Android的method中對應得參數String selection。Android的method中通常還有個參數與此相關就是 String[] selectionArgs,當 selection參數中包含問號"?"時,那么selectionArgs才會用到。舉個例子假設selection參數賦值如下:
- String selection = ”City=?";
這時我們必須在selectionArgs中賦值
- String[] selectionArgs = { "Beijing" };
也就是說selectionArgs中的字符串就是對應selection中的問號所代表的變量。實際上就是讓selection中的過濾條件City可以動態的賦值,而不是寫死在程序當中。在 query() 執行時會對 selectionArgs 中的字符串正確轉義並替換到對應的 ? 處以構成完整的 selection 字符串。 有點像 String.format()。
那么很顯然參數String groupBy就是對應SQL語句中GROUP BY后面的字符串,GROUP BY是與合計函數(Aggregate Functions)如SUM()一起使用的。詳細的用法大家可以從網上查查。
參數String having對應SQL語句HAVING后面的字符串,也是要與合計函數一起使用的。
參數String orderBy對應SQL語句ORDER BY后面的字符串。
參數limit指明返回的rows的數量。
我們下面舉個例子,假設有如下數據表,表名"Orders":
| Id | CustomerName | OrderPrice | Country | OrderDate |
| 1 | Arc | 100 | China | 2010/1/2 |
| 2 | Bor | 200 | USA | 2010/3/20 |
| 3 | Cut | 500 | Japan | 2010/2/20 |
| 4 | Bor | 300 | USA | 2010/3/2 |
| 5 | Arc | 600 | China | 2010/3/25 |
| 6 | Doom | 200 | China | 2010/3/26 |
假設我們想查詢客戶總的訂單數在500元以上的,且County在中國的客戶的名稱和訂單總數,且按照CustomerName來排序,默認ASC排序,那么SQL語句應當是:
- SELECT CustomerName, SUM (OrderPrice) FROM Orders WHERE Country=?
- GROUP BY CustomerName
- HAVING SUM (OrderPrice)>500
- ORDER BY CustomerName
那么對應Android的query函數的參數如下:
- String table = "Orders" ;
- String[] columns = new String[] { "CustomerName" , "SUM(OrderPrice)" };
- String selection = "Country=?" ;
- String[] selectionArgs = new String[]{ "China" };
- String groupBy = "CustomerName" ;
- String having = "SUM(OrderPrice)>500" ;
- String orderBy = "CustomerName" ;
- Cursor c = db.query(table, columns, selection, selectionArgs, groupBy, having, orderBy, null);
查詢的結果應該是:
| CustomerName | SUM(OrderPrice) |
| Arc | 700 |
首先我們假設我們有如下表格,表格名稱“Employees”:
| Id | LastName | FirstName | Address | City |
|---|---|---|---|---|
| 1 | Adams | John | Oxford Street | London |
| 2 | Bush | George | Fifth Avenue | New York |
| 3 | Carter | Thomas | Changan Street | Beijing |
SQL基本格式如下:
- SELECT 列名稱 FROM 表名稱
最基本SQL語句,就是從表中選取要返回的列數據,不加任何過濾條件。當然如果我們的“列名稱”是"*",那么將返回整個表格數據。在 Android上,SQL相關的method通常有一個參數就是String[] columns,而這個參數對應的就是SQL語句中的“列名稱”。我們可以看一個Android中的method - query:
- public Cursor query (String table, String[] columns, String selection, String[] selectionArgs,
- String groupBy, String having, String orderBy, String limit)
假設我們想獲取人員的全名,那么SQL語句如下:
- SELECT FirstName, LastName FROM Employees
當然一般地我們會有條件的過濾我們想要的結果,例如我只想返回city為Beijing的人員信息,那么我就需要用WHERE來過濾:
- SELECT * FROM Employees WHERE City= 'Beijing'
這里where后面跟的字符串就是Android的method中對應得參數String selection。Android的method中通常還有個參數與此相關就是 String[] selectionArgs,當 selection參數中包含問號"?"時,那么selectionArgs才會用到。舉個例子假設selection參數賦值如下:
- String selection = ”City=?";
這時我們必須在selectionArgs中賦值
- String[] selectionArgs = { "Beijing" };
也就是說selectionArgs中的字符串就是對應selection中的問號所代表的變量。實際上就是讓selection中的過濾條件City可以動態的賦值,而不是寫死在程序當中。在 query() 執行時會對 selectionArgs 中的字符串正確轉義並替換到對應的 ? 處以構成完整的 selection 字符串。 有點像 String.format()。
那么很顯然參數String groupBy就是對應SQL語句中GROUP BY后面的字符串,GROUP BY是與合計函數(Aggregate Functions)如SUM()一起使用的。詳細的用法大家可以從網上查查。
參數String having對應SQL語句HAVING后面的字符串,也是要與合計函數一起使用的。
參數String orderBy對應SQL語句ORDER BY后面的字符串。
參數limit指明返回的rows的數量。
我們下面舉個例子,假設有如下數據表,表名"Orders":
| Id | CustomerName | OrderPrice | Country | OrderDate |
| 1 | Arc | 100 | China | 2010/1/2 |
| 2 | Bor | 200 | USA | 2010/3/20 |
| 3 | Cut | 500 | Japan | 2010/2/20 |
| 4 | Bor | 300 | USA | 2010/3/2 |
| 5 | Arc | 600 | China | 2010/3/25 |
| 6 | Doom | 200 | China | 2010/3/26 |
假設我們想查詢客戶總的訂單數在500元以上的,且County在中國的客戶的名稱和訂單總數,且按照CustomerName來排序,默認ASC排序,那么SQL語句應當是:
- SELECT CustomerName, SUM (OrderPrice) FROM Orders WHERE Country=?
- GROUP BY CustomerName
- HAVING SUM (OrderPrice)>500
- ORDER BY CustomerName
那么對應Android的query函數的參數如下:
- String table = "Orders" ;
- String[] columns = new String[] { "CustomerName" , "SUM(OrderPrice)" };
- String selection = "Country=?" ;
- String[] selectionArgs = new String[]{ "China" };
- String groupBy = "CustomerName" ;
- String having = "SUM(OrderPrice)>500" ;
- String orderBy = "CustomerName" ;
- Cursor c = db.query(table, columns, selection, selectionArgs, groupBy, having, orderBy, null);
查詢的結果應該是:
| CustomerName | SUM(OrderPrice) |
| Arc | 700 |

