Allokera ett anslutningshandtag

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Innan applikationen kan ansluta till en datakälla eller drivrutin måste den tilldela ett anslutningshandtag. Detta görs genom att anropa SQLAllocHandle med parametern HandleType inställd på SQL_HANDLE_DBC och InputHandle pekar på ett initierat miljöhandtag.

Egenskaperna hos anslutningen styrs genom att sätta anslutningsattribut. Eftersom transaktioner till exempel sker på anslutningsnivå är transaktionsisoleringsnivån ett anslutningsattribut. På liknande sätt är inloggningstimeout, eller antalet sekunder att vänta medan man försöker ansluta innan timeout, en anslutningsattribut.

Anslutningsattribut sätts med SQLSetConnectAttr, och deras nuvarande inställningar hämtas med SQLGetConnectAttr. Om SQLSetConnectAttr anropas innan en anslutning försöks, lagrar ODBC Driver Manager attributen i sin anslutningsstruktur och sätter dem i drivrutinen som en del av anslutningsprocessen. Vissa anslutningsattribut måste ställas in innan applikationen försöker ansluta sig; andra kan ställas in efter att anslutningen har slutförts. Till exempel måste SQL_ATTR_ODBC_CURSORS sättas innan en anslutning görs, men SQL_ATTR_AUTOCOMMIT kan sättas efter anslutning.

Applikationer som körs mot SQL Server version 7.0 eller senare kan ibland förbättra sin prestanda genom att återställa paketstorleken på tabellardataströmmen (TDS). Standardpaketstorleken är inställd på servern till 4 KB. En paketstorlek på 4 KB till 8 KB ger generellt bäst prestanda. Om testning visar att det presterar bättre med en annan paketstorlek kan applikationen återställa paketstorleken. ODBC-applikationer kan göra detta innan de ansluter genom att anropa SQLSetConnectAttr med SQL_ATTR_PACKET_SIZE-alternativet. Vissa applikationer presterar bättre med större paketstorlek, men prestandaförbättringar är generellt minimala för paketstorlekar större än 8 KB.

SQL Server Native Client ODBC-drivrutinen har ett antal utökade anslutningsattribut som en applikation kan använda för att öka sin funktionalitet. Några av dessa attribut styr samma alternativ som kan specificeras i datakällor och användas för att åsidosätta det alternativ som är inställt i en datakälla. Till exempel, om en applikation använder citerade identifierare kan den sätta det drivrutinsspecifika attributet SQL_COPT_SS_QUOTED_IDENT till SQL_QI_ON för att säkerställa att detta alternativ alltid är inställt oavsett inställning i någon datakälla.