Een statement-handler toewijzen

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Voordat een applicatie een statement kan uitvoeren, moet het een statementhandle toewijzen. Dit gebeurt door SQLAllocHandle aan te roepen met de HandleType-parameter ingesteld op SQL_HANDLE_STMT en InputHandle die naar een verbindingshandle verwijst.

Statement-attributen zijn kenmerken van het statementhandvat. Voorbeeldattributen van een statement kunnen het gebruik van bladwijzers en het soort cursor zijn dat met de resultaatset van de statement wordt gebruikt. Statement-attributen worden ingesteld met SQLSetStmtAttr, en hun huidige instellingen worden opgehaald met behulp van SQLGetStmtAttr. Er is geen vereiste dat een applicatie statementattributen instelt; Alle statementattributen hebben standaardwaarden en sommige zijn driver-specifiek.

Wees voorzichtig bij het gebruik van verschillende ODBC-statements en verbindingsopties. Het aanroepen van SQLSetConnectAttr met fOption ingesteld op SQL_ATTR_LOGIN_TIMEOUT regelt de tijd waarin een applicatie wacht tot een verbindingspoging uitloopt tijdens het tot stand brengen van een verbinding (0 specificeert een oneindige wachttijd). Sites met trage responstijden kunnen deze waarde hoog instellen om ervoor te zorgen dat de verbindingen voldoende tijd hebben om af te ronden. Het interval moet echter altijd laag genoeg zijn om de gebruiker binnen een redelijke tijd een antwoord te geven als de driver geen verbinding kan maken.

Het aanroepen van SQLSetStmtAttr met fOption ingesteld op SQL_ATTR_QUERY_TIMEOUT stelt een query-time-out interval in om de server en de gebruiker te beschermen tegen langlopende zoekopdrachten.

Het aanroepen van SQLSetStmtAttr met fOption ingesteld op SQL_ATTR_MAX_LENGTH beperkt de hoeveelheid tekst - en afbeeldingsgegevens die een individuele statement kan ophalen. Het aanroepen van SQLSetStmtAttr met fOption ingesteld op SQL_ATTR_MAX_ROWS beperkt een rijset ook tot de eerste n rijen als dat alles is wat de applicatie vereist. Let op dat het instellen van SQL_ATTR_MAX_ROWS ervoor zorgt dat de driver een SET ROWCOUNT instructie aan de server afgeeft. Dit beïnvloedt alle Microsoft SQL Server-instructies, inclusief triggers en updates.

Wees voorzichtig bij het instellen van deze opties. Het is het beste als alle statementhandles op een connection handle dezelfde instellingen hebben voor SQL_ATTR_MAX_LENGTH en SQL_ATTR_MAX_ROWS. Als de driver wisselt van een instructiehandle naar een andere met andere waarden voor deze opties, moet de driver de juiste SETSET TEXTSIZE and-statements SETSET ROWCOUNT genereren om de instellingen te wijzigen. De driver kan deze statements niet in dezelfde batch plaatsen als de user SQL-instructie, omdat de user SQL-instructie een instructie kan bevatten die de eerste instructie in een batch moet zijn. De driver moet de SETSET TEXTSIZE and-statements SETSET ROWCOUNT in een aparte batch versturen, die automatisch een extra retour naar de server genereert.

Zie ook

Query's uitvoeren (ODBC)