Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a: 
SQL Server SSIS Integration Runtime em Azure Data Factory
As variáveis armazenam valores que um pacote e os seus contentores, tarefas e gestores de eventos podem usar em tempo de execução. Para obter mais informações, consulte Variáveis dos Serviços de Integração (SSIS).
Pode disponibilizar variáveis existentes para acesso apenas de leitura ou leitura/escrita através do seu script personalizado, inserindo listas de variáveis delimitadas por vírgulas nos campos ReadOnlyVariables e ReadWriteVariables na página Script do Script Transformation Editor. Lembra-te que os nomes das variáveis são distinguíveis de maiúsculas e maiúsculas. Use a propriedade Valor para ler e escrever em variáveis individuais. O componente Script trata de qualquer bloqueio necessário nos bastidores enquanto o seu script manipula as variáveis em tempo de execução.
Importante
A coleção de ReadWriteVariables está disponível apenas no método PostExecute para maximizar o desempenho e minimizar o risco de conflitos de bloqueio. Portanto, não pode incrementar diretamente o valor de uma variável de pacote à medida que processa cada linha de dados. Incremente o valor de uma variável local e defina o valor da variável package para o valor da variável local no método PostExecute após todos os dados terem sido processados. Também pode usar a VariableDispenser propriedade para contornar esta limitação, conforme descrito mais adiante neste tópico. No entanto, escrever diretamente para uma variável de pacote à medida que cada linha é processada afetará negativamente o desempenho e aumentará o risco de conflitos de bloqueio.
Para mais informações sobre a página de Script do Editor de Transformação de Scripts, consulte Configuring the Script Component in the Script Component Editor e Script Transformation Editor (Script Page).
O componente Script cria uma classe de coleção de variáveis no item do projeto ComponentWrapper com uma propriedade de acesso fortemente tipada para o valor de cada variável pré-configurada, onde a propriedade tem o mesmo nome da própria variável. Esta coleção é exposta através da propriedade Variables da classe ScriptMain . A propriedade do acessório fornece permissão de apenas leitura ou leitura/escrita para o valor da variável, conforme apropriado. Por exemplo, se adicionou uma variável inteira chamada MyIntegerVariable à lista ReadOnlyVariables , pode recuperar o seu valor no seu script usando o seguinte código:
Dim myIntegerVariableValue As Integer = Me.Variables.MyIntegerVariable
Também pode usar a VariableDispenser propriedade, acedida ao chamar Me.VariableDispenser, para trabalhar com variáveis no componente Script. Neste caso, não está a usar as propriedades de acesso tipadas e nomeadas para variáveis, mas sim a aceder diretamente às variáveis. Ao usar o VariableDispenser, deve tratar tanto da semântica de bloqueio como do casting dos tipos de dados para valores variáveis no seu próprio código. Tens de usar a VariableDispenser propriedade em vez das propriedades do acessório nomeadas e tipadas se quiseres trabalhar com uma variável que não está disponível em tempo de design mas é criada programaticamente em tempo de execução.