SQLSetConnectAttr

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

De SQL Server Native Client ODBC-driver negeert de instelling van SQL_ATTR_CONNECTION_TIMEOUT.

SQL_ATTR_TRANSLATE_LIB wordt ook genegeerd; Het specificeren van een andere vertaalbibliotheek wordt niet ondersteund. Om applicaties gemakkelijk te laten porten naar een Microsoft ODBC-driver voor SQL Server, wordt elke waarde die met SQL_ATTR_TRANSLATE_LIB is ingesteld gekopieerd in en uit een buffer in de Driver Manager.

De SQL Server Native Client ODBC-driver implementeert herhaalbare leestransactie-isolatie als serialiseerbaar.

SQL Server 2005 (9.x) introduceerde ondersteuning voor een nieuw transactieisolatie-attribuut, SQL_COPT_SS_TXN_ISOLATION. Het instellen van SQL_COPT_SS_TXN_ISOLATION op SQL_TXN_SS_SNAPSHOT geeft aan dat de transactie plaatsvindt onder het snapshot-isolatieniveau.

Het promoten van ODBC-statementattributen naar verbindingsattributen kan onbedoelde gevolgen hebben. Statementattributen die servercursors aanvragen voor resultaatsetverwerking kunnen worden gepromoot naar de verbinding. Bijvoorbeeld, het instellen van het ODBC-statement-attribuut SQL_ATTR_CONCURRENCY op een waarde die restrictiever is dan de standaard SQL_CONCUR_READ_ONLY stuurt de driver om dynamische cursors te gebruiken voor alle statements die op de verbinding worden verzonden. Het uitvoeren van een ODBC-catalogusfunctie op een instructie op de verbinding levert SQL_SUCCESS_WITH_INFO en een diagnostisch record terug dat aangeeft dat het cursorgedrag is gewijzigd naar alleen-lezen. Het uitvoeren van een Transact-SQL SELECT-instructie met een COMPUTE-clausule op dezelfde verbinding mislukt.

De SQL Server Native Client ODBC-driver ondersteunt een aantal driver-specifieke extensies op ODBC-verbindingsattributen die zijn gedefinieerd in sqlncli.h. De SQL Server Native Client ODBC-driver kan vereisen dat het attribuut vóór de verbinding wordt ingesteld, of het attribuut kan negeren als het al is ingesteld. De volgende tabel geeft een overzicht van beperkingen.

Het gebruik van een pre-connection attribuut en het equivalente Transact-SQL commando voor dezelfde sessie, database of SQL Server toestand kan onverwacht gedrag veroorzaken. Bijvoorbeeld:

SQLSetConnectAttr(SQL_COPT_SS_QUOTED_IDENT, SQL_QI_ON) // turn ON via attribute  
SQLDriverConnect(...);  
SQLExecDirect("SET QUOTED_IDENTIFIER OFF") // turn OFF via Transact-SQL  
SQLSetConnectAttr(SQL_ATTR_CURRENT_CATALOG, ...) // restores to pre-connect attribute value  

SQL_COPT_SS_ANSI_NPW

SQL_COPT_SS_ANSI_NPW maakt het gebruik van ISO-verwerking van NULL mogelijk of schakelt uit bij vergelijkingen en concatenatie, opvulling van tekengegevenstypes en waarschuwingen. Voor meer informatie, zie SETSET ANSI_NULLS,SET ANSI_PADDINGSET , SETSET ANSI_WARNINGS, en .SETSET CONCAT_NULL_YIELDS_NULL

Als je connection pooling gebruikt, zou SQL_COPT_SS_ANSI_NPW in de verbindingsreeks moeten worden ingesteld, in plaats van met SQLSetConnectAttr. Nadat een verbinding is gemaakt, zal elke poging om dit attribuut te wijzigen geruisloos mislukken wanneer verbindingspooling wordt gebruikt.

SQL_COPT_SS_APPLICATION_INTENT

Declareert het workloadtype van de toepassing bij het maken van verbinding met een server. Mogelijke waarden zijn Readonly en ReadWrite. Voorbeeld:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_APPLICATION_INTENT, TEXT("Readonly"), SQL_NTS)  

De standaard is ReadWrite. Voor meer informatie over de ondersteuning van SQL Server Native Client voor Always On beschikbaarheidsgroepen AG's, zie SQL Server Native Client Support for High Availability, Disaster Recovery.

SQL_COPT_SS_ATTACHDBFILENAME

SQL_COPT_SS_ATTACHDBFILENAME specificeert de naam van het primaire bestand van een bijgevoegde database. Deze database wordt aangesloten en wordt de standaarddatabase voor de verbinding. Om SQL_COPT_SS_ATTACHDBFILENAME te gebruiken moet je de naam van de database specificeren als de waarde van het verbindingsattribuut SQL_ATTR_CURRENT_CATALOG of in de DATABASE =-parameter van een SQLDriverConnect. Als de database eerder was aangesloten, zal SQL Server deze niet opnieuw aansluiten.

SQL_COPT_SS_BCP

SQL_COPT_SS_BCP maakt bulk-kopieerfuncties op een verbinding mogelijk. Voor meer informatie, zie Bulk Copy Functions.

SQL_COPT_SS_BROWSE_CONNECT

Dit attribuut wordt gebruikt om de resultaatset die door SQLBrowseConnect wordt geretourneerd aan te passen. SQL_COPT_SS_BROWSE_CONNECT maakt het retourneren van aanvullende informatie uit een opgesomde instantie van SQL Server mogelijk of schakelt uit. Dit kan informatie omvatten zoals of de server een cluster is, namen van verschillende instanties en het versienummer.

SQL_COPT_SS_BROWSE_SERVER

Dit attribuut wordt gebruikt om de resultaatset die door SQLBrowseConnect wordt geretourneerd aan te passen. SQL_COPT_SS_BROWSE_SERVER specificeert de servernaam waarvoor SQLBrowseConnect de informatie teruggeeft.

SQL_COPT_SS_CONCAT_NULL

SQL_COPT_SS_CONCAT_NULL maakt het gebruik van ISO-behandeling van NULL mogelijk of schakelt uit bij het aaneenvoegen van strings. Zie SET CONCAT_NULL_YIELDS_NULL voor meer informatie.

SQL_COPT_SS_ENCRYPT

Hiermee bepaalt u versleuteling voor een verbinding.

Versleuteling gebruikt het certificaat op de server. Dit moet worden geverifieerd door een certificaatautoriteit, tenzij het verbindingsattribuut SQL_COPT_SS_TRUST_SERVER_CERTIFICATE is ingesteld op SQL_TRUST_SERVER_CERTIFICATE_YES of de verbindingsreeks "TrustServerCertificate=yes" bevat. Als een van deze voorwaarden waar is, kan een certificaat dat door de server is gegenereerd en ondertekend worden gebruikt om de verbinding te versleutelen als er geen certificaat op de server staat.

SQL_COPT_SS_ENLIST_IN_DTC

De client roept de Microsoft Distributed Transaction Coordinator (MS DTC) OLE DB ITransactionDispenser::BeginTransaction-methode aan om een MS DTC-transactie te starten en een MS DTC-transactieobject te creëren dat de transactie vertegenwoordigt. De applicatie roept vervolgens SQLSetConnectAttr aan met de SQL_COPT_SS_ENLIST_IN_DTC optie om het transactieobject aan de ODBC-verbinding te koppelen. Alle gerelateerde databaseactiviteiten worden uitgevoerd onder de bescherming van de MS DTC-transactie. De applicatie roept SQLSetConnectAttr aan met SQL_DTC_DONE om de DTC-associatie van de verbinding te beëindigen.

SQL_COPT_SS_ENLIST_IN_XA

Om een XA-transactie te starten met een XA-conforme Transaction Processor (TP), roept de client de Open Group tx_begin functie aan. De applicatie roept vervolgens SQLSetConnectAttr aan met een SQL_COPT_SS_ENLIST_IN_XA parameter TRUE om de XA-transactie te koppelen aan de ODBC-verbinding. Alle gerelateerde databaseactiviteiten zullen worden uitgevoerd onder de bescherming van de XA-transactie. Om een XA-associatie met een ODBC-verbinding te beëindigen, moet de client SQLSetConnectAttr aanroepen met een SQL_COPT_SS_ENLIST_IN_XA parameter FALSE. Voor meer informatie, zie de documentatie van de Microsoft Distributed Transaction Coordinator.

SQL_COPT_SS_FALLBACK_CONNECT

Deze eigenschap wordt niet langer ondersteund.

SQL_COPT_SS_FAILOVER_PARTNER

Wordt gebruikt om de naam van de failoverpartner die wordt gebruikt voor databasespiegeling in SQL Server te specificeren of op te halen, en het is een null-terminated tekenreeks die moet worden ingesteld voordat de verbinding met SQL Server aanvankelijk wordt gemaakt.

Na het maken van de verbinding kan de applicatie dit attribuut opvragen met SQLGetConnectAttr om de identiteit van de failoverpartner te bepalen. Als de primaire server geen failoverpartner heeft, geeft deze eigenschap een lege string terug. Dit stelt een slimme applicatie in staat om de meest recent vastgestelde back-upserver te cachen, maar dergelijke applicaties moeten ervan bewust zijn dat de informatie pas wordt bijgewerkt wanneer de verbinding net tot stand komt, of wordt gereset, als ze worden gepoold, en verouderd kunnen raken voor langdurige verbindingen.

Voor meer informatie, zie Databasespiegeling gebruiken.

SQL_COPT_SS_INTEGRATED_SECURITY

SQL_COPT_SS_INTEGRATED_SECURITY dwingt het gebruik van Windows Authentication af voor toegangsvalidatie bij serverinlog. Wanneer Windows-authenticatie wordt gebruikt, negeert de driver gebruikersidentificatie en wachtwoordwaarden die worden geleverd als onderdeel van SQLConnect, SQLDriverConnect of SQLBrowseConnect.

SQL_COPT_SS_MARS_ENABLED

Dit attribuut schakelt meerdere actieve resultaatsets (MARS) in of uit. Standaard is MARS uitgeschakeld. Dit attribuut moet worden ingesteld voordat je verbinding maakt met SQL Server. Zodra de verbinding SQL Server is geopend, blijft MARS ingeschakeld of uitgeschakeld gedurende de hele levensduur van de verbinding.

Voor meer informatie over MARS, zie Gebruik van meerdere actieve resultaatsets (MARS).

SQL_COPT_SS_MULTISUBNET_FAILOVER

Als je applicatie verbinding maakt met een Always On availability groups availability group (AG) op verschillende subnetten, configureert deze verbindingseigenschap de SQL Server Native Client om snellere detectie en verbinding met de (huidige) actieve server te bieden. Voorbeeld:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_MULTISUBNET_FAILOVER, SQL_IS_ON, SQL_IS_INTEGER)  

Voor meer informatie over de ondersteuning van SQL Server Native Client voor Always On beschikbaarheidsgroepen AG's, zie SQL Server Native Client Support for High Availability, Disaster Recovery.

SQL_COPT_SS_OLDPWD

Wachtwoordvervaldatum voor SQL Server-authenticatie werd geïntroduceerd in SQL Server 2005 (9.x). Het attribuut SQL_COPT_SS_OLDPWD is toegevoegd zodat de client zowel het oude als het nieuwe wachtwoord voor de verbinding kan opgeven. Wanneer deze eigenschap is ingesteld, zal de provider de verbindingspool niet gebruiken voor de eerste verbinding of voor latere verbindingen, omdat de verbindingsreeks het "oude wachtwoord" bevat dat nu is veranderd.

Voor meer informatie, zie Wachtwoorden programmatisch wijzigen.

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA start of stopt prestatiedatalogging. De naam van het datalogbestand moet worden ingesteld voordat de datalogging wordt gestart. Zie SQL_COPT_SS_PERF_DATA_LOG hieronder.

Voor meer informatie, zie SQLGetConnectAttr.

SQL_COPT_SS_PERF_DATA_LOG

SQL_COPT_SS_PERF_DATA_LOG wijst de naam toe van het logbestand dat wordt gebruikt om prestatiegegevens vast te leggen. De naam van het logbestand is een ANSI- of Unicode-sequentie, een null-terminated string afhankelijk van de compilatie van de applicatie. Het StringLength-argument zou SQL_NTS moeten zijn.

SQL_COPT_SS_PERF_DATA_LOG_NOW

SQL_COPT_SS_PERF_DATA_LOG_NOW instrueert de driver om een statistische logboekvermelding naar de schijf te schrijven. Het StringLength-argument zou SQL_NTS moeten zijn.

SQL_COPT_SS_PERF_QUERY

SQL_COPT_SS_PERF_QUERY start of stopt logging voor langlopende zoekopdrachten. De naam van het querylogbestand moet worden opgegeven voordat het loggen begint. De applicatie kan "lang lopen" definiëren door het interval voor logging in te stellen.

Voor meer informatie, zie SQLGetConnectAttr.

SQL_COPT_SS_PERF_QUERY_INTERVAL

SQL_COPT_SS_PERF_QUERY_INTERVAL stelt de drempel voor querylogging in milliseconden. Queries die niet binnen de drempel worden opgelost, worden vastgelegd in het langlopende querylogbestand. Er is geen bovengrens voor de querydrempel. Een querydrempel van nul veroorzaakt logging van alle query's.

SQL_COPT_SS_PERF_QUERY_LOG

SQL_COPT_SS_PERF_QUERY_LOG wijst de naam toe aan een logbestand voor het vastleggen van langlopende querygegevens. De naam van het logbestand is een ANSI- of Unicode-sequentie, een null-terminated string afhankelijk van de compilatie van de applicatie. Het StringLength-argument moet SQL_NTS zijn, oftewel de lengte van de string in bytes.

SQL_COPT_SS_PRESERVE_CURSORS

Dit attribuut stelt je in staat om te vragen en in te stellen of de verbinding de cursor(s) bewaart wanneer je een transactie commit/rollbackt. De setting is ofwel SQL_PC_ON of SQL_PC_OFF. De standaardwaarde is SQL_PC_OFF. Deze instelling bepaalt of de driver de cursor(s) voor je sluit wanneer je SQLEndTran (of SQLTransact) aanroept.

SQL_COPT_SS_QUOTED_IDENT

SQL_COPT_SS_QUOTED_IDENT staat geciteerde identificaties in ODBC toe en Transact-SQL verklaringen die op de verbinding worden ingediend. Door aangehaalde identificaties te geven, maakt de SQL Server Native Client ODBC-driver anders ongeldige objectnamen mogelijk, zoals "My Table", die een spatie-teken in de identifier bevat. Zie SET QUOTED_IDENTIFIER voor meer informatie.

SQL_COPT_SS_TRANSLATE

SQL_COPT_SS_TRANSLATE zorgt ervoor dat de driver tekens vertaalt tussen de client- en servercodepagina's terwijl MBCS-gegevens worden uitgewisseld. Het attribuut beïnvloedt alleen gegevens die zijn opgeslagen in SQL Server-, varchar- en tekstkolommen.

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE zorgt ervoor dat de driver certificaatvalidatie in- of uitschakelt bij het gebruik van encryptie. Dit attribuut is een lees-/schrijfwaarde, maar het instellen ervan nadat een verbinding is tot stand gekomen heeft geen effect.

Clientapplicaties kunnen deze eigenschap opvragen nadat een verbinding is geopend om de daadwerkelijke versleutelings- en validatie-instellingen te bepalen.

SQL_COPT_SS_TXN_ISOLATION

SQL_COPT_SS_TXN_ISOLATION stelt het SQL Server specifieke snapshot-isolatieattribuut in. Snapshot-isolatie kan niet worden ingesteld met SQL_ATTR_TXN_ISOLATION omdat de waarde SQL Server specifiek is. Het kan echter worden teruggevonden met zowel SQL_ATTR_TXN_ISOLATION als SQL_COPT_SS_TXN_ISOLATION.

Voor meer informatie over snapshot-isolatie, zie Werken met snapshot-isolatie.

SQL_COPT_SS_USE_PROC_FOR_PREP

Deze eigenschap wordt niet langer ondersteund.

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA stelt de gebruikersdatapointer in. Gebruikersgegevens zijn client-eigendom geheugen dat per verbinding wordt geregistreerd.

Voor meer informatie, zie SQLGetConnectAttr.

SQL_COPT_SS_WARN_ON_CP_ERROR

Deze eigenschap bepaalt of je een waarschuwing krijgt als er dataverlies is tijdens een codepageconversie. Dit geldt alleen voor data die van de server komt.

SQLSetConnectAttr ondersteuning voor Service Principal Namen (SPN's)

SQLSetConnectAttr kan worden gebruikt om de waarde van de nieuwe verbindingsattributen SQL_COPT_SS_SERVER_SPN en SQL_COPT_SS_FAILOVER_PARTNER_SPN in te stellen. Deze attributen kunnen niet worden ingesteld wanneer een verbinding open is; als je probeert deze attributen in te stellen wanneer een verbinding open is, wordt foutmelding HY011 teruggegeven met het bericht "Operatie ongeldig op dit moment". (SQLSetConnectOption kan ook worden gebruikt om deze waarden in te stellen.)

Voor meer informatie over SPN's, zie Service Principal Names (SPN's) in Client Connections (ODBC).

SQL_COPT_SS_CONNECTION_DEAD

Dit is een alleen-lezen attribuut.

Voor meer informatie over SQL_COPT_SS_CONNECTION_DEAD, zie SQLGetConnectAttr en Connecting to a Data Source (ODBC).

Example

Dit voorbeeld registreert prestatiegegevens.

SQLPERF*     pSQLPERF;  
SQLINTEGER   nValue;  
  
// See if you are already logging. SQLPERF* will be NULL if not.  
SQLGetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA, &pSQLPERF,  
    sizeof(SQLPERF*), &nValue);  
  
if (pSQLPERF == NULL)  
    {  
    // Set the performance log file name.  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG,  
        (SQLPOINTER) "\\My LogDirectory\\MyServerLog.txt", SQL_NTS);  
  
    // Start logging...  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,  
        (SQLPOINTER) SQL_PERF_START, SQL_IS_INTEGER);  
    }  
else  
    {  
    // Take a snapshot now so that your performance statistics are discernible.  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
    }  
  
    // ...perform some action...  
  
// ...take a performance data snapshot...  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
  
    // ...perform more actions...  
  
// ...take another snapshot...  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
  
// ...and disable logging.  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,  
    (SQLPOINTER) SQL_PERF_STOP, SQL_IS_INTEGER);  
  
// Continue on...  

Zie ook

SQLSetConnectAttr-functie
Details van ODBC-API-implementatie
Bulkkopieerfuncties
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
SET CONCAT_NULL_YIELDS_NULL (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
SQLPrepare, functie
SQLGetInfo