直接執行語句 （ODBC）

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （PDW）

直接執行語句，並只執行一次

1. 如果語句具有參數標記，請使用 SQLBindParameter 將每個參數係結至程式變數。 使用數據值填入程式變數，然後設定任何執行中數據參數。

2. 呼叫 SQLExecDirect 以執行 語句。

3. 如果使用數據執行時輸入參數， SQLExecDirect 會傳回SQL_NEED_DATA。 使用 SQLParamData 和 SQLPutData 以區塊傳送數據。

使用數據行參數係結多次執行語句

1. 呼叫 SQLSetStmtAttr 以設定下列屬性：

   將SQL_ATTR_PARAMSET_SIZE設定為參數集數（S）。

   將 [SQL_ATTR_PARAM_BIND_TYPE] 設定為 [SQL_PARAMETER_BIND_BY_COLUMN]。

   將 SQL_ATTR_PARAMS_PROCESSED_PTR 屬性設定為指向 SQLUINTEGER 變數，以保存已處理的參數數目。

   將SQL_ATTR_PARAMS_STATUS_PTR設定為指向 SQLUSSMALLINT 變數的陣列[S]，以保存參數狀態指標。

2. 針對每個參數標記：

   配置 S 參數緩衝區陣列來儲存資料值。

   配置 S 參數緩衝區陣列來儲存資料長度。

   呼叫 SQLBindParameter ，將參數數據值和數據長度陣列系結至語句參數。

   設定任何執行時的數據文字或影像參數。

   將 S 數據值和 S 數據長度放入系結的參數數位中。

3. 呼叫 SQLExecDirect 以執行 語句。 驅動程式會有效率地針對每個參數集執行語句 S 次。

4. 如果使用數據執行時輸入參數， SQLExecDirect 會傳回SQL_NEED_DATA。 使用 SQLParamData 和 SQLPutData 以區塊傳送數據。

使用數據列參數系結多次執行語句

1. 配置結構的陣列[S]，其中 S 是參數集的數目。 結構具有每個參數的一個元素，而每個元素都有兩個部分：

   第一個部分是適當數據類型的變數，用來保存參數數據。

   第二個部分是用來保存狀態指示器的 SQLINTEGER 變數。

2. 呼叫 SQLSetStmtAttr 以設定下列屬性：

   將SQL_ATTR_PARAMSET_SIZE設定為參數集數（S）。

   將SQL_ATTR_PARAM_BIND_TYPE設定為步驟 1 中所配置之結構的大小。

   將 SQL_ATTR_PARAMS_PROCESSED_PTR 屬性設定為指向 SQLUINTEGER 變數，以保存已處理的參數數目。

   將SQL_ATTR_PARAMS_STATUS_PTR設定為指向 SQLUSSMALLINT 變數的陣列[S]，以保存參數狀態指標。

3. 針對每個參數標記，呼叫 SQLBindParameter ，將參數的數據值和數據長度指標指向其在步驟 1 中配置之結構數位的第一個元素中的變數。 如果參數是數據執行中參數，請加以設定。

4. 使用數據值填入係結參數緩衝區陣列。

5. 呼叫 SQLExecDirect 以執行 語句。 驅動程式會有效率地針對每個參數集執行語句 S 次。

6. 如果使用數據執行時輸入參數， SQLExecDirect 會傳回SQL_NEED_DATA。 使用 SQLParamData 和 SQLPutData 以區塊傳送數據。

注意 數據行和數據列式系結通常與 SQLPrepare 函式和 SQLExecute 搭配使用，而不是與 SQLExecDirect 搭配使用。

另請參閱

執行查詢操作說明主題 （ODBC）