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 Etapase, 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 Create a SQL Server Agent Proxy.
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.
Observação
Se 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 do SQL Server Agent, confira Definir a conta de inicialização do 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>:\Program Files\Microsoft SQL Server\110\DTS\Packages. Use o serviço de Integration Services para gerenciar esses pacotes.
Observação: Você pode especificar uma pasta diferente ou 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 Configuring the Integration Services Service (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.
Importante
Se 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
Tab 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. 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. **Importante** Se você tiver mapeado 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 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.
A guia Parâmetros exibe os parâmetros que você adicionou quando criou o pacote, por exemplo, usando SQL Server Data Tools (SSDT). 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.
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.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. **Importante** Se você tiver mapeado 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 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.
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 propriedade: clique em Adicionar para inserir um novo valor para uma propriedade de pacote, especifique o caminho da propriedade e indique 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. Observe que a opção Substituições de propriedade destina-se a pacotes com configurações que você atualizou de uma versão anterior do Integration Services. Os pacotes que você cria usando o SSIS (Integration Services) do SQL Server 2014 e implantam no servidor do Integration Services usam parâmetros em vez de configurações. Você pode encontrar o caminho da propriedade seguindo um destes procedimentos:
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 de propriedade da página final Concluindo o Assistente . Então, você pode cancelar o assistente.Nível de registro em log: o nível de log selecionado determina quais informações são exibidas nas exibições do SSISDB e nos relatórios do servidor do Integration Services. Observe que a seleção do nível de log Desempenho ou Detalhado pode afetar o desempenho da execução do pacote. Selecione um dos seguintes níveis de log para a execução do pacote:
Nenhum: o registro em log está desativado. Apenas o status da execução do pacote é registrado em log.
Básico: todos os eventos são registrados, exceto eventos personalizados e de diagnóstico. Este é o valor padrão do nível de log.
Desempenho: somente as estatísticas de desempenho e os eventos OnError e OnWarning são registrados.
Detalhado: todos os eventos são registrados, incluindo eventos personalizados e de diagnóstico.
Para saber mais, veja Habilitar o log para a execução do pacote no servidor SSIS.Erros de despejo: especifique se os arquivos de despejo de depuração são gerados quando ocorre algum 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 esses arquivos na <unidade>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps folder.Runtime de 32 bits Indique se o pacote deve 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 de SQL Server e 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, armazenamento 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.Tab 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 logon 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 logon 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 runtime.
Essa opção corresponde à opção /ConfigFile paradtexec.
Para compreender como são aplicadas as configurações de pacote, consulte Package Configurations. Para obter informações sobre como criar uma configuração de pacote, consulte Create Package Configurations.Arquivos de comando Especifique opções adicionais que deseja executar com dtexecem 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/CommandFileparadtexec.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/Connectionparadtexec.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/WarnAsErrorparadtexec.
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/Validateparadtexec.
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/MaxConcurrentparadtexec.
Ativar pontos de verificação do pacote
Indica se o pacote usará pontos de verificação durante sua execução. Para saber mais, confira Restart Packages by Using Checkpoints.
Essa opção corresponde à opção de/CheckPointingparadtexec.
Substituir opções de reinicialização
Indica se um novo valor está definido para a propriedadeCheckpointUsageno pacote. Selecione um valor na caixa de listagem Opção de Reinicialização .
Essa opção corresponde à opção de/Restartparadtexec.
Use o runtime 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.Logging 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/Loggerparadtexec.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 de 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/VerifySignedparadtexec.
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/VerifyBuildparadtexec.
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/VerifyPackageIDparadtexec.
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/VerifyVersionIDparadtexec.Linha de comando Modifique as opções de linha de comando para dtexec. Para obter mais informações sobre as opções, consulte dtexec Utility.
Dica: você pode copiar a linha de comando para uma janela do Prompt de Comando, adicionardtexece 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, Logging, Definir valorese 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ção
Para 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 Schedule a Job.
Dica
Ao 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.