Koppla från en datakälla

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

När ett program har slutförts med en datakälla anropas SQLDisconnect. SQLDisconnect frigör alla instruktioner som allokeras på anslutningen och kopplar bort drivrutinen från datakällan. Efter att ha kopplat bort kan applikationen anropa SQLFreeHandle för att frigöra anslutningshandtaget. Innan avslut anropar ett program även SQLFreeHandle för att frigöra miljöhandtaget.

Efter att ha kopplat bort kan en applikation återanvända det tilldelade anslutningshandtaget, antingen för att ansluta till en annan datakälla eller återansluta till samma datakälla. Beslutet att förbli ansluten istället för att koppla bort och ansluta igen senare kräver att ansökningsförfattaren tar hänsyn till de relativa kostnaderna för varje alternativ. Att ansluta till en datakälla och förbli uppkopplad kan vara relativt kostsamt, beroende på anslutningsmediet. Vid en avvägning måste applikationen också göra antaganden om sannolikheten och tidpunkten för ytterligare operationer på samma datakälla. En applikation kan också behöva använda mer än en anslutning.