SQLBrowseConnect

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

SQLBrowse Connecter utilise des mot clé qui peuvent être classées en trois niveaux d’informations de connexion. Pour chaque mot clé, le tableau suivant indique si une liste de valeurs valides est retournée et si le mot clé est facultatif.

Niveau 1

Mot clé	Liste retournée ?	Facultatif ?	Description
DSN	S/O	Non	Nom de la source de données retournée par SQLDataSources. Le mot clé DSN ne peut pas être utilisé si le mot clé DRIVER est utilisé.
DRIVER	S/O	Non	Le nom du pilote ODBC SQL Server Native Client est {SQL Server Native Client 11}. Le mot clé DRIVER ne peut pas être utilisé si le mot clé DSN est utilisé.

Niveau 2

Mot clé	Liste retournée ?	Facultatif ?	Description
SERVER	Oui	Non	Nom du serveur sur le réseau sur lequel la source de données réside. Le terme « (local) » peut être entré en tant que serveur, auquel cas une copie locale de SQL Server peut être utilisée, même lorsqu’il s’agit d’une version non réseau.
Identificateur d’utilisateur	Non	Oui	ID de connexion d'utilisateur.
PWD	Non	Oui (dépend de l'utilisateur)	Mot de passe spécifié par l'utilisateur.
APP	Non	Oui	Nom de l’application appelant SQLBrowse Connecter.
WSID	Non	Oui	ID de station de travail. En général, il s'agit du nom réseau de l'ordinateur sur lequel l'application s'exécute.

Niveau 3

Mot clé	Liste retournée ?	Facultatif ?	Description
DATABASE	Oui	Oui	Nom de la base de données SQL Server.
LANGUAGE	Oui	Oui	Langage national utilisé par SQL Server.

SQLBrowse Connecter ignore les valeurs des mot clé DATABASE et LANGUAGE stockées dans les définitions de source de données ODBC. Si la base de données ou le langage spécifié dans le chaîne de connexion passé à SQLBrowse Connecter n’est pas valide, SQLBrowse Connecter retourne SQL_NEED_DATA et les attributs de connexion de niveau 3.

Les attributs suivants, qui sont définis en appelant SQLSet Connecter Attr, déterminent le jeu de résultats retourné par SQLBrowse Connecter.

Attribut	Description
SQL_COPT_SS_BROWSE_CONNECT	S’il est défini sur SQL_MORE_INFO_YES, SQLBrowse Connecter retourne une chaîne étendue de propriétés du serveur. Voici un exemple de chaîne étendue retournée par SQLBrowse Connecter : ServerName\InstanceName;Clustered:No;Version:8.00.131 Dans cette chaîne, des points-virgules séparent les différentes parties des informations sur le serveur. Utilisez des virgules pour séparer les différentes instances de serveur.
SQL_COPT_SS_BROWSE_SERVER	Si un nom de serveur est spécifié, SQLBrowse Connecter retourne des informations pour le serveur spécifié. Si SQL_COPT_SS_BROWSE_SERVER a la valeur NULL, SQLBrowse Connecter retourne des informations pour tous les serveurs du domaine. Notez qu’en raison de problèmes réseau, SQLBrowse Connecter peut ne pas recevoir de réponse en temps voulu de tous les serveurs. Par conséquent, la liste des serveurs retournée peut varier pour chaque requête.
SQL_COPT_SS_BROWSE_CACHE_DATA	Lorsque l'attribut SQL_COPT_SS_BROWSE_CACHE_DATA a la valeur SQL_CACHE_DATA_YES, vous pouvez extraire les données en plusieurs segments lorsque la longueur de la mémoire tampon est insuffisante pour contenir le résultat. Cette longueur est spécifiée dans l’argument BufferLength à SQLBrowse Connecter. La valeur SQL_NEED_DATA est retournée lorsque davantage de données sont disponibles. La valeur SQL_SUCCESS est retournée lorsqu'il n'existe plus de données à récupérer. La valeur par défaut est SQL_CACHE_DATA_NO.

Prise en charge par SQLBrowseConnect des fonctionnalités de récupération d'urgence, haute disponibilité

Pour plus d’informations sur l’utilisation de SQLBrowse Connecter pour vous connecter à un cluster de groupes de disponibilité Always On, consultez prise en charge de SQL Server Native Client pour la haute disponibilité, reprise d’activité après sinistre.

Prise en charge par SQLBrowseConnect des noms de principaux du service (SPN)

Lorsqu’une connexion est ouverte, SQL Server Native Client définit SQL_COPT_SS_MUTUALLY_AUTHENTICATED et SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD à la méthode d’authentification utilisée pour ouvrir la connexion.

Pour plus d’informations sur les noms de principal de service, consultez Les noms de principal de service (SPN) dans les Connecter ions du client (ODBC).

Historique des modifications

Mise à jour du contenu
SQL_COPT_SS_BROWSE_CACHE_DATA documenté.

Voir aussi

SQLBrowseConnect, fonction
Détails de l’implémentation d’API ODBC