Parametri con valori di tabella (ODBC)

Si applica a: SQL Server Azure SQL DatabaseIstanza gestita di SQL di AzureAzure Synapse Analytics AnalyticsPlatform System (PDW)

Il supporto ODBC dei parametri con valori di tabella consente a un'applicazione client di inviare più efficientemente i dati con parametri al server, inviando più righe al server con una sola chiamata.

Per informazioni sui parametri con valori di tabella nel server, vedere Usare parametri Table-Valued (motore di database).

In ODBC è possibile inviare parametri con valori di tabella al server in due modi:

• Tutti i dati dei parametri con valori di tabella possono essere in memoria al momento della chiamata a SQLExecDirect o SQLExecute. Se sono presenti più righe nel valore di tabella, i dati vengono archiviati in matrici.

• Un'applicazione può specificare dati in fase di esecuzione per un parametro con valori di tabella quando viene chiamato SQLExecDirect o SQLExecute. In tal caso, le righe di dati per il valore di tabella possono essere fornite in batch o uno alla volta per ridurre i requisiti di memoria.

La prima opzione consente alle stored procedure di incapsulare più logica di business. Ad esempio, una singola stored procedure può incapsulare un'intera transazione di immissione ordini se gli articoli dell'ordine vengono passati come parametro con valori di tabella. Questa opzione è molto efficiente poiché è necessario un solo round trip del server. In alternativa, è possibile utilizzare altre procedure per gestire separatamente l'intestazione degli ordini e gli articoli richiedendo più codice e un contratto più complesso tra il client e il server.

Il secondo metodo fornisce un meccanismo efficiente per le operazioni bulk con quantità elevate di dati consentendo a un'applicazione di trasmettere un flusso di righe di dati al server senza doverle prima memorizzare nel buffer.

È possibile creare vincoli e chiavi primarie durante la creazione della variabile di tabella. I vincoli rappresentano un ottimo metodo per assicurarsi che i dati di una tabella soddisfino requisiti specifici.

Contenuto della sezione

Utilizzi dei parametri con valori di tabella in ODBC
Vengono descritti gli scenari utente principali per i parametri con valori di tabella e ODBC.

Tipo SQL ODBC per parametri con valori di tabella
Viene descritto il tipo SQL_SS_TABLE. Si tratta di un nuovo tipo ODBC SQL che supporta i parametri con valori di tabella.

Campi di descrizione dei parametri con valori di tabella
Vengono descritti i campi di descrizione che supportano i parametri con valori di tabella.

Campi di descrizione per le colonne che costituiscono parametri con valori di tabella
Vengono descritti i campi di descrizione che hanno valenza per i parametri con valori di tabella.

Campi dei record di diagnostica dei parametri con valori di tabella
Vengono descritti i due campi di diagnostica aggiunti ai record di diagnostica per supportare i parametri con valori di tabella.

Attributi dell'istruzione che influiscono sui parametri con valori di tabella
Viene descritto un nuovo campo di intestazione di descrizione che consente l'indirizzamento delle colonne dei parametri con valori di tabella.

Associazione e trasferimento dati di valori di colonna e parametri con valori di tabella
Vengono descritti l'associazione dei parametri e il passaggio di un parametro con valori di tabella al server.

Metadati del parametro con valori di tabella per le istruzioni preparate
Viene descritto il modo in cui un'applicazione può ottenere i metadati per una chiamata alla procedura preparata.

Metadati aggiuntivi dei parametri con valori di tabella
Viene descritto come usare SQLProcedureColumns, SQLTables e SQLColumns per recuperare i metadati per un parametro con valori di tabella.

Conversione di dati dei parametri con valori di tabella e altri errori e avvisi
Viene descritta l'elaborazione degli errori nei valori delle colonne dei parametri con valori di tabella.

Compatibilità tra versioni
Vengono descritti i conflitti che possono verificarsi quando i parametri con valori di tabella vengono usati da un client o un server di una versione precedente a SQL Server 2008 (10.0.x).

Riepilogo delle API dei parametri con valori di tabella ODBC
Vengono descritte le funzioni ODBC che supportano i parametri con valori di tabella.

Vedere anche

SQL Server Native Client (ODBC)
Parametri con valori di tabella (SQL Server Native Client)