Compartilhar via


Editor da Tarefa Executar SQL (página Geral)

Use a página Geral da caixa de diálogo Editor da Tarefa Executar SQL para configurar a tarefa Executar SQL e fornecer a instrução SQL executada pela tarefa.

Para saber mais sobre essa tarefa, consulte Tarefa Executar SQL e Parâmetros e códigos de retorno na Tarefa Executar SQL e Conjuntos de resultados na tarefa Executar SQL. Para saber mais sobre a linguagem de consulta Transact-SQL, confiraReferência de Transact-SQL (Mecanismo de Banco de Dados).

Opções estáticas

Nome
Forneça um nome exclusivo para a tarefa Executar SQL no fluxo de trabalho. O nome fornecido será exibido no Designer do SSIS .

Descrição
Descreva a tarefa Executar SQL. Como prática recomendável, para tornar os pacotes autodocumentados e mais fáceis de manter, descreva a tarefa de acordo com a sua finalidade.

TimeOut
Especifique o número máximo de segundos que a tarefa será executada antes de exceder o tempo limite. O valor 0 indica que não há limite de tempo. O padrão é 0.

Observação

Procedimentos armazenados não atingirão o tempo limite se emularem uma funcionalidade de suspensão fornecendo um tempo para que as conexões sejam estabelecidas e as transações completadas sejam maior que o número de segundos especificados pelo TimeOut. Porém, os procedimentos armazenados que executam as consultas estão sempre sujeitos à restrição de tempo especificada pelo TimeOut.

CodePage
Especifique a página de código a ser usada ao converter valores Unicode em variáveis. O valor padrão é a página de código do computador local.

Observação

Quando a tarefa Executar SQL usa um gerenciador de conexões ADO ou ODBC, a propriedade CodePage não fica disponível. Se a sua solução requer o uso de uma página de código, utilize um gerenciador de conexões OLE DB ou ADO.NET com a tarefa Executar SQL.

TypeConversionMode
Quando você definir essa propriedade como Allowed, a Tarefa Executar SQL tentará converter o parâmetro de saída e os resultados da consulta no tipo de dados da variável à qual os resultados estão atribuídos. Isso se aplica ao tipo de conjunto de resultados de Linha única .

ResultSet
Especifique o tipo de resultado esperado pela instrução SQL que está sendo executada. Escolha entre Linha Simples, Conjunto de Resultados Completo, XML, ou Nenhum.

ConnectionType
Escolha o tipo de gerenciador de conexões a ser usado para conectar-se à fonte de dados. Os tipos de conexão disponíveis incluem OLE DB, ODBC, ADO, ADO.NET e SQLMOBILE.

Tópicos relacionados: Gerenciador de conexões do OLE DB, Gerenciador de conexões ODBC, Gerenciador de conexões ADO, Gerenciador de conexões ADO.NET, Gerenciador de conexões do SQL Server Compact Edition

Conexão
Escolha a conexão a partir de uma lista definida de gerenciadores de conexões. Para criar uma nova conexão, selecione <Nova conexão...>.

SQLSourceType
Selecione o tipo de origem da instrução SQL que a tarefa executa.

Dependendo do tipo de gerenciador de conexões que a tarefa Executar SQL utiliza, você deve usar marcadores de parâmetro específicos em instruções SQL com parâmetros.

Tópicos Relacionados: seção Executando comandos SQL com parâmetros em Tarefa Executar SQL

As opções dessa propriedade são listadas na tabela a seguir.

Valor Descrição
Entrada Direta Defina a fonte como uma instrução Transact-SQL. Selecionando esse valor, a opção dinâmica Instrução SQLé exibida.
Conexão do Arquivo Selecione um arquivo que contém uma instrução Transact-SQL. Definindo essa opção, a opção dinâmica FileConnectioné exibida.
Variável Defina a fonte como uma variável que identifique a instrução Transact-SQL. Selecionando esse valor, a opção dinâmica SourceVariableé exibida.

QueryIsStoredProcedure
Indica se a instrução SQL especificada a ser executada é um procedimento armazenado. Essa propriedade será de somente leitura/gravação se a tarefa usar o gerenciador de conexões ADO. Caso contrário a propriedade será somente leitura e seu valor será false.

BypassPrepare
Indique se a instrução SQL está preparada. true ignora a preparação; false prepara a instrução SQL antes de executá-la. Essa opção só está disponível com conexões OLE DB que dão suporte à preparação.

Tópicos relacionados: Execução preparada

Procurar
Localize um arquivo que contém uma instrução SQL usando a caixa de diálogo Abrir . Selecione um arquivo para copiar o conteúdo do arquivo como uma instrução SQL para a propriedade SQLStatement .

Construir Consulta
Crie uma instrução SQL usando a caixa de diálogo Construtor de Consultas , uma ferramenta gráfica usada para criar consultas. Esta opção está disponível quando a opção SQLSourceType é definida como Entrada Direta.

Analisar Consulta
Valide a sintaxe da instrução SQL.

Opções dinâmicas SQLSourceType

SQLSourceType = Entrada direta

SQLStatement
Digite a instrução SQL a ser executada na caixa de opções ou clique no botão Procurar (...) para digitar a instrução SQL na caixa de diálogo Inserir Consulta SQL ou clique em Construir Consulta para redigir a instrução usando a caixa de diálogo Construtor de Consultas.

Tópicos relacionados: Construtor de Consultas

SQLSourceType = Conexão do Arquivo

FileConnection
Selecione um gerenciador de conexões de arquivos existente ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

Tópicos relacionados: File Connection Manager, File Connection Manager Editor

SQLSourceType = Variável

SourceVariable
Selecione uma variável existente ou clique em <Nova variável...> para criar uma nova variável.

Tópicos relacionados: Variáveis do Integration Services (SSIS), Adicionar variável

Confira também

Referência de mensagens e erros do Integration Services
Editor da Tarefa Executar SQL (página Mapeamento de parâmetros)
Editor da Tarefa Executar SQL (página Conjunto de Resultados)