Enviando dados como um parâmetro Table-Valued com todos os valores na memória (ODBC)

Este tópico descreve como enviar dados para um procedimento armazenado como um parâmetro com valor de tabela quando todos os valores estão na memória. Para outro exemplo que demonstra parâmetros com valor de tabela, consulte Use Table-Valued Parameters (ODBC).

Pré-requisito

Este procedimento pressupõe que o seguinte Transact-SQL foi executado no servidor:

create type TVParam as table(ProdCode integer, Qty integer)  
create procedure TVPOrderEntry(@CustCode varchar(5), @Items TVPParam,   
            @OrdNo integer 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  

Para enviar os dados

1. Declare variáveis para os parâmetros SQL. Nesse caso, o valor da tabela é mantido inteiramente na memória, portanto, os valores das colunas do valor da tabela são declarados como matrizes.

   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. Associe os parâmetros. Parâmetros de associação são um processo de dois estágios quando parâmetros com valor de tabela são usados. No primeiro estágio, os parâmetros de etapa para o procedimento armazenado são associados da maneira normal, da seguinte maneira.

   // 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. O segundo estágio da associação de parâmetro é associar as colunas para o parâmetro com valor de tabela. O foco do parâmetro é definido primeiro como o ordinal do parâmetro com valor de tabela. Em seguida, as colunas do valor da tabela são associadas usando SQLBindParameter da mesma maneira que seriam se fossem parâmetros do procedimento armazenado, mas com ordinais de coluna para ParameterNumber. Se houvesse mais parâmetros com valor de tabela, definiríamos o foco para cada um por sua vez e associaremos suas colunas. Por fim, o foco do parâmetro é redefinido para 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. Preencha os buffers de parâmetro. cbTVP é definido como o número de linhas a serem enviadas ao servidor.

   // 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. Chame o procedimento:

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

Consulte Também

Exemplos de programação de parâmetro de Table-Valued ODBC