Compartilhar via

Editor da Tarefa Executar SQL (página Geral)

  • Artigo

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 obter informações sobre esta tarefa, consulte Tarefa Executar SQL, Parâmetros e códigos de retorno na Tarefa Executar SQL e Conjuntos de resultados na tarefa Executar SQL. Para obter mais informações sobre a linguagem de consulta Transact-SQL, consulte Referência do 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 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çãoObservação

    Procedimentos armazenados não excederã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çãoObservaçã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 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 estão relacionadas 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 Conexão do Arquivo é 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 Construir Consulta, 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 Digitar Consulta SQL, ou clique em Construir Consulta para redigir a instrução usando a caixa de diálogo Construir Consulta.

    Tópicos relacionados:, Construtor de Consultas.

SQLSourceType = Conexão do Arquivo

SQLSourceType = Variável

Consulte também

Referência

Editor da Tarefa Executar SQL (página Mapeamento de Parâmetros)

Editor da Tarefa Executar SQL (página Conjunto de Resultados)

Conceitos

Referência de mensagens e erros do Integration Services