Riepilogo dell'API dei parametri con valori di tabella ODBC

Si applica a: SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di strumenti analitici (PDW)

ODBC supporta parametri a valori di tabella (parametri a valori di tabella) attraverso miglioramenti di diverse funzioni API esistenti. Queste funzioni lavorano insieme per descrivere schemi di parametri a valori di tabella, associare e trasmettere set di righe, recuperare metadati e gestire i record dei descrittori.
Le sezioni seguenti organizzano le funzioni ODBC rilevanti in gruppi logici per aiutarti a comprendere come funziona ogni parte della pipeline di parametri a valori di tabella.

Scoperta di schemi di parametri a valori di tabella e funzioni di metadati

Queste funzioni consentono a un'applicazione di individuare la struttura dei parametri con valori di tabella, inclusi i metadati della colonna, le definizioni dei parametri e i tipi di dati SQL disponibili.

Funzione Scopo
SQLColumns Recupera i metadati delle colonne per un parametro o un tipo di tabella
SQLDescribeParam Restituisce metadati per un parametro a valore di tabella, inclusi tipo, precisione e scala
SQLGetTypeInfo Recupera i tipi di dati SQL supportati dal driver per colonne di parametri a valori di tabella
SQLPrimaryKeys Fornisce informazioni sulle colonne chiave nei tipi di tabella utilizzati con parametri a valore di tabella
SQLProcedureColumns Recupera metadati per parametri di stored procedure correlati a parametri di tabella
SQLTables Elenca tabelle e tipi di tabelle disponibili come fonti per dichiarazioni di parametri a valori di tabella

Binding dei parametri a valori di tabella e trasmissione dei dati

Queste funzioni gestiscono l'associazione di dati strutturati ai parametri, il passaggio dei dati al server o lo streaming di righe durante l'esecuzione.

Funzione Scopo
SQLBindParameter Associa un parametro con valori di tabella a un buffer dell'applicazione o a un set di righe
SQLParamData Recupera la parte successiva di un parametro a valori di tabella streamlati quando si utilizza data-at-execution
SQLPutData Invia dati dei parametri a valori di tabella in blocchi durante le operazioni di esecuzione dei dati

Esecuzione delle istruzioni per parametri a valori di tabella

Queste funzioni eseguono istruzioni SQL che fanno riferimento a parametri a valori di tabella e gestiscono il ciclo di vita dell'esecuzione.

Funzione Scopo
SQLExecDirect Esegue un'istruzione SQL che utilizza parametri a valori di tabella senza prepararla prima
SQLExecute Esegue un'istruzione SQL precedentemente preparata che include parametri a valori di tabella

Gestione dei descrittori e attributi per parametri a valori di tabella

Usare queste funzioni per gestire i campi del descrittore e gli attributi delle istruzioni necessari per descrivere correttamente i set di righe e i parametri strutturati.

Funzione Scopo
SQLGetDescField Recupera metadati dei descrittori per colonne di parametri a valori di tabella o set di righe
SQLSetDescField Metadati dei descrittori per colonne di parametri a valore di tabella o set di righe
SQLSetDescRec Imposta un record descrittore completo per dati di parametri strutturati a valori di tabella
SQLGetStmtAttr Recupera attributi delle istruzioni che influenzano il comportamento di esecuzione dei parametri a valori di tabella
SQLSetStmtAttr Imposta attributi di istruzioni come dimensioni di righe o flag di streaming per operazioni con parametri a valori di tabella

Diagnostica e gestione degli errori per parametri a valori di tabella

Usa queste funzioni per aiutare le tue applicazioni a rilevare errori, avvisi o messaggi di stato durante il binding e l'esecuzione dei parametri a valori di tabella.

Funzione Scopo
SQLGetDiagField Recupera le informazioni diagnostiche generate durante l'elaborazione dei parametri a valori di tabella

Contenuti correlati

  • Last updated on