Como executar um pacote
Para executar um pacote do Integration Services, você pode usar uma das seguintes ferramentas:
O utilitário de prompt de comando dtexec (dtexec.exe).
O Utilitário de Execução de Pacotes (dtexecui.exe).
Um trabalho do SQL Server Agent.
As seções a seguir descrevem como usar cada uma dessas ferramentas para executar um pacote.
.gif "Observação") Observação |
|---|
Você também pode executar um pacote no tempo de design no Business Intelligence Development Studio. Para obter mais informações, consulte Como executar um pacote no Business Intelligence Development Studio. |
Usando o dtexec para executar um pacote
Usando o utilitário dtexec, você pode executar pacotes que são armazenados no sistema de arquivos, em uma instância do SQL Server ou no Armazenamento de Pacotes Integration Services. Para obter informações sobre as opções que podem ser usadas em uma linha de comando do dtexec e em algumas linhas de comando de exemplo, consulte Utilitário dtexec (ferramenta SSIS).
| Observação |
|---|
Em um computador de 64 bits, o Integration Services instala a versão de 64 bits do utilitário dtexec. Se for necessário executar certos pacotes no modo de 32 bits, você deverá instalar a versão de 32 bits do utilitário dtexec. Para instalar a versão de 32 bits do utilitário dtexec, você deve selecionar Ferramentas de Cliente ou Business Intelligence Development Studio durante a instalação. |
Para executar um pacote usando o utilitário dtexec
No prompt de comando, digite dtexec / seguido pela opção DTS, SQL ou File e o caminho do pacote. Inclua o nome de arquivo do pacote no caminho do pacote.
Se o nível de criptografia do pacote for EncryptSensitiveWithPassword ou EncryptAllWithPassword, use a opção Decrypt para fornecer a senha. Se você não incluir uma senha, o dtexec irá solicitá-la.
(Opcional) Insira opções adicionais de linha de comando.
Pressione a tecla ENTER.
(Opcional) Exiba as informações de log e relatório antes de fechar a janela Prompt de Comando.
Usando o Utilitário de Execução de Pacotes para executar um pacote
O Utilitário de Execução de Pacotes (dtexecui.exe) cria uma linha de comando que você pode usar das seguintes formas:
Copie-a em um arquivo e use-a com a opção CommandFile do utilitário dtexec.
Cole-a diretamente na janela Prompt de Comando ao usar o utilitário dtexec para executar um pacote.
O Utilitário de Execução de Pacotes só está disponível na versão de 32 bits. Em um computador de 64 bits, todos os comandos criados pelo Utilitário de Execução de Pacotes também devem ser testados no modo de 64 bits antes de serem implantados ou agendados em um servidor de produção. Para testar esses comandos no modo de 64 bits, use a versão de 64 bits do utilitário dtexec.
Para executar um pacote usando o Utilitário de Execução de Pacotes
No Management Studio, no menu Exibir, clique em Pesquisador de Objetos.
No Pesquisador de Objetos, clique em Conectar e em Integration Services.
ObservaçãoSe você não conseguir conectar, verifique se o serviço do Integration Services foi iniciado. O status do serviço pode ser definido como Automático ou Manual. Para obter mais informações, consulte Como definir as propriedades do serviço do Integration Services.
Expanda a pasta Pacotes Armazenados e suas subpastas para localizar o pacote a ser executado, clique com o botão direito do mouse no pacote e, em seguida, clique em Executar Pacote.
(Opcional) Na caixa de diálogo Utilitário de Execução de Pacotes, execute uma ou mais das seguintes tarefas:
Especifique um pacote diferente a ser executado.
Clique em Configurações, Arquivos de Comando, Gerenciadores de Conexões, Opções de Execução, Relatório, Log, Definir Valores ou Verificação para atualizar opções de tempo de execução.
Clique em Linha de Comando para rever a linha de comando que o utilitário usa.
Clique em Executar.
Para parar o pacote em execução, clique em Parar na caixa de diálogo Progresso de Execução do Pacote.
Quando o pacote terminar, clique em Fechar para sair da caixa de diálogo Progresso de Execução do Pacote.
Usando o SQL Server Agent para executar um pacote
Ao criar um trabalho do SQL Server Agent para executar pacotes, você deve criar uma etapa separada para cada pacote que deseja executar. O trabalho pode ser associado a uma ou mais agendas ou pode ser um trabalho não agendado que você executa manualmente.
A conta que executa um pacote do Integration Services como uma etapa de trabalho do SQL Server Agent exige as mesmas permissões que uma conta que executa o pacote diretamente. Para obter informações sobre como resolver problemas de pacotes executados nos trabalhos do SQL Server Agent, consulte o artigo na Base de Dados de Conhecimento Microsoft, Um pacote do SSIS não executa se você chama o pacote do SSIS de uma etapa do trabalho do SQL Server Agent.
Para assistir a um vídeo que demonstra como solucionar problemas de pacotes executados em trabalhos do SQL Server Agent, consulte a home page de vídeos, Solucionando problemas: Execução do pacote usando o SQL Server Agent (vídeo do SQL Server), na Biblioteca MSDN.
Para assistir a um vídeo que demonstra como usar o SQL Server Agent para executar um pacote, consulte a home page de vídeos, Como: automatizar a execução de pacotes usando o SQL Server Agent (vídeo do SQL Server), na Biblioteca MSDN.
Para executar um pacote usando um trabalho do SQL Server Agent
No SQL Server Management Studio, abra a instância do SQL Server para a qual você deseja criar um trabalho ou a instância que contém o trabalho para o qual deseja adicionar uma etapa.
Expanda o SQL Server Agent e realize uma das seguintes tarefas:
Para criar um trabalho novo, clique com o botão direito do mouse em Trabalhos e, em seguida, clique em Novo.
Para usar um trabalho existente, expanda Trabalhos, clique com o botão direito do mouse no trabalho e, em seguida, clique em Propriedades.
Na página Geral, se você estiver criando um novo trabalho, forneça um nome de trabalho, selecione uma categoria e um proprietário e, se desejar, forneça uma descrição do trabalho.
Para disponibilizar o trabalho para agendamento, selecione Habilitado.
Clique em Etapas e, em seguida, em Novo.
Forneça um nome de etapa e, na lista Tipo, selecione um tipo de etapa de trabalho com base na versão do utilitário dtexec (dtexec.exe) que você deseja que execute o trabalho:
Para executar o trabalho usando a versão do utilitário dtexec que é invocada automaticamente pelo sistema, selecione Pacote do SQL Server Integration Services.
Em um computador de 32 bits que esteja executando o SQL Server e o SQL Server Agent, essa configuração invoca a versão de 32 bits do utilitário dtexec.
Em um computador de 64 bits que tem a versão de 64 bits do SQL Server e o SQL Server Agent instalados e em execução, essa configuração invoca a versão de 64 bits do utilitário dtexec.
Em um computador de 64 bits que tem somente a versão de 32 bits do SQL Server e o SQL Server Agent instalados e em execução, essa configuração invoca a versão de 32 bits do utilitário dtexec.
Para executar um pacote no modo de 32 bits de uma versão de 64 bits do SQL Server Agent, na caixa de diálogo Nova Etapa do Trabalho, na guia Opções de execução, selecione Usar tempo de execução de 32 bits.
Na lista Executar como, selecione a conta proxy que tem as credenciais que o trabalho usará. Para obter mais informações, consulte os seguintes tópicos:
Na guia Geral, selecione a origem do pacote.
Se a origem for o Armazenamento de Pacotes SQL Server ou do SSIS, forneça o nome do servidor e selecione o modo de autenticação a ser usado. Depois, forneça o nome do pacote ou clique no botão de reticências (…) e localize o pacote.
Se a origem for o sistema de arquivos, forneça o caminho e o nome do pacote ou clique no botão de reticências (…) e localize o pacote.
.gif "Observação importante")
ImportantePara pacotes do SSIS protegidos por senha, clique na guia Configurações para inserir a senha na caixa de diálogo Senha do Pacote. Caso contrário, o trabalho do SQL Server Agent que executa o pacote protegido por senha falhará.
Para especificar as opções de linha de comando, faça o seguinte:
Clique na guia Arquivos de Comando para especificar os arquivos que contêm as opções usadas pelo pacote.
Clique na guia Linha de Comando para modificar ou restaurar as opções de linha de comando.
Clique na guia Configurações para adicionar arquivos de configuração e, opcionalmente, exportar variáveis configuradas para um arquivo.
Clique na guia Fontes de Dados, selecione a caixa de seleção do gerenciador de conexões e, então, atualize a cadeia de conexão.
Clique na guia Opções de Execução para especificar o comportamento em tempo de execução do pacote, como, por exemplo, o aviso dado em caso de falha do pacote.
Clique na guia Log para adicionar provedores de log. Selecione um provedor de log na lista Provedor de Log e, então, digite a cadeia de conexão.
Clique na guia Definir Valores para mapear propriedades e variáveis para valores.
ObservaçãoO caminho da propriedade usa esta sintaxe: \Package\<nome do contêiner><nome da propriedade>. Dependendo da estrutura do pacote, um contêiner pode incluir outros contêineres; neste caso, os contêineres aninhados são separados por uma barra invertida (\). Por exemplo, Package\MyForeachLoop\MySequence\MyExecuteSQLTask.Description.
Clique na guia Verificação para especificar se apenas pacotes assinados podem ser executados e para especificar a versão do pacote a ser executado.
Clique em OK.