SQLBrowseConnect

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

SQLBrowseConnect usa palavras-chave que podem ser categorizadas em três níveis de informações de conexão. Para cada palavra-chave, a tabela a seguir indica se uma lista de valores válidos é retornada e se a palavra-chave é opcional.

Nível 1

Palavra-chave	Lista retornada?	Opcional?	Descrição
DSN	N/D	Não	Nome da fonte de dados retornada por SQLDataSources. A palavra-chave DSN não poderá ser usada se a palavra-chave DRIVER for usada.
DRIVER	N/D	Não	O nome do driver ODBC do SQL Server Native Client é {SQL Server Native Client 11}. A palavra-chave DRIVER não pode ser usada se a palavra-chave DSN for usada.

Nível 2

Palavra-chave	Lista retornada?	Opcional?	Descrição
SERVER	Sim	Não	O nome do servidor na rede onde a fonte de dados reside. O termo "(local)" pode ser inserido como o servidor, caso em que uma cópia local do SQL Server pode ser usada, mesmo quando esta é uma versão sem rede.
UID	Não	Sim	ID de logon do usuário.
PWD	Não	Sim (depende do usuário)	Senha especificada pelo usuário.
APP	Não	Sim	Nome do aplicativo que chama SQLBrowseConnect.
WSID	Não	Sim	ID da estação de trabalho. Normalmente, é o nome de rede do computador no qual o aplicativo é executado.

Nível 3

Palavra-chave	Lista retornada?	Opcional?	Descrição
DATABASE	Sim	Yes	Nome do banco de dados do SQL Server.
LANGUAGE	Sim	Yes	Idioma nacional usado pelo SQL Server.

SQLBrowseConnect ignora os valores das palavras-chave DATABASE e LANGUAGE armazenadas nas definições de fonte de dados ODBC. Se o banco de dados ou idioma especificado na cadeia de conexão passada para SQLBrowseConnect for inválido, SQLBrowseConnect retornará SQL_NEED_DATA e os atributos de conexão de nível 3.

Os atributos a seguir, que são definidos chamando SQLSetConnectAttr, determinam o conjunto de resultados retornado por SQLBrowseConnect.

Atributo	Descrição
SQL_COPT_SS_BROWSE_CONNECT	Se estiver definido como SQL_MORE_INFO_YES, SQLBrowseConnect retornará uma cadeia de caracteres estendida de propriedades do servidor. A seguir está um exemplo de uma cadeia de caracteres estendida retornada por SQLBrowseConnect: ServerName\InstanceName;Clustered:No;Version:8.00.131 Nessa cadeia de caracteres, ponto-e-vírgulas separam várias partes das informações sobre o servidor. Use vírgulas para separar diferentes instâncias do servidor.
SQL_COPT_SS_BROWSE_SERVER	Se um nome de servidor for especificado, SQLBrowseConnect retornará informações para o servidor especificado. Se SQL_COPT_SS_BROWSE_SERVER estiver definido como NULL, SQLBrowseConnect retornará informações para todos os servidores no domínio. Observe que, devido a problemas de rede, o SQLBrowseConnect pode não receber uma resposta oportuna de todos os servidores. Portanto, a lista de servidores retornada pode variar para cada solicitação.
SQL_COPT_SS_BROWSE_CACHE_DATA	Quando o atributo SQL_COPT_SS_BROWSE_CACHE_DATA é definido como SQL_CACHE_DATA_YES, você pode buscar dados em partes quando o comprimento do buffer não é grande o suficiente para manter o resultado. Esse comprimento é especificado no argumento BufferLength para SQLBrowseConnect. SQL_NEED_DATA é retornado quando mais dados estiverem disponíveis. SQL_SUCCESS é retornado quando não há mais dados a serem recuperados. O padrão é SQL_CACHE_DATA_NO.

Suporte de SQLBrowseConnect a alta disponibilidade e recuperação de desastre

Para obter mais informações sobre como usar o SQLBrowseConnect para se conectar a um cluster de grupos de disponibilidade Always On, consulte Suporte do SQL Server Native Client para alta disponibilidade, recuperação de desastres.

Suporte de SQLBrowseConnect a SPNs (nomes de entidade de serviço)

Quando uma conexão é aberta, o SQL Server Native Client define SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ao método de autenticação usado para abrir a conexão.

Para obter mais informações sobre SPNs, consulte Nomes de entidade de serviço (SPNs) em conexões de cliente (ODBC).

Histórico de alterações

Conteúdo atualizado
SQL_COPT_SS_BROWSE_CACHE_DATA documentado.

Confira também

Função SQLBrowseConnect
Detalhes da implementação da API do ODBC