Guia de solução de problemas do SSIS Projects para Visual Studio 2022+

Aplica-se a:SQL ServerBanco de Dados SQL do AzureAzure Synapse Analytics

Visite o blog do SSIS (SQL Server Integration Services) para obter as informações, dicas, notícias e comunicados mais recentes sobre o SSIS diretamente da equipe de produtos. As notas de versão da extensão dos Serviços de Integração (SSIS) estão listadas no Marketplace de extensões.

Download do componente

• Para projetar pacotes usando conectores Oracle e Teradata e direcionar uma versão anterior do SQL Server antes do SQL Server 2019 (15.x), além do Microsoft Oracle Connector e do Microsoft Teradata Connector, você também precisa instalar a versão correspondente do Microsoft Connector para Oracle e Teradata da Attunity.

  • Microsoft Connector versão 5.0 para Oracle e Teradata da Attunity direcionado ao SQL Server 2017
  • Microsoft Connector versão 4.0 para Oracle e Teradata da Attunity direcionado ao SQL Server 2016
  • Microsoft Connector versão 3.0 para Oracle e Teradata da Attunity direcionado ao SQL Server 2014
  • Microsoft Connector versão 2.0 para Oracle e Teradata da Attunity direcionado ao SQL Server 2012

• A partir da versão 3.3, a Fonte do Power Query para SQL Server 2017–2022 foi excluída da instalação deste produto. Para continuar usando este componente, baixe-o e instale-o manualmente. Acesse os seguintes links para download: Fonte do Power Query para SQL Server 2017 a 2022

Problemas comuns

• A Tarefa Executar Pacote do SSIS não dá suporte à depuração quando ExecuteOutOfProcess está definida como True.

• Ainda não há suporte para componentes de terceiros.

• Às vezes, esse produto ou as Ferramentas do Visual Studio para Aplicativos 2022 podem ser excluídos de alguma forma durante a atualização da instância do Visual Studio. Se os projetos existentes do SSIS não puderem ser carregados, tente reparar esse produto por meio do Painel de Controle. Se o Visual Studio não aparecer ao selecionar Editar Script, tente reparar o VSTA 2022 por meio do painel de controle.

• Problema lado a lado do SSDT. As extensões do SQL Server Analysis Services e do SQL Server Reporting Services agora podem funcionar lado a lado com essa extensão no Visual Studio 2022 17.4 e versões anteriores. A solução alternativa é baixar o Visual Studio 2022 17.5 Versão Prévia 2 ou posterior.

• O SQL Server Native Client (SNAC) não é fornecido com:

  • SQL Server 2022 (16.x) e versões posteriores
  • SQL Server Management Studio 19 e versões posteriores

  O SQL Server Native Client (SQLNCLI ou SQLNCLI11) e o provedor OLE DB para SQL Server (SQLOLEDB) da Microsoft herdado não são recomendados para desenvolver um novo aplicativo.

  Para novos projetos, use um dos seguintes drivers:

  • Driver ODBC da Microsoft para SQL Server
  • Driver do Microsoft OLE DB para SQL Server

  Para SQLNCLI que é fornecido como um componente do Mecanismo de Banco de Dados do SQL Server (versões 2012 a 2019), confira esta exceção de Ciclo de Vida de Suporte.

• Se o Oracle, o Teradata ou outro componente OOB não for encontrado após a atualização do SSDT, verifique se o conector para a versão mais recente do SQL Server está instalado.

Problemas conhecidos

1. No menu de contexto (botão direito do mouse) em objetos no projeto (por exemplo, a solução, um pacote) no Visual Studio, muitas das entradas aparecem muitas vezes.
2. Às vezes, quando você repara ou atualiza o Visual Studio, a extensão do SSIS pode ser desinstalada. Reinstale-o novamente.
3. Se o SSIS for instalado com êxito, mas o Gerenciador de Soluções mostrar incompatible, ou The application is not installed:
   1. Abrir o Visual Studio e navegar atéExtensões>Gerenciar Extensões>Instaladas
   2. Habilite a extensão do SSIS
   3. Reinicie o Visual Studio

Para obter mais informações, consulte as Notas de versão.

Problemas de instalação

O arquivo de log de instalação, Microsoft.DataTools.IntegrationServices_{Timestamp}_ISVsix.log, está localizado na pasta %temp%\SsdtisSetup. Verifique as mensagens de erro no arquivo de log e siga estas etapas de solução de problemas:

1. Verificação prévia de falha de AnotherInstallationRunning

   • Se o arquivo de log contiver palavras-chave: Pre-check verification failed with warning(s): AnotherInstallationRunning, continue aguardando e tente novamente.
   • Esse erro ocorre porque o Windows Installer bloqueia sua instalação. O Windows Installer é um subsserviço do Windows que gerencia a instalação de pacotes como MSIs, Windows Update ou um componente de terceiros e só pode lidar com uma coisa de cada vez.

2. Outros erros

   • Baixe VSInstallationTroubleShooting.ps1 e execute-o em seu computador para ajudar na solução de problemas.

Instalação offline

Siga as etapas abaixo para instalar este produto em um ambiente offline:

1. Veja as instruções descritas em Criar um pacote de instalação offline do Visual Studio para instalação local e verifique se os seguintes pré-requisitos estão incluídos:

   • Prerequisite ID="Microsoft.VisualStudio.Component.Roslyn.LanguageServices" Version="[17.0,)" DisplayName="C# and Visual Basic"
   • Prerequisite ID="Microsoft.VisualStudio.Component.CoreEditor" Version="[17.0,)" DisplayName="Visual Studio core editor"
   • Prerequisite ID="Microsoft.Net.Component.4.7.TargetingPack" Version="[17.0,)" DisplayName=".NET Framework 4.7 targeting pack"

2. Inicie o instalador desse produto e execute a instalação ou execute o instalador no modo silencioso. Inicie o instalador com o /? argumento para obter mais detalhes da lista de argumentos do instalador.

3. O Visual Studio Community não dá suporte à ativação offline. Para usar este produto com o Visual Studio Community, você deve entrar em sua conta da Microsoft ocasionalmente no Visual Studio Community. Se você quiser usar esse produto em um ambiente offline, recomendamos que você instale este produto no Visual Studio Professional ou Enterprise, que dá suporte à ativação offline por meio de uma chave do produto.