Compartilhar via


Componente Script

O componente Script hospeda o script e permite que um pacote inclua e execute um código de script personalizado. Você pode usar o componente Script em pacotes para as seguintes finalidades:

  • Aplicar várias transformações a dados em vez de usar transformações múltiplas no fluxo de dados. Por exemplo, um script pode adicionar os valores em duas colunas e depois calcular a média da soma.

  • Acessar regras de negócio em um assembly .NET existente. Por exemplo, um script pode aplicar uma regra de negócio que especifica um intervalo de valores válidos em uma coluna Income.

  • Usar fórmulas e funções personalizadas além das funções e dos operadores fornecidas pela gramática de expressão do Integration Services. Por exemplo, validar números de cartão de crédito que usam a fórmula de LUHN.

  • Validar dados de coluna e ignorar registros que contêm dados inválidos. Por exemplo, um script pode avaliar a racionalidade de um valor de postagem e ignorar registros com quantias extremamente altas ou baixas.

O componente Script fornece um modo fácil e rápido para incluir funções personalizadas em um fluxo de dados. Porém, se você planeja reutilizar o código de script em vários pacotes, deveria considerar programação de componente personalizado em vez de usar o componente Script. Para obter mais informações, consulte Desenvolvendo um componente de fluxo de dados personalizado.

ObservaçãoObservação

Se o componente Script contiver um script que tenta ler o valor de uma coluna que é NULL, esse componente falhará quando você executar o pacote. É recomendável que o script use o método IsNull para determinar se a coluna é NULL antes de tentar ler o valor da coluna.

O componente Script pode ser usado como uma origem, uma transformação ou um destino. Esse componente oferece suporte a uma entrada e várias saídas. Dependendo de como o componente é usado, ele oferece suporte a uma entrada ou saídas, ou ambas. O script é invocado por toda linha na entrada ou saída.

  • Se usado como origem, o componente Script oferece suporte a várias saídas.

  • Se usado como transformação, o componente Script oferece suporte a uma entrada e a várias saídas.

  • Se usado como destino, o componente Script oferece suporte a uma entrada.

O componente Script não oferece suporte a saídas de erro.

Depois de decidir que o componente Script é a escolha adequada para seu pacote, você precisa configurar as entradas e saídas, desenvolver o script usado pelo componente e configurar o próprio componente.

Compreendendo os modos do componente Script

No Designer SSIS, o componente Script tem dois modos: modo do design de metadados e modo do design de código. No modo design de metadados, você pode adicionar e modificar as entradas e saídas do componente Script, mas não pode escrever código. Depois que todas as entradas e saídas são configuradas, você troca para o modo do design de código para escrever o script. O componente Script gera automaticamente o código base a partir dos metadados das entradas e saídas. Se você alterar os metadados depois que o componente Script gerar o código base, talvez seu código não seja compilado porque o código base atualizado pode ser incompatível com seu código.

Escrevendo o Script que o componente usa

O componente Script usa o Microsoft Visual Studio Tools for Applications (VSTA) como o ambiente em que os scripts são gravados. Você acessa o VSTA no Editor de Transformação Scripts. Para obter mais informações, consulte Editor de Transformação Scripts (página Script).

O componente Script fornece um projeto VSTA que inclui uma classe gerada automaticamente, nomeada ScriptMain, que representa os metadados do componente. Por exemplo, se o componente Script for usado como uma transformação que tem três saídas, o ScriptMain incluirá um método para cada saída. O ScriptMain é o ponto de entrada para o script.

O VSTA inclui todos os recursos padrão do ambiente Visual Studio, como o editor Visual Studio codificado por cor, o IntelliSense e o Object Browser. O script usado pelo componente Script é armazenado na definição de pacote. Quando você está projetando o pacote, o código de script é gravado temporariamente em um arquivo de projeto.

O VSTA dá suporte às linguagens de programação Microsoft Visual C# e Microsoft Visual Basic.

Para obter informações sobre como programar o componente Script, consulte Estendendo o fluxo de dados com o componente Script. Para obter mais informações específicas sobre como configurar o componente Script como origem, transformação ou destino, consulte Desenvolvendo tipos específicos de componentes Script. Para obter exemplos adicionais como um destino de ODBC que demonstra o uso do componente Script, consulte Exemplos de componentes Script adicionais.

ObservaçãoObservação

Ao contrário das versões anteriores em que você podia indicar se os scripts eram pré-compilados, todos os scripts são pré-compilados no SQL Server 2008 Integration Services (SSIS) e em versões posteriores. Quando um script é pré-compilado, o mecanismo de linguagem não é carregado no tempo de execução e o pacote é executado mais rapidamente. No entanto, arquivos binários pré-compilados consomem um espaço significativo em disco.

Configurando o componente Script

Você pode configurar o componente Script das seguintes maneiras:

  • Selecione as colunas de entrada para referência.

    ObservaçãoObservação

    Você pode configurar só uma entrada quando usar o Designer SSIS.

  • Forneça o script que o componente é executado.

  • Especifique a linguagem do script.

  • Forneça listas separadas por vírgula das variáveis de somente leitura e gravação/leitura.

  • Adicione mais saídas e adicione colunas de saída atribuídas ao script.

Você pode definir propriedades por meio do Designer SSIS ou programaticamente.

Configurando o componente Script no Designer

Para obter mais informações sobre as propriedades que podem ser definidas na caixa de diálogo Editor de Transformação Scripts, clique em um dos seguintes tópicos:

Para obter mais informações sobre como definir essas propriedades no Designer SSIS, clique no seguinte tópico:

Configurando o componente Script programaticamente

Para obter mais informações sobre as propriedades que podem ser definidas na janela Propriedades ou programaticamente, clique em um dos seguintes tópicos:

Para obter mais informações sobre como definir propriedades, clique em um dos tópicos a seguir:

Conteúdo relacionado

Transformações do Integration Services

Estendendo o fluxo de dados com o componente Script

Ícone do Integration Services (pequeno) Mantenha-se atualizado com o Integration Services

Para obter os downloads, artigos, exemplos e vídeos mais recentes da Microsoft, assim como soluções selecionadas pela comunidade, visite a página do Integration Services no MSDN:


Para receber uma notificação automática dessas atualizações, assine os RSS feeds disponíveis na página.