Utilitário de Execução de Pacotes (dtexecui)

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

Use o Utilitário do Pacote de Execução para executar pacotes do Integration Services . O utilitário executa pacotes que estão armazenados em um dos três locais: o banco de dados do Microsoft SQL Server, o Repositório de pacotes SSIS e o sistema de arquivos. Essa interface do usuário, que pode ser aberta no SQL Server Management Studio ou digitando dtexecui em um prompt de comando, é uma alternativa à execução de pacotes por meio da ferramenta de prompt de comando DTExec .

Os pacotes são executados no mesmo processo que o utilitário dtexecui.exe . Como esse utilitário é uma ferramenta de 32 bits, os pacotes são executados por meio do dtexecui.exe em um ambiente de 64 bits no Windows on Win32 (WOW). Ao desenvolver e testar comandos por meio do utilitário dtexecui.exe em um computador de 64 bits, será necessário testar os comandos no modo de 64 bits com a versão de 64 bits do dtexec.exe antes de implantar ou agendar os comandos em um servidor de produção.

O Utilitário de Execução de Pacotes é uma interface gráfica do usuário da ferramenta de prompt de comando do DTExec . A interface do usuário facilita a configuração de opções e monta automaticamente a linha de comando que é passada para a ferramenta de prompt de comando DTExec ao executar o pacote a partir das opções especificadas.

O Utilitário de Execução de Pacotes também pode ser usado para montar as linhas de comando que você usa ao executar o DTExec diretamente.

Para abrir o utilitário Executar Pacote no SQL Server Management Studio

1. No SQL Server Management Studio, no menu Exibir , clique em Pesquisador de Objetos.

2. No Pesquisador de Objetos, clique em Conectare em Integration Services.

3. Na caixa de diálogo Conectar ao Servidor , digite o nome do servidor na lista Nome do servidor e clique em Conectar.

4. Expanda a pasta e as subpastas do Pacote Armazenado, clique com o botão direito do mouse no pacote a ser executado e, em seguida, clique em Executar Pacote.

Para abrir o utilitário Executar Pacote no prompt de comando

• Em uma janela do prompt de comando, execute dtexecui.

As seções a seguir descrevem páginas da caixa de diálogo Utilitário de Execução de Pacotes .

Página Geral

Use a página Geral da caixa de diálogo Utilitário de Execução de Pacotes para especificar um nome e um local para o pacote.

O Utilitário do Pacote de Execução (dtexecui.exe) sempre executa um pacote no computador local, mesmo que ele tenha sido salvo em um computador remoto. Se o pacote remoto usar arquivos de configuração que também tenham sido salvos no servidor remoto, pode ser que o Utilitário do Pacote de Execução não localize as configurações e ocorra uma falha no pacote. Para evitar esse problema, as configurações devem ser consultadas usando um nome de compartilhamento UNC (Convenção Universal de Nomenclatura) como \\meuservidor\meuarquivo.

Opções estáticas

Origem do pacote
Especifique o local do pacote a ser executado usando as seguintes opções:

Cada uma dessas seleções apresenta o seguinte conjunto de opções.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Opções dinâmicas

Origem do pacote = SQL Server

Servidor
Digite o nome do servidor onde o pacote está ou selecione um servidor da lista.

Fazer login no servidor
Especifique se o pacote deve usar a Autenticação do Windows ou a Autenticação do SQL Server para estabelecer conexão com o SQL Server. A Autenticação do Windows é recomendada para obter melhor segurança. Com a Autenticação do Windows você não precisa especificar um nome de usuário e senha.

Usar Autenticação do Windows
Selecione esta opção para usar a Autenticação do Windows e fazer logon usando uma conta de usuário do Microsoft Windows.

Usar Autenticação do SQL Server
Selecione esta opção para usar a 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.

Pacote
Digite o nome do pacote ou clique no botão de reticências (…) para localizar um pacote usando a caixa de diálogo Selecionar um Pacote do SSIS.

Origem do pacote = Sistema de arquivos

Pacote
Digite o nome do pacote ou clique no botão de reticências (…) para localizar um pacote usando a caixa de diálogo Abrir. Por padrão, a caixa de diálogo lista somente os arquivos com a extensão .dtsx.

Origem do pacote = Armazenamento de Pacotes SSIS

Servidor
Digite o nome do computador onde o pacote está ou selecione um computador da lista.

Fazer login no servidor
Especifique se o pacote deve usar a Autenticação do Microsoft Windows para estabelecer conexão com a origem do pacote. A Autenticação do Windows é recomendada para obter melhor segurança. Com a Autenticação do Windows você não precisa especificar um nome de usuário e senha.

Usar Autenticação do Windows
Selecione esta opção para usar a Autenticação do Windows e fazer logon usando uma conta de usuário do Microsoft Windows.

Usar Autenticação do SQL Server
Esta opção não estará disponível quando você executar um pacote armazenado no Repositório de Pacotes SSIS.

Pacote
Digite o nome do pacote ou clique no botão de reticências (…) para localizar um pacote usando a caixa de diálogo Selecionar um Pacote do SSIS.

Página Configurações

Use a página Configurações da caixa de diálogo Utilitário de Execução de Pacotes para selecionar os arquivos de configuração a serem carregados no momento da execução e para especificar a ordem em que serão carregados.

Opções

Arquivos de configuração
Estes arquivos listam as configurações que o pacote usa. Cada arquivo de configuração adiciona uma opção /CONFIGFILE filename ao prompt de comando.

Teclas de direção
Selecione um arquivo de configuração na lista e use as teclas de direção à direita para alterar a ordem de carregamento. As configurações são carregadas em ordem a partir do início da lista.

Adicionar
Clique para adicionar configurações usando a caixa de diálogo Abrir . Por padrão, a caixa de diálogo lista somente os arquivos com a extensão .dtsconfig.

Remover
Selecione um arquivo de configuração na lista e clique em Remover.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Página Arquivos de Comando

Use a página Arquivos de Comando da caixa de diálogo Utilitário de Execução de Pacotes para selecionar os arquivos de comando a serem carregados no momento da execução.

Opções

Arquivos de comando
Lista os arquivos de comando que o pacote usa. Um pacote pode usar vários arquivos para definir as opções de linha de comando.

Teclas de direção
Selecione um arquivo de comando na lista e use as teclas de seta para a direita para alterar a ordem de carregamento. Os arquivos de comando são carregados em ordem a partir do início da lista.

Adicionar
Clique para adicionar um arquivo de comando, usando a caixa de diálogo Abrir .

Remover
Selecione um arquivo de comandos na caixa de texto e remova-o usando o botão Remover .

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Página Gerenciadores de Conexões

Use a página Gerenciadores de Conexões da caixa de diálogo do Utilitário de Execução de Pacotes para editar as cadeias de conexão dos gerenciadores de conexões usados pelo pacote.

Opções

Gerenciador de Conexões
Marque a caixa de seleção para que a coluna Cadeia de Conexão possa ser editada.

Descrição
Exiba uma descrição para cada gerenciador de conexões. As descrições não podem ser editadas.

Cadeia de Conexão
Edite a cadeia de caracteres de conexão para um gerenciador de conexões. Este campo só permitirá edições quando a caixa de seleção Gerenciador de Conexões estiver marcada.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Página Opções de Execução

Use a página Opções de Execução da caixa de diálogo Utilitário de Execução de Pacotes para especificar as opções de tempo de execução do pacote.

Opções

Falha de pacote com avisos de validação
Indique se o pacote falha quando ocorre um aviso de validação.

Validar pacote sem executar
Indique se o pacote será apenas validado.

Executáveis máximos simultâneos
Indique se você deseja especificar o número máximo de executáveis que poderá ser executado simultaneamente no pacote. Depois que você marcar esta caixa de seleção, use a caixa de rotação para especificar o número máximo de executáveis.

Ativar pontos de verificação do pacote
Indique se deseja ativar os pontos de verificação do pacote.

Arquivo de ponto de verificação
Liste o arquivo de ponto de verificação que será usado pelo pacote se você ativar os pontos de verificação do pacote.

Procurar
Se você habilitar os pontos de verificação do pacote, clique no botão Procurar (…) para localizar o arquivo de ponto de verificação usando a caixa de diálogo Abrir. Se algum arquivo de ponto de verificação já tiver sido especificado, ele será substituído pelo arquivo selecionado.

Substituir opções de reinicialização
Indique se as opções de reinicialização serão substituídas se você ativar os pontos de verificação do pacote.

Opção de reinicialização
Selecione como os pontos de verificação serão usados ao substituir as opções de reinicialização.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Página Relatório

Use a página Relatório da caixa de diálogo Utilitário de Execução de Pacotes para especificar eventos e informações sobre o pacote a ser registrado no console quando o pacote é executado.

Opções

Eventos do console
Indique os eventos e os tipos de mensagens a serem relatados.

Nenhuma
Selecione para não gerar relatórios.

Erros
Selecione para informar mensagens de erro.

Warnings
Selecione para informar mensagens de aviso.

Eventos personalizados
Selecione para informar mensagens de eventos personalizados.

Eventos de Pipeline
Selecione para informar mensagens de eventos de fluxo de dados.

Informações
Selecione para informar mensagens de informações.

Verbose
Selecione para usar relatório verboso.

Log de console
Especifique as informações que deseja gravar no log quando o evento selecionado ocorrer.

Nome
Selecione para informar o nome da pessoa que criou o pacote.

Computador
Selecione para informar o nome do computador em que o pacote está sendo executado.

Operador
Selecione para informar o nome da pessoa que iniciou o pacote.

Nome de origem
Selecione para informar o nome do pacote.

GUID de Origem
Selecione para informar a GUID do pacote.

GUID de Execução
Selecione para informar a GUID da instância de execução do pacote.

Message
Selecione para informar mensagens.

Hora de início e Hora de término
Selecione para informar quando o pacote começou e quando terminou.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Página Log

Use a página Log da caixa de diálogo Utilitário de Execução de Pacotes para que os provedores de log sejam disponibilizados para o pacote no momento da execução. Forneça o tipo de provedor de log e a cadeia de conexão do pacote para estabelecer conexão com o log. Cada entrada de provedor de log adiciona uma opção /LOGGERclassid ao prompt de comando.

Opções

Provedor de Log
Selecione um provedor de log da lista.

Cadeia de Caracteres de Configuração
Selecione o nome do gerenciador de conexões do pacote que aponta para o local do log ou digite a cadeia de caracteres de conexão para estabelecer conexão com o provedor de log.

Remover
Selecione um provedor de log e clique para removê-lo.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Página Definir Valores

Use a página Definir Valores da caixa de diálogo Utilitário de Execução de Pacotes para definir os valores de propriedade, executáveis, conexões, variáveis e provedores de log dos pacotes digitando os caminhos e os valores das propriedades. Cada entrada de caminho adiciona uma opção /SETpropertypath;value ao prompt de comando.

Opções

Caminho da propriedade
Digite o caminho da propriedade. A sintaxe do caminho usa uma barra invertida (\) para indicar que o item a seguir é um contêiner, usa um ponto (.) para indicar que o item a seguir é uma propriedade e usa colchetes para indicar um membro da coleção. O membro pode ser identificado pelo índice ou pelo nome. Por exemplo, o caminho da propriedade de uma variável de pacote é \Package.Variables[MyVariable].Value.

Valor
Digite o valor da propriedade.

Remover
Selecione o caminho da propriedade e clique para removê-lo.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Página Verificação

Use a página Verificação da caixa de diálogo Executar Pacote para definir os critérios de verificação do pacote.

Opções

Executar apenas pacotes assinados
Selecione para executar apenas os pacotes que foram assinados.

Verificar construção de pacote
Selecione para verificar a construção do pacote.

Build
Especifique o número de compilação (build) sequencial associado à criação.

Verificar ID do pacote
Selecione para verificar a ID do pacote.

ID do Pacote
Especifique o número de identificação do pacote.

Verificar ID da versão
Selecione para verificar a ID da versão.

ID da versão
Especifique o número de identificação da versão.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Página Linha de Comando

Use o nó Linha de Comando da caixa de diálogo Utilitário de Execução de Pacotes para editar a linha de comando que foi gerada pelas opções criadas por vários diálogos.

Opções

Restaurar as opções originais
Clique para restaurar a linha de comando para seu estado original. Use esta opção se tiver feito modificações usando a opção Editar a linha de comando manualmente e quiser restaurar as opções originais da linha de comando.

Editar a linha de comando manualmente
Clique para editar a linha de comando na caixa de texto Linha de comando .

Linha de comando
Exibe a linha de comando atual. Se você selecionou a opção para editar a linha de comando manualmente, ela será editável.

Executar
Clique para executar o pacote.

Fechar
Clique para fechar a caixa de diálogo Utilitário do Pacote de Execução .

Consulte Também

Utilitário dtexec