Identificadores (SSIS)

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

Nas expressões, identificadores são colunas e variáveis disponíveis para a operação. As expressões podem usar identificadores regulares e qualificados.

Identificadores Regulares

Um identificador regular é um identificador que não necessita de qualificadores adicionais. Por exemplo, MiddleName, uma coluna na tabela Contactos da base de dados AdventureWorks , é um identificador regular.

A nomeação dos identificadores regulares deve seguir estas regras:

• O primeiro carácter do nome deve ser uma letra conforme definido pelo Padrão Unicode 2.0, ou um sublinhado (_).

• Os caracteres subsequentes podem ser letras ou números, conforme definido no Padrão Unicode 2.0, sublinhado (_), @, $ e #.

Importante

Espaços embutidos e caracteres especiais, exceto os listados, não são válidos nos identificadores regulares. Para usar espaços e caracteres especiais, deve usar um identificador qualificado em vez de um identificador normal.

Identificadores Qualificados

Um identificador qualificado é um identificador delimitado por parênteses. Um identificador pode necessitar de um delimitador porque o nome do identificador inclui espaços ou porque o nome do identificador não começa nem por uma letra nem por um sublinhado. Por exemplo, o nome da coluna Nome do Meio deve ser qualificado entre parênteses e escrito como [Nome do Meio] numa expressão.

Se o nome do identificador incluir espaços, ou se o nome não for um nome válido de identificador regular, o identificador deve ser qualificado. O avaliador de expressões utiliza os parênteses de abertura e fecho ([]) para qualificar os identificadores. Os suportes são colocados na primeira e última posição da corda. Por exemplo, o identificador 5$> torna-se [5$>]. Os colchetes podem ser usados com nomes de colunas, nomes de variáveis e nomes de funções.

Se construir expressões usando as caixas de diálogo do SSIS Designer, os identificadores normais são automaticamente colocados entre parênteses. No entanto, os parênteses só são obrigatórios se o nome incluir caracteres inválidos. Por exemplo, a coluna chamada Nome do Meio é válida sem parênteses.

Não pode referenciar nomes de colunas que incluam parênteses nas expressões. Por exemplo, o nome da coluna Column[1] não pode ser usado numa expressão. Para usar a coluna numa expressão, esta deve ser renomeada para um nome sem parênteses.

Identificadores de Linhagem

As expressões podem usar identificadores de linhagem para se referir a colunas. Os identificadores de linhagem são atribuídos automaticamente quando cria o pacote pela primeira vez. Pode visualizar o identificador de linhagem de uma coluna no separador Propriedades da Coluna da caixa de diálogo Editor Avançado no SSIS Designer.

Se se referir a uma coluna usando o seu identificador de linhagem, o identificador deve incluir o prefixo do carácter pound (#). Por exemplo, uma coluna com o identificador de linhagem 147 deve ser referenciada como #147.

Se uma expressão for analisada com sucesso, o avaliador de expressões substitui os identificadores de linhagem por nomes de colunas na caixa de diálogo.

Nomes de Colunas Únicos

Múltiplos componentes usados num pacote podem expor colunas com o mesmo nome. Se estas colunas forem usadas em expressões, devem ser desambiguadas antes que as expressões possam ser analisadas com sucesso. O avaliador de expressões suporta a notação pontilhada para identificar a origem da coluna. Por exemplo, duas colunas chamadas Age tornam-se FlatFileSource.Age e OLEDBSource.Age, o que indica que as suas fontes são FlatFileSource ou OLEDBSource. O analisador trata o nome completamente qualificado como um nome único de coluna.

Os nomes dos componentes de origem e os nomes das colunas são qualificados separadamente. Os exemplos seguintes mostram o uso válido de parênteses numa notação pontilhada:

• O nome do componente de origem inclui espaços.

  [MySo urce].Age  
  

• O primeiro carácter no nome da coluna não é válido.

  MySource.[#Age]  
  

• Os nomes do componente de origem e das colunas contêm caracteres inválidos.

  [MySource?].[#Age]  
  

Importante

Se ambos os elementos na notação pontilhada estiverem incluídos num par de parênteses, o avaliador de expressões interpreta o par como um único identificador, e não como uma combinação fonte-coluna.

Variáveis em expressões

As variáveis, quando referenciadas em expressões, devem incluir o prefixo @. Por exemplo, a variável Counter é referenciada usando @Counter. O carácter @ não faz parte do nome da variável; apenas identifica a variável ao avaliador de expressão. Se construir expressões usando as caixas de diálogo que o SSIS Designer fornece, o carácter @ é automaticamente adicionado ao nome da variável. Não é válido incluir espaços entre o carácter @ e o nome da variável.

Os nomes das variáveis seguem as mesmas regras que os de outros identificadores regulares:

• O primeiro carácter do nome deve ser uma letra conforme definido pelo Padrão Unicode 2.0, ou um sublinhado (_).

• Os caracteres subsequentes podem ser letras ou números, conforme definido no Padrão Unicode 2.0, sublinhado (_), @, $ e #.

Se o nome de uma variável contiver caracteres diferentes dos listados, a variável deve ser incluída entre parênteses. Por exemplo, os nomes das variáveis com espaços devem ser incluídos entre parênteses. O colchete de abertura segue o carácter @. Por exemplo, a variável O Meu Nome é referenciada como @[O Meu Nome]. Não é válido incluir espaços entre o nome da variável e os colchetes.

Observação

Os nomes das variáveis definidas pelo utilizador e do sistema são sensíveis a maiúsculas e minúsculas.

Nomes Únicos de Variáveis

O Integration Services suporta variáveis personalizadas e fornece um conjunto de variáveis do sistema. Por defeito, as variáveis personalizadas pertencem ao espaço de nomes do Utilizador , e as variáveis do sistema pertencem ao espaço de nomes do Sistema . Pode criar namespaces adicionais para variáveis personalizadas e atualizar os nomes dos namespaces para se adequarem às necessidades da sua aplicação. O construtor de expressões lista variáveis dentro do âmbito em todos os namespaces.

Todas as variáveis têm âmbito e pertencem a um namespace. Uma variável tem o âmbito do pacote ou o âmbito de um contentor ou tarefa dentro do pacote. O construtor de expressões no SSIS Designer lista apenas as variáveis dentro do escopo. Para obter mais informações, consulte Variáveis do Integration Services (SSIS) e Usar variáveis em pacotes.

As variáveis usadas nas expressões devem ter nomes únicos para o avaliador de expressões avaliar corretamente a expressão. Se um pacote usar múltiplas variáveis com o mesmo nome, os seus espaços de nomes devem ser diferentes. Os Serviços de Integração fornecem um operador de resolução de espaço de nomes, composto por dois-pontos (::), para qualificar uma variável com o seu espaço de nomes. Por exemplo, a expressão seguinte usa duas variáveis chamadas Count; uma pertence ao namespace User e outra ao namespace MyNamespace.

@[User::Count] > @[MyNamespace::Count]  

Importante

Deve incluir a combinação de namespace e nome da variável qualificada entre parênteses para que o avaliador de expressões reconheça a variável.

Se o valor de Count no espaço de nomes User for 10 e o valor de Count no MyNamespace for 2, a expressão é avaliada como verdadeira porque o avaliador de expressões reconhece duas variáveis diferentes.

Se os nomes das variáveis não forem únicos, não ocorre erro. Em vez disso, o avaliador de expressões usa apenas uma instância da variável para avaliar a expressão e retorna um resultado incorreto. Por exemplo, a expressão seguinte destinava-se a comparar os valores (10 e 2) para duas variáveis Count separadas, mas a expressão avalia como falsa porque o avaliador de expressões usa a mesma instância da variável Count duas vezes.

@Count > @Count  

Conteúdo relacionado

Artigo técnico, SSIS Expression Cheat Sheet, sobre pragmaticworks.com