Executando e gerenciando pacotes programaticamente

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

Se precisar gerenciar e executar pacotes do Integration Services fora do ambiente de desenvolvimento, você poderá manipular pacotes programaticamente. Nesta abordagem, você tem uma série de opções:

  • Carregar e executar um pacote existente sem modificação.

  • Carregar um pacote existente, reconfigurá-lo (por exemplo, para outra fonte de dados) e executá-lo.

  • Criar um pacote novo, adicionar e configurar os componentes, objeto por objeto e propriedade por propriedade, salvá-lo e executá-lo.

Você pode carregar e executar um pacote existente de um aplicativo cliente com a escrita de apenas algumas linhas de código.

Esta seção descreve e demonstra como executar um pacote existente programaticamente e como acessar a saída do fluxo de dados de outros aplicativos. Como opção de programação avançada, você pode criar programaticamente um pacote do Integration Services linha por linha conforme descrito no tópico Criar pacotes programaticamente.

Esta seção também discute outras tarefas administrativas que você pode executar programaticamente para gerenciar pacotes armazenados, pacotes em execução e funções do pacote.

Executando pacotes no servidor do Integration Services

Quando você implanta pacotes no servidor do Integration Services, pode executar os pacotes programaticamente usando o namespace Microsoft.SqlServer.Management.IntegrationServices. O assembly Microsoft.SqlServer.Management.IntegrationServices é compilado com o .NET Framework 3.5. Se você estiver compilando um aplicativo do .NET Framework 4.0, terá que adicionar a referência de assembly diretamente no seu arquivo de projeto.

Você também pode usar o namespace para implantar e gerenciar projetos do Integration Services em seu servidor. Para obter uma visão geral do namespace e dos snippets de códigos, consulte a entrada do blog Prévia do modelo do objeto gerenciado do catálogo do SSISem blogs.msdn.com.

Nesta seção

Compreender as diferenças entre execução local e remota
Discute diferenças críticas entre a execução de um pacote localmente ou no servidor.

Carregando e executando um pacote local programaticamente
Descreve como executar um pacote existente de um aplicativo cliente no computador local.

Carregando e executando um pacote remoto programaticamente
Descreve como executar um pacote existente de um aplicativo cliente e como garantir que o pacote seja executado no servidor.

Carregando a saída de um pacote local
Descreve como executar um pacote no computador local e carregar a saída do fluxo de dados em um aplicativo cliente, utilizando o destino DataReader e o namespace DtsClient.

Enumerando pacotes disponíveis programaticamente
Descreve como descobrir pacotes disponíveis que são gerenciados pelo serviço do Integration Services.

Gerenciando pacotes e pastas programaticamente
Descreve como criar, renomear e excluir pacotes e pastas.

Gerenciando pacotes em execução programaticamente
Descreve como listar pacotes que estão em execução atualmente, examinar suas propriedades e interromper um pacote em execução.

Gerenciando funções de pacote programaticamente (Serviço SSIS)
Descreve como obter ou definir informações sobre as funções atribuídas a um pacote ou pasta.

Referência

Referência de mensagens e erros do Integration Services
Lista os códigos de erro predefinidos do Integration Services com seus nomes simbólicos e descrições.

Estendendo pacotes com scripts
Discute como estender o fluxo de controle usando a tarefa Script, e como estender o fluxo de dados usando o componente Script.

Estendendo pacotes com objetos personalizados
Discute como criar tarefas personalizadas de programa, componentes de fluxo de dados e outros objetos de pacote para uso em vários pacotes.

Compilando pacotes programaticamente
Descreve como criar, configurar e salvar pacotes do Integration Services programaticamente.

Consulte Também

SQL Server Integration Services