Отправка данных в виде возвращающего табличное значение параметра со всеми значениями в памяти (ODBC)

Применимо к: SQL Server Azure SQL DatabaseУправляемый экземпляр SQL AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)

В этом разделе описывается передача данных хранимой процедуре в виде возвращающего табличное значение параметра, когда все значения хранятся в памяти. Другой пример, демонстрирующий возвращающие табличное значение параметры, см. в разделе Использование Table-Valued параметров (ODBC).

Предварительное требование

В этой процедуре предполагается, что на сервере был выполнен следующий код Transact-SQL:

CREATE type TVParam AS TABLE (
    ProdCode INT,
    Qty INT
)

CREATE PROCEDURE TVPOrderEntry (
    @CustCode VARCHAR(5),
    @Items TVPParam,
    @OrdNo INT OUTPUT,
    @OrdDate DATETIME OUTPUT
)
AS
SET @OrdDate = GETDATE();

INSERT INTO TVPOrd (OrdDate, CustCode)
VALUES (@OrdDate, @CustCode)
OUTPUT OrdNo;

SELECT @OrdNo = SCOPE_IDENTITY();

INSERT INTO TVPItem (OrdNo, ProdCode, Qty)
SELECT @OrdNo, @Items.ProdCode, @Items.Qty FROM @Items;

Отправка данных

1. Объявление переменных для параметров SQL. В данном случае табличное значение полностью содержится в памяти, поэтому значения для столбцов этого табличного значения объявляются как массивы.

   SQLRETURN r;  
   // Variables for SQL parameters.  
   #define ITEM_ARRAY_SIZE 20  
   
   SQLCHAR CustCode[6];  
   SQLCHAR *TVP = (SQLCHAR *) "TVParam";  
   SQLINTEGER ProdCode[ITEM_ARRAY_SIZE], Qty[ITEM_ARRAY_SIZE];  
   SQLINTEGER OrdNo;  
   char OrdDate[23];  
   
   // Variables for indicator/length variables associated with parameters.  
   SQLLEN cbCustCode, cbTVP, cbProdCode[ITEM_ARRAY_SIZE], cbQty[ITEM_ARRAY_SIZE], cbOrdNo, cbOrdDate;  
   

2. Выполните привязку параметров. При использовании возвращающих табличное значение параметров процесс привязки параметров состоит из двух этапов. На первом этапе параметры шагов для хранимой процедуры привязываются обычным путем, как показано ниже.

   // Bind parameters for call to TVPOrderEntryDirect.  
   // 1 - Custcode input  
   r = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT,SQL_VARCHAR, SQL_C_CHAR, 5, 0, CustCode, sizeof(CustCode), &cbCustCode);  
   
   // 2 - Items TVP  
   r = SQLBindParameter(hstmt,   
       2,// ParameterNumber  
       SQL_PARAM_INPUT,// InputOutputType  
       SQL_C_DEFAULT,// ValueType   
       SQL_SS_TABLE,// Parametertype  
       ITEM_ARRAY_SIZE,// ColumnSize: For a table-valued parameter this is the row array size.  
       0,// DecimalDigits: For a table-valued parameter this is always 0.   
       TVP,// ParameterValuePtr: For a table-valued parameter this is the type name of the   
   //table-valued parameter, and also a token returned by SQLParamData.  
       SQL_NTS,// BufferLength: For a table-valued parameter this is the length of the type name or SQL_NTS.  
       &cbTVP);// StrLen_or_IndPtr: For a table-valued parameter this is the number of rows actually used.  
   
   // 3 - OrdNo output  
   r = SQLBindParameter(hstmt, 3, SQL_PARAM_OUTPUT,SQL_INTEGER, SQL_C_LONG, 0, 0, &OrdNo,  
      sizeof(SQLINTEGER), &cbOrdNo);  
   // 4 - OrdDate output  
   r = SQLBindParameter(hstmt, 4, SQL_PARAM_OUTPUT,SQL_TYPE_TIMESTAMP, SQL_C_CHAR, 23, 3, &OrdDate,   
      sizeof(OrdDate), &cbOrdDate);  
   

3. Второй этап процесса привязки параметра состоит в связывании столбцов для возвращающего табличное значение параметра. Первоначально фокус устанавливается на порядковом номере возвращающего табличное значение параметра. Затем столбцы значения таблицы привязываются с помощью SQLBindParameter так же, как если бы они были параметрами хранимой процедуры, но с порядком столбцов для ParameterNumber. Если бы имелось большее число возвращающих табличное значение параметров, мы бы по очереди передавали фокус каждому из них и связывали их столбцы. В заключение фокус параметра сбрасывается в 0.

   // Bind columns for the table-valued parameter (param 2).  
   // First set focus on param 2.  
   r = SQLSetStmtAttr(hstmt, SQL_SOPT_SS_PARAM_FOCUS, (SQLPOINTER) 2, SQL_IS_INTEGER);  
   
   // Col 1 - ProdCode  
   r = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT,SQL_INTEGER, SQL_C_LONG, 0, 0, ProdCode, sizeof(SQLINTEGER), cbProdCode);  
   // Col 2 - Qty  
   r = SQLBindParameter(hstmt, 2, SQL_PARAM_INPUT,SQL_INTEGER, SQL_C_LONG, 0, 0, Qty, sizeof(SQLINTEGER), cbQty);  
   
   // Reset param focus.  
   r = SQLSetStmtAttr(hstmt, SQL_SOPT_SS_PARAM_FOCUS, (SQLPOINTER) 0, SQL_IS_INTEGER);  
   

4. Заполните буферы параметров. В качестве значения cbTVP указывается число строк, которые должны быть переданы на сервер.

   // Populate parameters.  
   cbTVP = 0; // Number of rows available for input.  
   strcpy_s((char *) CustCode, sizeof(CustCode), "CUST1"); cbCustCode = SQL_NTS;  
   
   ProdCode[cbTVP] = 1215;cbProdCode[cbTVP] = sizeof(SQLINTEGER);   
   Qty[cbTVP] = 5;cbQty[cbTVP] = sizeof(SQLINTEGER);   
   cbTVP++; // Number of rows available for input  
   
   ProdCode[cbTVP] = 1017;cbProdCode[cbTVP] = sizeof(SQLINTEGER);   
   Qty[cbTVP] = 2;cbQty[cbTVP] = sizeof(SQLINTEGER);   
   cbTVP++; // Number of rows available for input.  
   

5. Вызовите процедуру:

   // Call the procedure.  
   r = SQLExecDirect(hstmt, (SQLCHAR *) "{call TVPOrderEntry(?, ?, ?, ?)}",SQL_NTS);  
   

См. также:

Примеры программирования с использованием возвращающих табличное значение параметров ODBC