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

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

В этом разделе описывается передача данных хранимой процедуре в виде возвращающего табличное значение параметра, когда все значения хранятся в памяти. В другом примере, демонстрирующем табличное значение параметров, см. раздел "Использование параметров с табличным значением" (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