SQLBrowseConnect
Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
SQLBrowse Verbinden verwendet Schlüsselwort (keyword), die in drei Ebenen von Verbindungsinformationen kategorisiert werden können. In der folgenden Tabelle wird für jedes Schlüsselwort angegeben, ob eine Liste gültiger Werte zurückgegeben wird und ob das Schlüsselwort optional ist.
Level 1
Stichwort | Liste zurückgegeben? | Optional? | Beschreibung |
---|---|---|---|
DSN | N/V | Nein | Name der von SQLDataSources zurückgegebenen Datenquelle. Das DSN-Schlüsselwort kann nicht verwendet werden, wenn das DRIVER-Schlüsselwort verwendet wird. |
DRIVER | N/V | Nein | Sql Server Native Client ODBC-Treibername ist {SQL Server Native Client 11}. Das DRIVER-Schlüsselwort kann nicht verwendet werden, wenn das DSN-Schlüsselwort verwendet wird. |
Level 2
Stichwort | Liste zurückgegeben? | Optional? | Beschreibung |
---|---|---|---|
SERVER | Ja | Nein | Name des Servers in dem Netzwerk, auf dem die Datenquelle gespeichert ist. Der Begriff "(local)" kann als Server eingegeben werden, in diesem Fall kann eine lokale Kopie von SQL Server verwendet werden, auch wenn es sich um eine nicht vernetzte Version handelt. |
UID | Nein | Ja | Benutzeranmelde-ID. |
PWD | Nein | Ja (vom Benutzer abhängig) | Vom Benutzer angegebenes Kennwort. |
APP | Nein | Ja | Name der Anwendung, die SQLBrowse Verbinden aufruft. |
WSID | Nein | Ja | Workstation-ID. Dies ist normalerweise der Netzwerkname des Computers, auf dem die Anwendung ausgeführt wird. |
Level 3
Stichwort | Liste zurückgegeben? | Optional? | Beschreibung |
---|---|---|---|
DATABASE | Ja | Ja | Name der SQL Server-Datenbank. |
LANGUAGE | Ja | Ja | Die von SQL Server verwendete Nationale Sprache. |
SQLBrowse Verbinden ignoriert die Werte der DATENBANK- und LANGUAGE-Schlüsselwort (keyword), die in den ODBC-Datenquellendefinitionen gespeichert sind. Wenn die in der Verbindungszeichenfolge an SQLBrowse übergebene Datenbank oder Sprache ungültig ist Verbinden,gibt SQLBrowse Verbinden SQL_NEED_DATA und die Verbindungsattribute der Ebene 3 zurück.
Die folgenden Attribute, die durch Aufrufen von SQLSet Verbinden Attr festgelegt werden, bestimmen das von SQLBrowse Verbinden zurückgegebene Resultset.
attribute | BESCHREIBUNG |
---|---|
SQL_COPT_SS_BROWSE_CONNECT | Wenn sie auf SQL_MORE_INFO_YES festgelegt ist, gibt SQLBrowse Verbinden eine erweiterte Zeichenfolge von Servereigenschaften zurück. Im Folgenden sehen Sie ein Beispiel für eine erweiterte Zeichenfolge, die von SQLBrowse zurückgegeben wird Verbinden: ServerName\InstanceName;Clustered:No;Version:8.00.131 In dieser Zeichenfolge werden verschiedene durch Semikolons getrennte Informationen zum Server aufgeführt. Informationen zu verschiedenen Serverinstanzen werden durch Kommas getrennt. |
SQL_COPT_SS_BROWSE_SERVER | Wenn ein Servername angegeben ist, gibt SQLBrowse Verbinden Informationen für den angegebenen Server zurück. Wenn SQL_COPT_SS_BROWSE_SERVER auf NULL festgelegt ist, gibt SQLBrowse Verbinden Informationen für alle Server in der Do Standard zurück. Beachten Sie, dass aufgrund von Netzwerkproblemen sqlBrowse Verbinden möglicherweise keine zeitnahe Antwort von allen Servern erhalten. Daher kann die Liste der zurückgegebenen Server bei jeder Anforderung unterschiedlich sein. |
SQL_COPT_SS_BROWSE_CACHE_DATA | Wenn die Pufferlänge nicht groß genug ist, um das Ergebnis aufzunehmen, können Sie das Attribut SQL_COPT_SS_BROWSE_CACHE_DATA auf SQL_CACHE_DATA_YES festlegen und Daten in Abschnitten abrufen. Diese Länge wird im Argument BufferLength in SQLBrowse Verbinden angegeben. Wenn weitere Daten verfügbar sind, wird SQL_NEED_DATA zurückgegeben. Wenn keine weiteren Daten abrufbar sind, wird SQL_SUCCESS zurückgegeben. Der Standardwert ist SQL_CACHE_DATA_NO. |
SQLBrowseConnect-Unterstützung für hohe Verfügbarkeit, Wiederherstellung im Notfall
Weitere Informationen zur Verwendung von SQLBrowse Verbinden zum Herstellen einer Verbindung mit einem AlwaysOn-Verfügbarkeitsgruppencluster finden Sie unter SQL Server Native Client Support for High Availability, Disaster Recovery.
SQLBrowseConnect-Unterstützung für Dienstprinzipalnamen (Service Principal Names, SPNs)
Wenn eine Verbindung geöffnet wird, legt SQL Server Native Client SQL_COPT_SS_MUTUALLY_AUTHENTICATED und SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD auf die Authentifizierungsmethode fest, die zum Öffnen der Verbindung verwendet wird.
Weitere Informationen zu SPNs finden Sie unter Service Principal Names (SPNs) in Client Verbinden ions (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Verbinden ions (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Verbinden ions (ODBC).
Änderungsverlauf
Aktualisierter Inhalt |
---|
Dokumentierte SQL_COPT_SS_BROWSE_CACHE_DATA. |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für