Ferramentas de solução de problemas para desenvolvimento de pacotes

Aplica-se a: SQL Server SSIS Integration Runtime em Azure Data Factory

O Integration Services inclui funcionalidades e ferramentas que pode usar para diagnosticar pacotes enquanto os desenvolve no SQL Server Data Tools (SSDT).

Resolução de Problemas de Validação em Tempo de Conceção

Na versão atual dos Serviços de Integração, quando um pacote é aberto, o sistema valida todas as ligações antes de validar todos os componentes do fluxo de dados e define quaisquer ligações lentas ou indisponíveis para funcionar offline. Isto ajuda a reduzir o atraso na validação do fluxo de dados do pacote.

Depois de abrir um pacote, também pode desligar uma ligação clicando com o botão direito no gestor de conexões na área de Gerentes de Ligações e depois clicando em Trabalhar Offline. Isto pode acelerar as operações no SSIS Designer.

As ligações que foram configuradas para funcionar offline permanecerão offline até que faça uma das seguintes ações:

Teste a ligação clicando com o botão direito no gestor de ligações na área de Gerentes de Ligação do SSIS Designer e depois clicando em Testar Conectividade.

Por exemplo, uma ligação é inicialmente configurada para funcionar offline quando o pacote é aberto. Modifica a cadeia de ligação para resolver o problema e clica em Testar Conectividade para testar a ligação.
Reabra o pacote ou reabra o projeto que contém o pacote. A validação é executada novamente em todas as ligações do pacote.

O Integration Services inclui as seguintes funcionalidades adicionais para o ajudar a evitar erros de validação:

Defina todo o pacote e todas as ligações para funcionarem offline quando as fontes de dados não estiverem disponíveis. Pode ativar Trabalho Offline no menu SSIS. Ao contrário da propriedade DelayValidation , a opção Work Offline está disponível mesmo antes de abrir um pacote. Você também pode habilitar Trabalhar Offline para acelerar as operações no designer e desativá-lo somente quando quiser que seu pacote seja validado.
Configure a propriedade DelayValidation em elementos de pacote que não sejam válidos até ao momento da execução. Pode definir DelayValidation como True nos elementos do pacote cuja configuração não é válida durante a conceção, para evitar erros de validação. Por exemplo, pode ter uma tarefa Fluxo de Dados que utiliza uma tabela de destino que não existe até que uma tarefa Execute SQL crie a tabela em tempo de execução. A propriedade DelayValidation pode ser ativada ao nível do pacote, ou ao nível das tarefas e contentores individuais que o pacote inclui. Normalmente, deve deixar esta propriedade definida como True nos mesmos elementos do pacote quando implementa o pacote, para evitar os mesmos erros de validação em tempo de execução.

A propriedade DelayValidation pode ser definida numa tarefa de Fluxo de Dados, mas não em componentes individuais de data flow. Pode obter um efeito semelhante definindo a ValidateExternalMetadata propriedade dos componentes individuais do fluxo de dados como falsa. No entanto, quando o valor desta propriedade é falso, o componente não está ciente de alterações nos metadados das fontes de dados externas.

Se os objetos da base de dados usados pelo pacote forem bloqueados quando ocorre a validação, o processo de validação pode deixar de responder. Nestas circunstâncias, o Designer do SSIS também deixa de responder. Pode retomar a validação usando o Management Studio para fechar a sessão associada no SQL Server. Também pode evitar este problema usando as definições descritas nesta secção.

Resolução de Problemas do Fluxo de Controlo

O Integration Services inclui as seguintes funcionalidades e ferramentas que pode usar para diagnosticar o fluxo de controlo em pacotes durante o desenvolvimento de pacotes:

Defina pontos de interrupção nas tarefas, contentores e no pacote. Pode definir pontos de interrupção usando as ferramentas gráficas que o SSIS Designer fornece. Os pontos de interrupção podem ser ativados ao nível do pacote, ou ao nível das tarefas e contentores individuais que o pacote inclui. Algumas tarefas e contentores fornecem condições adicionais de pausa para definir pontos de interrupção. Por exemplo, pode ativar uma condição de quebra no contentor For Loop que suspende a execução no início de cada iteração do ciclo.
Utilize as janelas de depuração. Quando executa um pacote que tem pontos de interrupção, as janelas de depuração no SQL Server Data Tools (SSDT) dão acesso a valores variáveis e mensagens de estado.
Consulte a informação no separador Progresso. O SSIS Designer fornece informações adicionais sobre o fluxo de controlo quando executa um pacote no SQL Server Data Tools (SSDT). O separador Progresso lista tarefas e contentores por ordem de execução e inclui os tempos de início e fim, avisos e mensagens de erro para cada tarefa e contentor, incluindo o próprio pacote.

Para mais informações sobre estas funcionalidades, consulte Debugging Control Flow.

Resolução de Problemas do Fluxo de Dados

O Integration Services inclui as seguintes funcionalidades e ferramentas que pode usar para diagnosticar os fluxos de dados em pacotes durante o desenvolvimento de pacotes:

Teste apenas com um subconjunto dos seus dados. Se quiser resolver o problema do fluxo de dados num pacote usando apenas uma amostra do conjunto de dados, pode incluir uma transformação de Amostragem Percentual ou Amostragem por Linhas para criar uma amostra de dados em linha em tempo de execução. Para mais informações, consulte Transformação por Amostragem Percentual e Transformação por Amostragem por Filas.
Use visualizadores de dados para monitorizar os dados à medida que estes se movem pelo fluxo de dados. Os visualizadores de dados exibem os valores dos dados à medida que os dados se movem entre fontes, transformações e destinos. Um visualizador de dados pode mostrar dados numa grelha. Pode copiar os dados de um visualizador de dados para a área de transferência e, em seguida, colar os dados num ficheiro ou numa folha de cálculo do Excel. Para mais informações, veja Debugging Fluxo de Dados .
Configure as saídas de erro em componentes de fluxo de dados que as suportam. Muitas fontes de fluxo de dados, transformações e destinos também suportam saídas de erro. Ao configurar a saída de erro de um componente de fluxo de dados, pode direcionar dados que contenham erros para um destino diferente. Por exemplo, pode capturar os dados que falharam ou foram truncados num ficheiro de texto separado. Também pode anexar visualizadores de dados às saídas de erro e examinar apenas os dados errados. No momento do design, os resultados de erro captam valores de dados problemáticos para ajudar a desenvolver pacotes que lidam eficazmente com dados do mundo real. No entanto, enquanto outras ferramentas e funcionalidades de resolução de problemas são úteis apenas no momento do design, os resultados de erro mantêm a sua utilidade no ambiente de produção. Para mais informações, consulte Gestão de Erros em Dados.
Regista a contagem de linhas processadas. Quando executa um pacote no SSIS Designer, o número de linhas que passaram por um caminho é apresentado no designer de fluxo de dados. Este número é atualizado periodicamente enquanto os dados avançam pelo caminho. Também pode adicionar uma transformação de Contagem de Linhas ao fluxo de dados para capturar a contagem final de linhas numa variável. Para obter mais informações, consulte Transformação da contagem de linhas.
Consulte a informação no separador Progresso. O SSIS Designer fornece informações adicionais sobre fluxos de dados quando executa um pacote no SQL Server Data Tools (SSDT). O separador Progresso lista os componentes do fluxo de dados por ordem de execução e inclui informações sobre o progresso de cada fase do pacote, apresentadas como percentagem concluída, e o número de linhas escritas no destino.

Para mais informações sobre estas funcionalidades, consulte Debugging Fluxo de Dados.

Scripts de Resolução de Problemas

Microsoft Visual Studio Ferramentas para Aplicações (VSTA) é o ambiente de desenvolvimento onde se escrevem os scripts usados pela tarefa Script e pelo componente Script. O VSTA oferece as seguintes funcionalidades e ferramentas que pode usar para diagnosticar scripts durante o desenvolvimento de pacotes:

Defina pontos de paragem no script nas tarefas de Script. O VSTA fornece suporte de depuração apenas para scripts na tarefa Script. Os pontos de interrupção que defines nas tarefas do Script estão integrados com os pontos de interrupção que defines nos pacotes e nas tarefas e contentores do pacote, permitindo uma depuração fluida de todos os elementos do pacote.

Note

Quando depuras um pacote que contém várias tarefas de Script, o depurador atinge pontos de interrupção apenas numa tarefa de Script e ignora os pontos de interrupção das outras tarefas de Script. Se uma tarefa Script fizer parte de um contentor Foreach Loop ou For Loop, o depurador ignora pontos de interrupção na tarefa Script após a primeira iteração do ciclo.

Para mais informações, veja Debugging Script. Para sugestões sobre como depurar o componente Script, consulte Codificação e Depuração do Componente Script.

Resolução de Erros sem Descrição

Se encontrar um número de erro dos Serviços de Integração sem uma descrição acompanhante durante o desenvolvimento do pacote, pode localizar a descrição em Referência de Erro e Mensagem dos Serviços de Integração. A lista não inclui informações de resolução de problemas neste momento.

Last updated on 2026-08-24