Zuordnen eines Verbindungshandles
Gilt für:
SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)
Bevor die Anwendung eine Verbindung mit einer Datenquelle oder einem Treiber herstellen kann, muss sie ein Verbindungshandle zuordnen. Dazu rufen Sie SQLAllocHandle mit dem HandleType-Parameter auf SQL_HANDLE_DBC und InputHandle auf ein initialisiertes Umgebungshandle-Handle auf.
Die Eigenschaften der Verbindung werden kontrolliert, indem Verbindungsattribute festgelegt werden. Da Transaktionen auf Verbindungsebene auftreten, handelt es sich bei der Transaktionsisolationsstufe beispielsweise um ein Verbindungsattribut. Um ein Verbindungsattribut handelt es sich entsprechend auch beim Anmeldungstimeout bzw. bei der Anzahl der Sekunden, die bei einem Verbindungsversuch bis zum Timeout verstreichen.
Verbindungsattribute werden mit SQLSetConnectAttr festgelegt, und ihre aktuellen Einstellungen werden mit SQLGetConnectAttr abgerufen. Wenn SQLSetConnectAttr aufgerufen wird, bevor eine Verbindung versucht wird, speichert der ODBC-Treiber-Manager die Attribute in der Verbindungsstruktur und legt sie im Treiber als Teil des Verbindungsvorgangs fest. Einige Verbindungsattribute müssen festgelegt werden, bevor die Anwendung einen Verbindungsversuch unternimmt. Andere hingegen können nach dem Herstellen der Verbindung festgelegt werden. SQL_ATTR_ODBC_CURSORS muss vor dem Herstellen einer Verbindung festgelegt werden, während SQL_ATTR_AUTOCOMMIT nach hergestellter Verbindung festgelegt werden kann.
Anwendungen, die mit SQL Server Version 7.0 oder höher ausgeführt werden, können manchmal ihre Leistung verbessern, indem sie die Größe des TDS-Netzwerkpakets (Tabular Data Stream) zurücksetzen. Die Standardpaketgröße wird auf dem Server festlegt und beträgt 4 Byte. Mit einer Paketgröße von 4 KB bis 8 KB wird im Allgemeinen die beste Leistung erzielt. Wenn sich beim Testen herausstellt, dass eine andere Paketgröße eine bessere Leistung erzielt, kann die Anwendung die Paketgröße neu festlegen. ODBC-Anwendungen können dies tun, bevor sie eine Verbindung herstellen, indem SIE SQLSetConnectAttr mit der Option SQL_ATTR_PACKET_SIZE aufrufen. Einige Anwendungen zeigen zwar mit einer größeren Paketgröße eine bessere Leistung, die Leistungsverbesserungen sind im Allgemeinen jedoch für Paketgrößen über 8 KB minimal.
Der ODBC-Treiber für SQL Server Native Client verfügt über eine Reihe erweiterter Verbindungsattribute, die eine Anwendung verwenden kann, um die Funktionalität zu erhöhen. Einige dieser Attribute steuern die gleichen Optionen, die in Datenquellen festgelegt und zum Überschreiben von Optionen in einer Datenquelle verwendet werden können. Wenn eine Anwendung beispielsweise Bezeichner in Anführungszeichen verwendet, kann sie das treiberspezifische Attribut SQL_COPT_SS_QUOTED_IDENT auf SQL_QI_ON festlegen, um sicherzustellen, dass diese Option unabhängig von der Einstellung in einer Datenquelle stets festgelegt ist.