Agendar um pacote usando o SQL Server Agent
O procedimento a seguir fornece as etapas para automatizar a execução do pacote usando uma etapa de trabalho do SQL Server Agent para executar o pacote.
Para automatizar a execução do pacote usando o SQL Server Agent
No SQL Server Management Studio, conecte-se à instância do SQL Server em que você deseja criar um trabalho ou a instância que contém o trabalho ao qual deseja adicionar uma etapa.
Expanda o nó SQL Server Agent no Pesquisador de Objetos e execute uma das tarefas a seguir:
Para criar um trabalho novo, clique com o botão direito do mouse em Trabalhos e, em seguida, clique em Novo Trabalho.
Para adicionar uma etapa a 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.
Para criar uma etapa de trabalho do pacote que deseja agendar, clique em Etapas e, em seguida, em Nova.
Selecione Pacote do Integration Services para o tipo de etapa do trabalho.
Na lista Executar como, selecione Conta de Serviço do SQL Server Agent ou selecione uma conta proxy com as credenciais que a etapa de trabalho usará. Para obter informações sobre como criar uma conta proxy, consulte Criar um proxy do SQL Server Agent.
Usar uma conta proxy em vez de uma Conta de Serviço do SQL Server Agent pode resolver problemas comuns que podem ocorrer ao executar um pacote usando o SQL Server Agent. Para obter mais informações sobre esses problemas, consulte o Microsoft Artigo da Base de Dados de Conhecimento, Um pacote SSIS não é executado quando você chama o pacote do SSIS a partir de uma etapa de trabalho do SQL Server Agent.
.gif "Observação")
ObservaçãoSe a senha for alterada para as credenciais usadas pela conta proxy, será necessário atualizar a senha da credencial. Caso contrário, a etapa do trabalho falhará.
Para obter informações sobre como configurar a conta de serviço SQL Server Agent, consulte Definir a conta de inicialização de serviço para o SQL Server Agent (SQL Server Configuration Manager).
Na caixa de listagem Origem do Pacote, clique na origem do pacote e configure as opções para a etapa do trabalho.
A seguinte tabela descreve as possíveis origens do pacote.
Origem do pacote
Descrição
Catálogo do SSIS
Os pacotes armazenados no banco de dados SSISDB. Os pacotes são contidos em projetos de Integration Services que são implantados no servidor Integration Services.
SQL Server
Os pacotes armazenados no banco de dados MSDB. Use o serviço de Integration Services para gerenciar esses pacotes.
Armazenamento de Pacotes SSIS
Pacotes que estão armazenados na pasta padrão no computador. A pasta padrão é <drive>:\Arquivos de Programas\Microsoft SQL Server\110\DTS\Pacotes. Use o serviço de Integration Services para gerenciar esses pacotes.
ObservaçãoVocê pode especificar uma pasta diferente ou especificar pastas adicionais no sistema de arquivos a ser gerenciado pelo serviço de Integration Services modificando o arquivo de configuração para Integration Services. Para obter mais informações, consulte Configurando o serviço Integration Services (serviço SSIS).
Sistema de Arquivos
Pacotes que estão armazenados em qualquer pasta em sua máquina local.
As tabelas seguintes descrevem as opções de configuração que estão disponíveis para a etapa de trabalho segundo a origem do pacote que você selecionou.
.gif "Observação importante")
ImportanteSe o pacote estiver protegido por senha, quando você clicar em qualquer uma das guias na página Geral da caixa de diálogo Nova Etapa do Trabalho, com exceção da guia Pacote, precisará digitar a senha na caixa de diálogo Senha do Pacote que aparecer. Caso contrário, o trabalho do SQL Server Agent não poderá executar o pacote.
Origem do pacote: Catálogo do SSIS
Guia
Opções
Pacote
Servidor
Digite ou selecione o nome da instância de servidor de banco de dados que hospeda o catálogo de SSISDB.
Quando o Catálogo do SSIS é a origem do pacote, você pode fazer logon no servidor que usa somente uma conta de usuário do Microsoft Windows. Autenticação de SQL Server não disponível.
Pacote
Clique no botão de reticências e selecione um pacote.
Você está selecionando um pacote em uma pasta sob o nó de Catálogos do Integration Services no Pesquisador de Objetos.
Parâmetros
Localizado na guia Configuração.
Insira novos valores de parâmetros que estão contidos no pacote. Você pode inserir um valor literal ou usar o valor contido em uma variável de ambiente de servidor que já mapeou para o parâmetro.
Para digitar o valor literal, clique no botão de reticências ao lado de um parâmetro. A caixa de diálogo Editar Valor Literal para Execução é exibida.
Para usar uma variável de ambiente, clique em Ambiente e selecione o ambiente que contém a variável que você deseja usar.
ImportanteSe você mapear vários parâmetros e/ou propriedades do gerenciador de conexões para variáveis contidas em vários ambientes, o SQL Server Agent exibirá uma mensagem de erro. Para uma execução específica, um pacote pode ser executado somente com os valores contidos em um único ambiente de servidor.
Para obter informações sobre como criar um ambiente de servidor e mapear uma variável para um parâmetro, consulte Criar e mapear um ambiente de servidor.
A guia Parâmetros exibe os parâmetros que você adicionou quando criou o pacote, por exemplo, usando SSDT (SQL Server Data Tools). A guia também exibe os parâmetros que foram adicionados ao pacote quando você converteu o projeto Integration Services do modelo de implantação de pacote para o modelo de implantação de projeto. O Assistente de Conversão de Projetos do Integration Services permite substituir configurações de pacote por parâmetros.
Gerenciadores de Conexões
Localizado na guia Configuração.
Altere os valores das propriedades do gerenciador de conexões. Por exemplo, você pode alterar o nome do servidor.
Os parâmetros são gerados automaticamente no servidor do SSIS para as propriedades do gerenciador de conexões.
Para alterar um valor de propriedade, você pode inserir um valor literal ou usar o valor contido em uma variável de ambiente de servidor que já mapeou para a propriedade do gerenciador de conexões.
Para digitar o valor literal, clique no botão de reticências ao lado de um parâmetro. A caixa de diálogo Editar Valor Literal para Execução é exibida.
Para usar uma variável de ambiente, clique em Ambiente e selecione o ambiente que contém a variável que você deseja usar.
ImportanteSe você mapear vários parâmetros e/ou propriedades do gerenciador de conexões para variáveis contidas em vários ambientes, o SQL Server Agent exibirá uma mensagem de erro. Para uma execução específica, um pacote pode ser executado somente com os valores contidos em um único ambiente de servidor.
Para obter informações sobre como criar um ambiente de servidor e mapear uma variável para uma propriedade do gerenciador de conexões, consulte Criar e mapear um ambiente de servidor.
Avançado
Localizado na guia Configuração.
Defina as seguintes configurações adicionais para a execução do pacote.
- Substituições de propriedades
Clique em Adicionar para digitar um novo valor para uma propriedade de pacote, especificar o caminho da propriedade e indicar se o valor da propriedade é confidencial. O servidor Integration Services criptografa dados confidenciais.
Para editar ou remover as configurações de uma propriedade, clique em uma linha na caixa das substituições Propriedade e clique em Editar ou em Remover.
Você pode encontrar o caminho da propriedade seguindo um dos procedimentos a seguir.
Copie o caminho da propriedade do arquivo de configuração XML (*.dtsconfig). O caminho é listado na seção Configuração do arquivo como um valor do atributo Caminho. Veja a seguir um exemplo de caminho para a propriedade MaximumErrorCount.
\Package.Properties[MaximumErrorCount]
Execute o Assistente de Configuração de Pacotes e copie os caminhos da propriedade da página final Concluindo o Assistente. Então, você pode cancelar o assistente.
ObservaçãoA opção de Substituições de Propriedades é destinada a pacotes com configurações atualizadas de uma versão anterior de Integration Services. Pacotes que você cria usando SQL Server 2012 Integration Services (SSIS) e implanta para o servidor Integration Services usam parâmetros em vez de configurações.
- Nível de log
Selecione um dos seguintes níveis de log para a execução do pacote.
Selecionar o nível de log Desempenho ou Detalhado pode afetar o desempenho da execução do pacote.
Nenhum
O log está desativado. Apenas o status da execução do pacote é registrado em log.
Básica
Todos os eventos são registrados em log, menos personalizados e de diagnóstico. Este é o valor padrão do nível de log.
Desempenho
Apenas estatísticas de desempenho e eventos OnError e OnWarning são registrados em log.
Detalhado
Todos os eventos são registrados em log, inclusive eventos personalizados e de diagnóstico.
O nível de log selecionado determina quais informações são exibidas em exibições SSISDB e nos relatórios do servidor Integration Services. Para obter mais informações, consulte Habilitar o log para a execução do pacote no servidor SSIS.
- Despejar quando ocorrerem erros
Especifique se os arquivos de despejo de depuração são gerados quando ocorre um erro durante a execução do pacote.
O arquivo contém informações sobre a execução do pacote que pode ajudar a solucionar problemas de execução.
Quando você seleciona essa opção e ocorre um erro durante a execução, Integration Services cria um arquivo .mdmp (arquivo binário) e um arquivo .tmp (arquivo de texto). Por padrão, o Integration Services armazena os arquivos na pasta <drive>:\Arquivos de Programas\Microsoft SQL Server\110\Shared\ErrorDumps.
- Tempo de execução de 32 bits
Indique se o pacote será executado usando a versão de 32 bits do utilitário dtexec em um computador de 64 bits que tenha a versão de 64 bits do SQL Server e do SQL Server Agent instalada.
Você pode precisar executar o pacote usando uma versão de 32 bits do dtexec, por exemplo, se o pacote usar um provedor OLE DB nativo que não esteja disponível em uma versão de 64 bits. Para obter mais informações, consulte Considerações do Integration Services sobre versões de 64 bits.
Por padrão, quando você seleciona o tipo de etapa de trabalho Pacote do SQL Server Integration Services, o SQL Server Agent executa o pacote usando a versão do utilitário dtexec invocada automaticamente pelo sistema. O sistema invoca a versão de 32 bits ou de 64 bits do utilitário, dependendo do processador do computador, e a versão do SQL Server e do SQL Server Agent que está sendo executada no computador.
Origem do pacote: SQL Server, Repositório de Pacotes SSIS ou Sistema de Arquivos
Muitas das opções que você pode definir para pacotes armazenados no SQL Server, no Armazenamento de Pacotes SSIS ou no sistema de arquivos correspondem às opções de linha de comando para o utilitário de prompt de comando dtexec. Para obter mais informações sobre as opções de linha de comando e utilitário, consulte Utilitário dtexec.
Guia
Opções
Pacote
Estas são as opções da guia para pacotes que estão armazenados no SQL Server ou no Armazenamento de pacotes SSIS.
Servidor
Digite ou selecione o nome da instância do servidor do banco de dados do SQL Server ou do serviço Integration Services.
Usar Autenticação do Windows
Selecione esta opção para fazer logon no servidor usando uma conta de usuário do Microsoft Windows.
Usar Autenticação do SQL Server
Quando um usuário se conecta com um nome de login e senha especificados em uma conexão não confiável, o próprio SQL Server efetua a autenticação verificando se foi definida uma conta de login do SQL Server e se a senha especificada corresponde a uma senha registrada previamente. Se o SQL Server não localizar a conta de login, ocorrerá uma falha na autenticação e o usuário receberá uma mensagem de erro.
Nome de usuário
Senha
Pacote
Clique no botão de reticências e selecione o pacote.
Você está selecionando um pacote em uma pasta sob o nó de Pacotes Armazenados no Pesquisador de Objetos.
Pacote
Estas são as opções da guia para pacotes que estão armazenados no sistema de arquivos.
Pacote
Digite o caminho completo do arquivo do pacote ou clique no botão de reticências para selecionar o pacote.
Configurações
Adicione um arquivo de configuração XML para executar o pacote com uma configuração específica. Use uma configuração de pacote para atualizar os valores das propriedades do pacote no tempo de execução.
Essa opção corresponde à opção de /ConfigFile para dtexec.
Para compreender como são aplicadas as configurações de pacote, consulte Configurações de pacote. Para obter informações sobre como criar uma configuração de pacote, consulte Criar configurações de pacote.
Arquivos de comando
Especifique opções adicionais que deseja executar com dtexec em um arquivo separado.
Por exemplo, você pode incluir um arquivo que contém a opção de /Dump errorcode para gerar arquivos de despejo de depuração quando um ou mais eventos especificados ocorrerem durante a execução do pacote.
Você pode executar um pacote com conjuntos diferentes de opções criando vários arquivos e especificando o arquivo apropriado usando a opção Arquivos de Comando.
A opção Arquivos de Comando corresponde à opção /CommandFile para dtexec.
Fontes de Dados
Exiba os gerenciadores de conexões contidos no pacote. Para modificar uma cadeia de caracteres de conexão, clique no gerenciador de conexões e depois na cadeia de conexões.
Essa opção corresponde à opção de /Connection para dtexec.
Opções de Execução
- Reprovar o pacote nos avisos de validação
Indica se uma mensagem de aviso é considerada um erro. Se você selecionar essa opção e ocorrer um aviso durante a validação, o pacote falhará durante a validação. Essa opção corresponde à opção de /WarnAsError para dtexec.
- Validar pacote sem executar
Indica se a execução do pacote é interrompida depois da fase de validação, sem executar realmente o pacote. Essa opção corresponde à opção de /Validate para dtexec.
- Substituir a propriedade MacConcurrentExecutables
Especifica o número de arquivos executáveis que o pacote pode executar simultaneamente. O valor de -1 significa que o pacote pode executar um número máximo de arquivos executáveis igual ao número total de processadores no computador que executa o pacote mais dois. Essa opção corresponde à opção de /MaxConcurrent para dtexec.
- Ativar pontos de verificação do pacote
Indica se o pacote usará pontos de verificação durante sua execução. Para obter mais informações, consulte Reiniciar pacotes por meio de pontos de verificação.
Essa opção corresponde à opção de /CheckPointing para dtexec.
- Substituir opções de reinicialização
Indica se um novo valor está definido para a propriedade CheckpointUsage no pacote. Selecione um valor na caixa de listagem Opção de Reinicialização.
Essa opção corresponde à opção de /Restart para dtexec.
- Use o tempo de execução de 32 bits
Indique se o pacote será executado usando a versão de 32 bits do utilitário dtexec em um computador de 64 bits que tenha a versão de 64 bits do SQL Server e do SQL Server Agent instalada.
Você pode precisar executar o pacote usando uma versão de 32 bits do dtexec, por exemplo, se o pacote usar um provedor OLE DB nativo que não esteja disponível em uma versão de 64 bits. Para obter mais informações, consulte Considerações do Integration Services sobre versões de 64 bits.
Por padrão, quando você seleciona o tipo de etapa de trabalho Pacote do SQL Server Integration Services, o SQL Server Agent executa o pacote usando a versão do utilitário dtexec invocada automaticamente pelo sistema. O sistema invoca a versão de 32 bits ou de 64 bits do utilitário, dependendo do processador do computador, e a versão do SQL Server e do SQL Server Agent que está sendo executada no computador.
Log
Associe um provedor de logs à execução do pacote.
- Provedor de log SSIS log para arquivos de Texto
Grava entradas de log em arquivos de texto ASCII
- Provedor de log SSIS log para o SQL Server
Escreve entradas de log na tabela sysssislog do banco de dados MSDB.
- Provedor de log SSIS para o SQL Server Profiler
Grava rastreamentos que você pode exibir usando o SQL Server Profiler.
- Provedor de log SSIS para o Log de Eventos do Windows
Grava entradas de log no log de aplicativos do log de eventos do Windows Event.
- Provedor de log SSIS log para arquivos XML
Grava arquivos de log em um arquivo XML.
Para o arquivo de texto, arquivo XML e os provedores de log do Profiler SQL Server, você está selecionando os gerenciadores de conexões de arquivos que estão contidos no pacote. Para o provedor de log do SQL Server, você está selecionando um gerenciador de conexões OLE DB que está contido no pacote.
Essa opção corresponde à opção de /Logger para dtexec.
Valores definidos
Substitua uma configuração de propriedade do pacote. Na caixa Propriedades, digite os valores nas colunas Caminho da Propriedade e Valor. Depois que você inserir valores para uma propriedade, uma linha vazia será exibida na caixa Propriedades para permitir que você insira valores para outra propriedade.
Para remover uma propriedade da caixa Propriedades, clique na linha e depois em Remover.
Você pode encontrar o caminho da propriedade seguindo um dos procedimentos a seguir.
Copie o caminho da propriedade do arquivo de configuração XML (*.dtsconfig). O caminho é listado na seção Configuração do arquivo como um valor do atributo Caminho. Veja a seguir um exemplo de caminho para a propriedade MaximumErrorCount.
\Package.Properties[MaximumErrorCount]
Execute o Assistente de Configuração de Pacotes e copie os caminhos da propriedade da página final Concluindo o Assistente. Então, você pode cancelar o assistente.
Verificação
- Executar apenas pacotes assinados
Indica se a assinatura do pacote foi verificada. Se o pacote não for assinado ou a assinatura não for válida, o pacote falhará. Essa opção corresponde à opção de /VerifySigned para dtexec.
- Verificar a compilação do pacote
Indica se o número da compilação do pacote será verificado no número da compilação inserido na caixa Compilar ao lado dessa opção. Se uma ocorrer um erro de correspondência, o pacote não será executado. Essa opção corresponde à opção de /VerifyBuild para dtexec.
- Verificar ID do pacote
Indica se o GUID do pacote será verificado comparando-o ao ID do pacote inserido na caixa ID do Pacote ao lado dessa opção. Essa opção corresponde à opção de /VerifyPackageID para dtexec.
- Verificar ID da versão
Indica se o GUID da versão do pacote será verificada comparando o ID da versão inserido na caixa ID da Versão ao lado dessa opção. Essa opção corresponde à opção de /VerifyVersionID para dtexec.
Linha de comando
Modifique as opções de linha de comando para dtexec. Para obter mais informações sobre as opções, consulte Utilitário dtexec.
DicaVocê pode copiar a linha de comando para uma janela de prompt de comando, adicionar dtexec e executar o pacote na linha de comando. Essa é uma forma fácil de gerar o texto da linha de comando.
- Restaurar as opções originais
Use as opções de linha de comando que você definiu nas guias Pacote, Configurações, Arquivos de Comando, Fontes de Dados, Opções de execução, Log, Definir Valores e Verificação da caixa de diálogo Propriedades do Trabalho.
- Editar o comando manualmente
Digite opções adicionais de linha de comando na caixa Linha de Comando.
Antes de clicar em OK para salvar suas alterações na etapa de trabalho, você pode remover todas as opções adicionais que digitou na caixa Linha de Comando clicando em Restaurar as Opções Originais.
Clique em OK para salvar as configurações e feche a caixa de diálogo Nova Etapa de Trabalho.
ObservaçãoPara pacotes armazenados no Catálogo do SSIS, o botão OK é desativado quando há um parâmetro não resolvido ou uma configuração de propriedade do gerenciador de conexões. Uma configuração não resolvida ocorre quando você está usando um valor contido em uma variável de ambiente de servidor para definir o parâmetro ou a propriedade e uma das condições a seguir é atendida.
A caixa de seleção Ambiente na guia Configuração não está marcada.
O ambiente de servidor que contém a variável não está selecionado na caixa de listagem na guia Configuração.
Para criar uma agenda para uma etapa de trabalho, clique em Agendas no painel Selecionar uma Página. Para obter informações sobre como configurar uma agenda, consulte Agendar um trabalho.
DicaAo nomear a agenda, use um nome que seja exclusivo e descritivo para que você possa distinguir mais facilmente a agenda de outras agendas do SQL Server Agent.