Partilhar via


SQLBrowseConnect

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

O 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 No 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 não conectada em 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 Sim Nome do banco de dados SQL Server.
LANGUAGE Sim Sim Idioma nacional usado pelo SQL Server.

O 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 o 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.

Veja a seguir 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, o 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 AlwaysOn, consulte Suporte ao SQL Server Native Client para alta disponibilidade, recuperação de desastre.

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 para o método de autenticação usado para abrir a conexão.

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

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