Utilizzare un'istruzione (ODBC)
Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)
Per utilizzare un'istruzione
Chiamare SQLAllocHandle con HandleType impostato su SQL_HANDLE_STMT per allocare un handle di istruzione.
È inoltre possibile chiamare SQLSetStmtAttr per impostare le opzioni dell'istruzione o SQLGetStmtAttr per ottenere gli attributi dell'istruzione.
Per utilizzare i cursori server, è necessario impostare gli attributi del cursore su valori diversi da quelli predefiniti.
Facoltativamente, se l'istruzione viene eseguita più volte, è possibile preparare l'istruzione per l'esecuzione con la funzione SQLPrepare.
Se all'istruzione sono stati associati marcatori di parametro, è possibile associare i marcatori di parametro alle variabili di programma tramite SQLBindParameter. Se l'istruzione è stata preparata, è possibile chiamare SQLNumParams e SQLDescribeParam per trovare il numero e le caratteristiche dei parametri.
Eseguire un'istruzione direttamente mediante SQLExecDirect.
o
Se l'istruzione è stata preparata, eseguirla più volte tramite SQLExecute.
o
Chiamare una funzione di catalogo, che restituisce i risultati.
Elaborare i risultati associando le colonne del set di risultati alle variabili di programma, spostando i dati dalle colonne del set di risultati alle variabili di programma tramite SQLGetData oppure usando una combinazione dei due metodi.
Recuperare il set di risultati di un'istruzione una riga alla volta.
o
Recuperare il set di risultati più righe alla volta mediante un cursore a blocchi.
o
Chiamare SQLRowCount per determinare il numero di righe interessate da un'istruzione INSERT, UPDATE o DELETE.
Se l'istruzione SQL può avere più set di risultati, chiamare SQLMoreResults alla fine di ogni set di risultati per stabilire se siano presenti altri set di risultati da elaborare.
Dopo l'elaborazione dei risultati, può essere necessario effettuare le seguenti azioni per consentire all'handle di istruzione di eseguire una nuova istruzione:
Se SQLMoreResults non è stato chiamato fino a quando non sia stato restituito SQL_NO_DATA, chiamare SQLCloseCursor per chiudere il cursore.
Se i marcatori di parametro sono stati associati alle variabili di programma, chiamare SQLFreeStmt con Option impostato su SQL_RESET_PARAMS per liberare i parametri associati.
Se le colonne del set di risultati sono state associate alle variabili di programma, chiamare SQLFreeStmt con Option impostato su SQL_UNBIND per liberare le colonne associate.
Per riutilizzare l'handle di istruzione, andare al passaggio 2.
Chiamare SQLFreeHandle con HandleType impostato su SQL_HANDLE_STMT per liberare l'handle di istruzione.