Senden von Daten als Table-Valued Parameter mit allen Werten im Arbeitsspeicher (ODBC)

In diesem Thema wird beschrieben, wie Daten als Tabellenwertparameter an eine gespeicherte Prozedur gesendet werden, wenn sich alle Werte im Arbeitsspeicher befinden. Ein weiteres Beispiel zur Veranschaulichung von Parametern mit Tabellenwerten finden Sie unter Verwenden von Table-Valued Parametern (ODBC).

Voraussetzung

Bei diesem Verfahren wird davon ausgegangen, dass die folgenden Transact-SQL auf dem Server ausgeführt wurden:

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  

So senden Sie die Daten

1. Deklarieren Sie Variablen für die SQL-Parameter. In diesem Fall wird der Tabellenwert vollständig im Arbeitsspeicher gespeichert, sodass Werte für die Spalten des Tabellenwerts als Arrays deklariert werden.

   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. Binden Sie die Parameter. Bindungsparameter sind ein zweistufiger Prozess, wenn Tabellenwertparameter verwendet werden. In der ersten Phase sind Schrittparameter für die gespeicherte Prozedur wie folgt normal gebunden.

   // 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. Die zweite Phase der Parameterbindung besteht darin, die Spalten für den Tabellenwertparameter zu binden. Der Parameterfokus wird zuerst auf die Ordnungszahl des Tabellenwertparameters festgelegt. Dann werden Spalten des Tabellenwerts mithilfe von SQLBindParameter auf die gleiche Weise gebunden wie bei Parametern der gespeicherten Prozedur, aber mit Spalten ordinalen für ParameterNumber. Wenn mehr Tabellenwertparameter vorhanden sind, würden wir den Fokus wiederum auf die einzelnen Parameter festlegen und deren Spalten binden. Schließlich wird der Parameterfokus auf 0 zurückgesetzt.

   // 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. Füllen Sie die Parameterpuffer auf. cbTVP wird auf die Anzahl der Zeilen festgelegt, die an den Server gesendet werden sollen.

   // 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. Rufen Sie die Prozedur auf:

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

Siehe auch

BEISPIELE für die ODBC-Table-Valued-Parameterprogrammierung