OS/400 版管理及程式設計指南

執行 SQL 陳述式

您可以執行動態 SQL 支援的任何 SQL 陳述式。

若要執行 SQL 陳述式，請定義一個函數，來使用 SQL (DTW_SQL) 語言環境，並在函數的語言環境可執行區段中含有 SQL 陳述式。

範例：執行 SQL SELECT 陳述式的 SQL 函數：

%function(DTW_SQL) getOrders() {
   SELECT cust, custid, custorder FROM mylibrary.customers
%}

確定控制

依據預設值，SQL 語言環境會在確定控制下執行，並遵循所有管理確定控制的規則。

• 登載所有透過 DTW_SQL 存取的檔案或表格，但當 SQL 陳述式為 SELECT 時除外。
• 您可經由在 Net.Data 起始設定檔案中設定 DTW_SQL_ISOLATION， 選擇是否要變更確定層次。請參閱"DTW_SQL_ISOLATION: DB2 隔離變數"， 取得關於 SQL 語言環境支援的隔離層次的詳細資訊

異動管理的詳細資訊，請參閱"管理 Net.Data 應用程式中的異動"。

OUT 及 INOUT 表格

如果您在函數定義上指定 OUT 或 INOUT Net.Data 表格， 且 SQL 陳述式傳回結果集合，則 SQL 語言環境會將每一結果集合儲存在指定的表格中。 然後，您可以在巨集中使用表格。如果未指定 OUT 表格，則 SQL 語言環境將使用預設表格。

巢狀 SQL 陳述式

您可以從另一個 SQL 函數的 ROW 區塊內呼叫其他 SQL 函數。 在每一 SQL 函數中使用唯一的 Net.Data 表格名稱，否則，可能會發生無法預期的結果。

範例：從另一個 SQL 函數的 ROW 區塊呼叫 SQL 函數

%define mytable1 = %TABLE
%define mytable2 = %TABLE
%FUNCTION(DTW_SQL) sql2 (IN p1, OUT t2) {
   select * from NETDATA.STAFFINF where projno='$(p1)'
%REPORT {
  %ROW { $(N1) is $(V1) %}
 %}
%}
%FUNCTION(DTW_SQL) sql1 (OUT t1) {
   select * from NETDATA.STAFFINF
%REPORT {
   %ROW { @sql2(V1, mytable2) %}
 %}
%}
%HTML(netcall1) { @sql1(mytable1) %}

支援的語言環境變數

SQL 語言環境支援為了支援 DB2 而設計的變數。 例如，DATABASE 變數指定當執行 SQL 陳述式時，SQL 語言環境將連接的資料來源。下列列示指定 SQL 語言環境支援的變數。 請參閱 Net.Data 參考手冊，取得這些變數的說明、語法及範例。

• DATABASE
• DB_CASE
• DTW_EDIT_CODES
• DTW_PAD_PGM_PARMS
• DTW_SET_TOTAL_ROWS
• LOGIN
• NULL_RPT_FIELD
• PASSWORD
• SHOWSQL
• SQL_STATE
• TRANSACTION_SCOPE

支援的資料類型

SQL 語言環境支援表 5中所示的資料類型

表 5. 資料類型

(1) 這些資料類型無法以參數形式傳遞到儲存程序。 若要瞭解儲存程序支援的資料類型，請參閱"儲存程序語法"

請參閱"資料類型注意事項"，瞭解 LOB 及 DATALINK 資料類型的特殊注意事項。

SQL 語言環境限制

當規劃您的環境時，請考慮下列限制：

• 若下列情況中至少有一個存在，請不要使用 SQL 語言環境：
  • 建立使用者定義的語言環境，它會使用資料庫存取類別程式庫或 SQL 呼叫層次介面， 以及在巨集中參照使用者定義的語言環境
  • 使用 SQL CLI 的應用程式將在 Net.Data 所在的同一處理中執行
• 列入陳述式區塊中的 SQL 陳述式最多可達到 32KB。
• 您最多可以使用 50 個區域或遠端資料庫連線。當使用多個連線， 請考慮下列限制：
  • Net.Data 不容許同一遠端資料庫有並行連線。
  • 如果 TRANSACTION_SCOPE=MULTIPLE (這是預設值)，則在存取了遠端資料庫後， 無法變更登入 ID。請參閱 "管理 Net.Data 應用程式中的異動"。

  請參閱"管理多個資料庫連線"，取得這些限制的詳細資訊。