Compartilhar via

Testar a conectividade do OLE DB com o SQL Server usando um arquivo UDL

Aplica-se a: SQL Server

Observação

Antes de iniciar a solução de problemas, verifique os pré-requisitos e percorra a lista de verificação.

Este artigo descreve como criar um arquivo UDL (Universal Data Link) e usar provedores diferentes para testar a conexão com uma instância do SQL Server por meio do arquivo.

Criar um arquivo UDL

Observação

Um arquivo UDL permite testar a conectividade dos provedores OLE DB (Object Linking and Embedding Database) com qualquer banco de dados back-end independente de um aplicativo completo. Salvar um arquivo UDL gera uma cadeia de conexão bem formada, que você pode usar para ajudar a criar a cadeia de conexão de um aplicativo ou verificar como definir propriedades diferentes. Para obter a string, abra o arquivo no Bloco de Notas.

Para criar um arquivo UDL para testar seu provedor OLE DB, siga estas etapas:

  1. Para mostrar extensões de arquivo no Explorador de Arquivos, siga estas etapas:

    1. Selecione Iniciar e insira Opções do Explorador de Arquivos.

    2. Selecione a guia Exibir, desmarque a opção Ocultar extensões para tipos de arquivo conhecidos e selecione OK.

  2. Navegue até a pasta onde deseja criar um arquivo UDL. Por exemplo, C:\temp.

  3. Crie um novo arquivo de texto (como sqlconn.txt) e renomeie a extensão de .txt para .udl. (Selecione Sim para a mensagem de aviso sobre como alterar a extensão do nome do arquivo.)

    Você também pode usar o script do PowerShell a seguir para criar sqlconn.udl em sua pasta %temp%.

    clear
$ServerName = "(local)"
$UDL_String = "[oledb]`r`n; Everything after this line is an OLE DB initstring`r`nProvider=MSOLEDBSQL.1;Integrated Security=SSPI;Persist Security Info=False;User ID=`"`";Initial Catalog=`"`";Data Source=" + $ServerName + ";Initial File Name=`"`";Server SPN=`"`";Authentication=`"`";Access Token=`"`""
Set-Content -Path ($env:temp + "\sqlconn.udl") -Value $UDL_String -Encoding Unicode

#open the UDL
Invoke-Expression ($env:temp + "\sqlconn.udl")

Testar a conexão usando o driver OLE DB do SQL Server

O Microsoft OLE DB Driver for SQL Server (MSOLEDBSQL) é o driver OLE DB mais recente do SQL Server. O driver tem novos recursos, como TLS 1.2 e 1.3, MultiSubnetFailover e métodos de autenticação do Azure (Microsoft Entra ID). Recomendamos esse driver para bancos de dados mais recentes do SQL Server.

O Provedor do Microsoft OLE DB para SQL Server (SQLOLEDB) é o provedor de conectividade OLE DB herdado. Ele é integrado ao Windows e pode se conectar a qualquer versão do SQL Server que não esteja configurada para exigir associações de canal TLS 1.2 ou 1.3.

Para testar a conexão usando o driver do Microsoft OLE DB ou o provedor do SQL Server, siga estas etapas:

  1. Abra o arquivo UDL.

  2. Selecione a guia Provedor , selecione o driver ou provedor OLE DB que você usa em seu aplicativo e selecione Avançar.

  3. Na guia Conexão , especifique o protocolo de rede, o FQDN (nome de domínio totalmente qualificado) e o número da porta em Selecionar ou insira um nome de servidor. Por exemplo, tcp:SQLProd01.contoso.com,1433.

    Observação

    Essa maneira de inserir o nome do servidor e a porta evita problemas comuns (como problemas de serviço do SQL Server Browser) que podem interferir em uma conexão.

  4. Insira outras propriedades na guia Conexão .

    Observação

    A maioria dos testes de conexão não exige que você insira um nome de banco de dados.

  5. Selecione Testar Conexão.

Você também pode selecionar outras guias e explorar outras configurações do driver. Quando o teste de conexão for concluído, selecione OK para salvar a cadeia de conexão em um arquivo.

Testar a conexão usando o Microsoft OLE DB Provider for ODBC Drivers

Para testar drivers ODBC (Open Database Connectivity) usando o Microsoft OLE DB Provider for ODBC Drivers, siga estas etapas:

  1. Abra o arquivo UDL.

  2. Selecione >>ODBC em seguida.

  3. Na guia Conexão , você pode usar um dos métodos a seguir para especificar a origem dos dados e, em seguida, inserir outras propriedades.

    • Insira um valor no campo Usar nome da fonte de dados.

    • Insira uma cadeia de conexão sem DSN, como Driver={ODBC Driver 17 for SQL Server};Server=SQLProd01;Database=Northwind;Trusted_Connection=Yes.

  4. Selecione Testar Conexão.

Testar provedores de 32 bits em computadores de 64 bits

Para testar a conexão de provedores de 32 bits em sistemas operacionais de 64 bits, siga estas etapas:

  1. Na janela do prompt de comando, execute o seguinte comando para abrir o prompt de comando de 32 bits:

    %windir%\SysWoW64\cmd.exe

  2. Execute o seguinte comando para abrir o arquivo UDL:

    C:\temp\test.udl

  3. Se você vir o Provedor OLE DB do Microsoft Jet 4.0 na guia Provedor, você carregou com sucesso a interface de 32 bits e agora pode escolher o provedor de 32 bits para testar a conexão.

Iniciar um arquivo UDL

Clique duas vezes em um arquivo UDL para iniciá-lo. A seguir, descreve o processo subjacente usado ao iniciar um arquivo UDL.

A interface do usuário do arquivo UDL é fornecida por OLEDB32.DLL e hospedada em RUNDLL32.EXE.

  • Para sistemas operacionais de 32 bits ou para provedores de 64 bits em sistemas operacionais de 64 bits, use o seguinte comando (assumindo C:\temp\test.udl):

    Rundll32.exe "C:\Program Files\Common Files\System\OLE DB\oledb32.dll",OpenDSLFile C:\temp\test.udl

  • Para provedores de 32 bits em sistemas operacionais de 64 bits, use o seguinte comando:

    C:\Windows\SysWOW64\Rundll32.exe "C:\Program Files (x86)\Common Files\system\Ole DB\oledb32.dll",OpenDSLFile C:\temp\test.udl

A extensão de arquivo .udl é mapeada para o primeiro comando. Para provedores de 32 bits em sistemas operacionais de 64 bits, você pode simplificar as coisas executando um prompt de comando de 32 bits e, em seguida, executando START C:\TEMP\TEST.UDL para testar provedores de 32 bits. Opcionalmente, você pode criar um mapeamento de extensão de arquivo que usa o comando de 32 bits.

Criar um mapeamento de extensão de arquivo UDL32 de 32 bits

Se você usa frequentemente provedores de 32 bits em sistemas operacionais de 64 bits, pode mapear uma nova extensão de arquivo (por exemplo, .udl32) para iniciar a caixa de diálogo UDL de 32 bits usando as etapas a seguir.

Importante

Esta seção, método ou tarefa contém etapas que informam como modificar o registro. No entanto, problemas graves poderão ocorrer se você modificar o registro incorretamente. Portanto, certifique-se de seguir estas etapas com cuidado. Para maior proteção, faça backup do Registro antes de modificar, para poder restaurar se ocorrer um problema. Para obter mais informações sobre como fazer backup e restaurar o registro, consulte Como fazer backup e restaurar o registro no Windows.

  1. Copie o script a seguir para o Bloco de Notas e salve-o como udl32.reg.

    Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\.UDL32]
@="ft000001"

[HKEY_CLASSES_ROOT\ft000001]
@="Microsoft Data Link 32"
"BrowserFlags"=dword:00000008
"EditFlags"=dword:00000000

[HKEY_CLASSES_ROOT\ft000001\shell]
@="open"

[HKEY_CLASSES_ROOT\ft000001\shell\open]

[HKEY_CLASSES_ROOT\ft000001\shell\open\command]
@="C:\\Windows\\SysWOW64\\Rundll32.exe \"C:\\Program Files (x86)\\Common Files\\system\\Ole DB\\oledb32.dll\",OpenDSLFile %1"

[HKEY_CLASSES_ROOT\ft000001\shell\open\ddeexec]

  2. Clique duas vezes no arquivo .reg para criar uma chave do Registro, o que ajuda você a iniciar automaticamente arquivos UDL32.

  3. Crie um arquivo com a extensão .udl32. Por exemplo, C:\temp\test.udl32.

  4. Clique duas vezes no test.udl32 para iniciar a caixa de diálogo UDL de 32 bits. Por exemplo, você pode ver uma caixa de diálogo como esta:

    A captura de tela mostra um exemplo de uma caixa de diálogo UDL de 32 bits.

Dicas para solucionar problemas de conexão

Você pode usar os métodos a seguir para verificar por que a conexão falha.

  • Altere o provedor.
  • Altere o protocolo. Por exemplo, tcp:, np: ou lpc:.
  • Teste a conexão com ou sem o sufixo de domínio completo ou apenas com o endereço IP.
  • Remova o número da porta e use o nome da instância para testar o serviço Navegador do SQL Server.

Para cada um dos métodos acima, se uma combinação funcionar e outra falhar, isso pode dar uma pista sobre o problema. Por exemplo, quando você usa o segundo método, se o lpc: funciona e o tcp: não funciona, tente habilitar o protocolo TCP no SQL Server Configuration Manager.

Confira também

Configuração do Universal Data Link (UDL)

Observação

Se este artigo não resolver o problema, você poderá verificar se há mais ajuda para solucionar problemas de conectividade no SQL Server .

  • Last updated on