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 provedor OLE DB do SQL Server

O Microsoft OLE DB Provider for SQL Server (SQLOLEDB) é o provedor mais comum. 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.

O Microsoft OLE DB Driver for SQL Server (MSOLEDBSQL) é o provedor OLE DB mais recente do SQL Server. O provedor tem todos os novos recursos, como TLS 1.2, MultiSubnetFailover e opções de autenticação do Azure. Recomendamos esse provedor para bancos de dados SQL Server mais recentes.

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

  1. Abra o arquivo .udl .

  2. Selecione a guia Provedor , selecione o provedor OLE DB do SQL Server 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 evita alguns problemas comuns (como os problemas do serviço 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 Provedor>Microsoft OLE DB Provider para drivers>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 , isso significa que você carregou com êxito a caixa de diálogo de 32 bits e agora pode selecionar o provedor de 32 bits para testar a conexão.

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 tiver resolvido seu problema, você poderá verificar Solucionar problemas de conectividade no SQL Server para obter mais ajuda.