Utilitário para Execução de Pacote (dtexecui)

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

Use o Utilitário de Pacote de Execução para executar pacotes do Integration Services. O utilitário executa pacotes 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 a partir do SQL Server Management Studio ou digitando dtexecui em um prompt de comando, é uma alternativa à execução de pacotes usando a 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 executados usando dtexecui.exe em um ambiente de 64 bits são executados no Windows no Win32 (WOW). Ao desenvolver e testar comandos usando o utilitário dtexecui.exe em um computador de 64 bits, você deve testar os comandos no modo de 64 bits usando a versão de 64 bits do dtexec.exe antes de implantar ou agendar os comandos em um servidor de produção.

O Execute Package Utility é uma interface gráfica do usuário para a ferramenta de prompt de comando 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 quando você executa o pacote a partir das opções especificadas.

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

Para abrir o Utilitário de Pacote de Execução 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 Conectar e 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 Pacotes Armazenados , clique com o botão direito do rato no pacote que pretende executar e, em seguida, clique em Executar Pacote.

Para abrir o Utilitário de Execução de Pacote na linha de comando

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

As seções a seguir descrevem páginas da caixa de diálogo Executar Utilitário de Pacote .

Página Geral

Use a página Geral da caixa de diálogo Executar Utilitário de Pacote para especificar um nome e um local do pacote.

O utilitário Executar Pacote (dtexecui.exe) sempre executa um pacote no computador local, mesmo que o pacote seja salvo em um servidor remoto. Se o pacote remoto usa arquivos de configuração que também são salvos no servidor remoto, o utilitário Executar pacote pode não localizar as configurações e o pacote falha. Para evitar esse problema, as configurações devem ser referenciadas usando um nome de compartilhamento UNC (Convenção de Nomenclatura Universal) como \\myserver\myfile.

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 tem o seguinte conjunto de opções.

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Opções dinâmicas

Origem do pacote = SQL Server

Servidor
Digite o nome do servidor onde o pacote reside ou selecione um servidor na lista.

Faça logon no servidor
Especifique se o pacote deve usar a Autenticação do Windows ou a Autenticação do SQL Server para se conectar ao SQL Server. A Autenticação do Windows é recomendada para uma melhor segurança. Com a Autenticação do Windows, não é necessário especificar um nome de utilizador e uma palavra-passe.

Usar a 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.

Utilizar a 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 de uma conexão não confiável, o SQL Server executa a autenticação verificando se uma conta de logon do SQL Server foi configurada e se a senha especificada corresponde à registrada anteriormente. Se o SQL Server não conseguir localizar a conta de logon, a autenticação falhará e o usuário receberá uma mensagem de erro.

Embalagem
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 SSIS.

Origem do pacote = Sistema de arquivos

Embalagem
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 apenas os arquivos que têm a extensão .dtsx.

Origem do Pacote = Repositório de Pacotes SSIS

Servidor
Digite o nome do computador onde o pacote reside ou selecione um computador na lista.

Faça logon no servidor
Especifique se o pacote deve usar a Autenticação do Microsoft Windows para se conectar à origem do pacote. A Autenticação do Windows é recomendada para uma melhor segurança. Com a Autenticação do Windows, não é necessário especificar um nome de utilizador e uma palavra-passe.

Usar a 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.

Utilizar a Autenticação do SQL Server
Essa opção não está disponível quando você executa um pacote armazenado no Repositório de Pacotes SSIS.

Embalagem
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 SSIS.

Página Configurações

Use a página Configurações da caixa de diálogo Utilitário do Pacote de Execução para selecionar os arquivos de configuração a serem carregados em tempo de execução e especificar a ordem em que eles são carregados.

Opções

Arquivos de configuração
Lista as configurações que o pacote usa. Cada arquivo de configuração adiciona uma opção de nome de arquivo /CONFIGFILE ao prompt de comando.

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

Adicionar
Clique para adicionar configurações usando a caixa de diálogo Abrir . Por padrão, a caixa de diálogo lista apenas os arquivos que têm a extensão .dtsconfig.

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

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Página Arquivos de Comando

Use a página Arquivos de Comando da caixa de diálogo Utilitário de Pacote de Execução para selecionar os arquivos de comando a serem carregados em tempo de 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 opções de linha de comando.

Teclas de seta
Selecione um arquivo de comando na lista e use as teclas de seta à direita para alterar a ordem de carregamento. Os arquivos de comando são carregados em ordem, começando no topo da lista.

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

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

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Página Gestores de Conexões

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

Opções

Gestor de Ligações
Selecione a caixa de seleção para tornar a coluna Cadeia de Conexão editável.

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 o string de ligação de um gestor de conexões. Este campo só pode ser editado quando a caixa de verificação Gestor de ligações está selecionada.

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

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

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

Opções

Pacote de falha em avisos de validação
Indique se o pacote falha se ocorrer um aviso de validação.

Validar pacote sem executar
Indique se o pacote é apenas validado.

Máximo de executáveis simultâneos
Indique se você deseja especificar o número máximo de executáveis que podem ser executados no pacote ao mesmo tempo. Depois de marcar essa caixa de seleção, use a caixa giratória para especificar o número máximo de executáveis.

Ativar pontos de verificação de pacote
Indique se os pontos de verificação do pacote devem ser habilitados.

Arquivo de ponto de verificação
Liste o arquivo de ponto de verificação que o pacote usa, se você habilitar os pontos de verificação do pacote.

Navegar
Clique no botão Procurar (...) para localizar o arquivo de ponto de verificação usando a caixa de diálogo Abrir, se você ativar os pontos de verificação do pacote de software. Se um arquivo de ponto de verificação já estiver especificado, ele será substituído pelo arquivo selecionado.

Sobrepor opções de reinicialização
Indique se deseja substituir as opções de reinicialização, caso sejam ativados os pontos de verificação do pacote.

Opção de reinicialização
Selecione como usar pontos de verificação, se você substituir as opções de reinicialização.

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Página de relatórios

Use a página Relatórios do Utilitário de Execução de Pacote para especificar os eventos e informações sobre o pacote para serem registados no console quando o pacote for executado.

Opções

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

Nenhum
Selecione para não haver relatório.

Erros
Selecione esta opção para relatar mensagens de erro.

Avisos
Selecione esta opção para denunciar mensagens de aviso.

Eventos personalizados
Selecione esta opção para relatar mensagens de eventos personalizadas.

Eventos de pipeline
Selecione esta opção para relatar mensagens de eventos de fluxo de dados.

Informações
Selecione esta opção para reportar mensagens de informação.

Verbose
Selecione para usar relatórios detalhados.

Log da consola
Especifique as informações que você deseja gravar no log quando o evento selecionado ocorrer.

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

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

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

Nome da fonte
Selecione para relatar o nome do pacote.

GUID de origem
Selecione para reportar o GUID do pacote.

GUID de execução
Selecione para reportar o GUID da instância de execução do pacote.

Mensagem
Selecione para denunciar mensagens.

Hora de início e hora de fim
Selecione esta opção para relatar quando o pacote começou e terminou.

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Página de registo

Use a página Logging da caixa de diálogo Executar Utilitário de Pacote para tornar os provedores de log disponíveis ao pacote em tempo de execução. Forneça o tipo de fornecedor de log de pacote e a string de conexão para ligação ao log. Cada entrada do provedor de log adiciona uma opção classid /LOGGER ao prompt de comando.

Opções

Provedor de log
Selecione um provedor de log na lista.

Cadeia de configuração
Selecione o nome do gestor de conexões do pacote que indica a localização do registo, ou digite a string de conexão ao provedor de registo.

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

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Página de Definição de Valores

Use a página Definir Valores da caixa de diálogo Executar Utilitário de Pacote para definir os valores de propriedade de pacotes, executáveis, conexões, variáveis e provedores de log digitando os caminhos das propriedades e os valores de propriedade. Cada entrada de caminho adiciona uma opção /SETpropertypath;value para o 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, o ponto (.) para indicar que o item a seguir é uma propriedade e colchetes para indicar um membro da coleção. O membro pode ser identificado pelo seu índice ou pelo seu 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 um caminho de propriedade e clique para removê-lo.

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Página de verificação

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

Opções

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

Verificar a compilação do pacote
Selecione esta opção para verificar a compilação do pacote.

Construir
Especifique o número de compilação sequencial associado à compilação.

Verificar ID do pacote
Selecione esta opção 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 o 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
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Página de linha de comando

Use o nó Linha de Comando da caixa de diálogo Executar Utilitário do Pacote para editar a linha de comando que foi gerada pelas opções criadas pelas várias caixas de diálogo.

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 de linha de comando originais.

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

Linha de comandos
Exibe a linha de comando atual. Editável se você selecionou a opção para editar a linha de comando manualmente.

Executar
Clique para executar o pacote.

Fechar
Para fechar a caixa de diálogo Executar Utilitário de Pacote, clique.

Ver também

Utilitário dtexec