Executar pacotes do SSIS (Integration Services)

  • Artigo

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

Para executar um pacote do Integration Services, você pode usar uma de várias ferramentas, dependendo de onde esses pacotes estão armazenados. As ferramentas estão listadas na tabela abaixo.

Observação

Este artigo descreve como executar pacotes do SSIS em geral e como executar pacotes localmente. Também é possível executar pacotes do SSIS nas seguintes plataformas:

Para armazenar um pacote no servidor do Integration Services, você usa o modelo de implantação do projeto para implantar o projeto no servidor. Para obter informações, consulte Implantar projetos e pacotes do SSIS (Integration Services).

Para armazenar um pacote no repositório de Pacotes SSIS, o banco de dados msdb, ou no sistema de arquivos, você usa o modelo de implantação de pacote. Para obter mais informações, confira Implantação de pacote herdado (SSIS).

Ferramenta Pacote que estão armazenados no servidor do Integration Services Pacotes que estão armazenados no Repositório do Pacotes do SSIS ou no banco de dados msdb Pacotes que estão armazenados no sistema de arquivos, fora do local que faz parte do Repositório de Pacotes do SSIS
SQL Server Data Tools Não Não

No entanto, você pode adicionar um pacote existente a um projeto do Repositório de Pacotes do SSIS, que inclui o banco de dados msdb. A adição de um pacote existente ao projeto dessa maneira cria uma cópia local do pacote no sistema de arquivos.		 Sim
No SQL Server Management Studio, quando você está conectado a uma instância do Mecanismo de Banco de Dados que hospeda o servidor do Integration Services

Para obter mais informações, consulte Caixa de diálogo Executar Pacote		 Sim Não

Porém, você pode importar um pacote no servidor a partir desses locais.		 Não

Porém, você pode importar um pacote no servidor a partir do sistema de arquivos.
No SQL Server Management Studio, quando você está conectado a uma instância do Mecanismo de Banco de Dados que hospeda o servidor do Integration Services que é habilitada como Mestre de Expansão

Para obter mais informações, consulte Executar pacotes em Expansão		 Sim Não Não
O SQL Server Management Studio, quando está conectado ao serviço Integration Services, que gerencia o Repositório de Pacotes SSIS Não Sim Não

Porém, você pode importar um pacote no Repositório de Pacotes do SSIS por meio do sistema de arquivos.
dtexec

Para saber mais, veja dtexec Utility.		 Sim Sim Sim
dtexecui

Para obter mais informações, confira Referência de interface do usuário do Utilitário de Execução de Pacotes (DtExecUI)		 Não Sim Sim
SQL Server Agent

Você usa um trabalho do SQL Server Agent para agendar um pacote.

Para obter mais informações, consulte SQL Server Agent Job para Pacotes.		 Sim Sim Sim
Procedimento armazenado interno

Para obter mais informações, confira catalog.start_execution (Banco de Dados SSISDB)		 Sim Não Não
API gerenciada, usando tipos e membros no namespace Microsoft.SqlServer.Management.IntegrationServices Sim Não Não
API gerenciada, usando tipos e membros no namespace Microsoft.SqlServer.Dts.Runtime Não atualmente Sim Sim

Execução e registro em log

Os pacotes do Integration Services podem ser habilitados para registro e você pode capturar informações em tempo de execução nos arquivos de log. Para obter mais informações, consulte Log do SSIS (Integration Services).

Você pode monitorar os pacotes do Integration Services implantados e executados no servidor do Integration Services usando relatórios de operação. Os relatórios estão disponíveis no SQL Server Management Studio. Para saber mais, confira Reports for the Integration Services Server.

Executar um pacote no SQL Server Data Tools

Normalmente, os pacotes são executados no SSDT (SQL Server Data Tools) durante o desenvolvimento, a depuração e o teste dos pacotes. Quando você executa um pacote no SSIS Designer, o pacote é sempre executado imediatamente.

Enquanto um pacote estiver sendo executado, o SSIS Designer exibe o andamento da execução do pacote na guia Progresso. Você pode exibir a hora de início e do fim do pacote e as tarefas e contêineres dele, além de informações sobre quaisquer tarefas ou contêineres no pacote em que houve falha. Depois que o pacote concluir a execução, as informações em tempo de execução continuarão disponíveis na guia Resultados da Execução . Para obter mais informações, consulte a seção "Relatório de progresso", no tópico Depuração do fluxo de controle.

Implantação de tempo de design. Quando um pacote é executado no SQL Server Data Tools, ele é criado e, em seguida, implantado em uma pasta. Antes de executar o pacote, você pode especificar a pasta na qual ele será implantado. Por padrão, se você não especificar uma pasta, a pasta bin será usada. Este tipo de implantação é chamado de implantação de tempo de design.

Para executar um pacote nas Ferramentas de Dados do SQL Server

  1. No Gerenciador de Soluções, se sua solução contiver vários projetos, clique com o botão direito do mouse no projeto do Integration Services que contém o pacote e clique em Definir como Objeto de Inicialização para definir o projeto de inicialização.

  2. No Gerenciador de Soluções, se o projeto contiver vários pacotes, clique com o botão direito do mouse em um pacote e clique em Definir como Objeto de Inicialização para definir o pacote de inicialização.

  3. Para executar um pacote, use um dos seguintes procedimentos:

    • Abra o pacote que você deseja executar e clique em Iniciar Depuração na barra de menus ou pressione F5. Após a execução do pacote, pressione Shift+F5 para retornar ao modo de design.

    • No Gerenciador de Soluções, clique com o botão direito do mouse no pacote e, em seguida, clique em Executar Pacote.

Para especificar uma pasta diferente para implantação em tempo de design

  1. No Gerenciador de Soluções, clique com o botão direito do mouse na pasta de projetos do Integration Services que contém o pacote que você deseja executar e clique em Propriedades.

  2. Na caixa de diálogo Página de Propriedades do <nome do projeto>, clique em Compilar.

  3. Atualize o valor na propriedade OutputPath para especificar a pasta que você deseja usar para a implantação em tempo de design e clique em OK.

Executar um pacote no servidor SSIS usando o SQL Server Management Studio

Depois de implantar o projeto no servidor do Integration Services, você pode executar o pacote no servidor.

Você pode usar relatórios de operações para exibir informações sobre pacotes que foram executados, ou que estão em execução no momento, no servidor. Para saber mais, confira Reports for the Integration Services Server.

Para executar um pacote no servidor usando o SQL Server Management Studio

  1. Abra o SQL Server Management Studio e conecte-se à instância do SQL Server que contém o catálogo do Integration Services.

  2. No Explorador de Objetos, expanda o nó Catálogo do Integration Services , expanda o nó SSISDB e navegue até o pacote contido no projeto que você implantou.

  3. Clique com o botão direito do mouse no nome do pacote e selecione Executar.

  4. Configure a execução de pacote usando as configurações nas guias Parâmetros, Gerenciadores de Conexõese Avançado na caixa de diálogo Executar Pacote .

  5. Clique em OK para executar o pacote.

    -ou-

    Use procedimentos armazenados para executar o pacote. Clique em Script para gerar a instrução Transact-SQL que cria uma instância da execução e inicia uma instância da execução. A instrução inclu uma chamada para os procedimentos armazenados catalog.create_execution, catalog.set_execution_parameter_value e catalog.start_execution. Para obter mais informações sobre esses procedimentos armazenados, confira catalog.create_execution (Banco de dados SSISDB), catalog.set_execution_parameter_value (Banco de dados SSISDB) e catalog.start_execution (Banco de dados SSISDB).

Execute Package Dialog Box

Use a caixa de diálogo Executar Pacote para executar um pacote armazenado no servidor do Integration Services.

Um pacote do Integration Services pode conter parâmetros com valores armazenados em variáveis de ambiente. Antes de executar esse tipo de pacote, você deve especificar qual ambiente será usado para fornecer os valores de variável de ambiente. Um projeto pode conter vários ambientes, mas só um ambiente pode ser usado para associar valores de variável de ambiente no momento da execução. Se nenhuma variável de ambiente for usada no pacote, nenhum ambiente será necessário.

O que você deseja fazer?

Abrir a caixa de diálogo Executar Pacote

  1. No SQL Server Management Studio, conecte-se ao servidor do Integration Services .

    Você está se conectando à instância do Mecanismo de Banco de Dados do SQL Server que hospeda o banco de dados SSISDB.

  2. Em Pesquisador de Objetos, expanda a árvore para exibir o nó Catálogos do Integration Services .

  3. Expanda o nó SSISDB .

  4. Expanda a pasta que contém o pacote que você deseja executar.

  5. Clique com o botão direito do mouse no pacote e clique em Executar.

Definir as opções na página Geral

Selecione Ambiente para especificar o ambiente aplicado com o pacote executado.

Definir as opções na guia Parâmetros

Use a guia Parâmetros para modificar os valores de parâmetros usados quando o pacote for executado.

Definir as opções na guia de Gerenciadores de Conexões

Use a guia Gerenciadores de Conexões para definir as propriedades dos gerenciadores de conexões do pacote.

Definir as opções na guia Avançado

Use a guia Avançado para gerenciar propriedades e outras configurações de pacote.

Adicionar, Editar, Remover
Clique para adicionar, editar ou remover uma propriedade.

Nível de log
Selecione o nível de log para a execução do pacote. Para obter mais informações, confira catalog.set_execution_parameter_value (Banco de dados SSISDB).

Despejar quando ocorrerem erros
Especifique se um arquivo de despejo será criado quando ocorrerem erros durante a execução do pacote. Para obter mais informações, consulte Generating Dump Files for Package Execution.

runtime de 32 bits
Especifique se o pacote será executado em um sistema de 32 bits.

Criando scripts para as opções na caixa de diálogo Executar Pacote

Enquanto estiver na caixa de diálogo Executar Pacote, você também poderá usar o botão Script na barra de ferramentas para gravar o código Transact-SQL. O script gerado chama os procedimentos armazenados catalog.start_execution (Banco de dados SSISDB) com as mesmas opções selecionadas na caixa de diálogo Executar Pacote. O script aparece em uma nova janela de script no Management Studio.

Consulte Também

Utilitário dtexec
Iniciar o Assistente de Importação e Exportação do SQL Server