Partilhar via


Função Union (Construtor de Relatórios e SSRS)

Retorna a união de todos os valores numéricos não nulos especificados pela expressão, avaliados no escopo fornecido.

ObservaçãoObservação

Você pode criar e modificar definições de relatório (.rdl) no Construtor de Relatórios e no Designer de Relatórios no SQL Server Data Tools. Cada ambiente de criação fornece modos diferentes para criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Partes de Relatório (Construtor de Relatórios e SSRS) e Partes de Relatório no Designer de Relatórios (SSRS) na Web em microsoft.com.

Sintaxe

Union(expression, scope, recursive)

Parâmetros

  • expression
    (SqlGeometry ou SqlGeography) A expressão na qual executar a agregação.

  • scope
    (String) Opcional. O nome de um conjunto de dados, um grupo ou uma região de dados que contém os itens de relatório aos quais a função de agregação deve ser aplicada. Se scope não estiver especificado, será usado o escopo atual.

  • recursive
    (Tipo Enumerado) Opcional. Simple (padrão) ou RdlRecursive. Especifica se a agregação deve ser executada recursivamente.

Retorno

Retorna um objeto espacial, SqlGeometry ou SqlGeography, com base no tipo de expressão. Para obter mais informações sobre os tipos de dados espaciais SqlGeometry e SqlGeography, consulte Visão geral de tipos de dados espaciais.

Comentários

O conjunto de dados especificado na expressão deve ter o mesmo tipo de dados.

O valor de scope deve ser uma constante de cadeia de caracteres e não pode ser uma expressão. Para agregações externas ou que não especificam outras agregações, scope deve se referir ao escopo atual ou a um escopo contentor. Não há suporte para escopos de conjunto de dados. Para agregações de agregações, as agregações aninhadas podem especificar um escopo filho.

Expression pode conter chamadas para funções de agregação aninhadas com as seguintes exceções e condições:

  • Scope para agregações aninhadas deve ser igual ao escopo da agregação externa ou deve estar contido nela. Para todos os escopos distintos na expressão, um escopo deve estar em uma relação filho com todos os outros escopos.

  • Scope para agregações aninhadas não pode ser o nome de um conjunto de dados.

  • Expression não deve conter a função First, Last, Previous ou RunningValue.

  • Expression não deve conter agregações aninhadas que especifiquem recursive.

Para obter mais informações, consulte Referência de funções de agregação (Construtor de Relatórios e SSRS) e Escopo das expressões para totais, agregações e coleções internas (Construtor de Relatórios e SSRS).

Para obter mais informações sobre agregações recursivas, consulte Criando grupos de hierarquias recursivas (Construtor de Relatórios e SSRS).

Exemplo

A tabela a seguir mostra exemplos de expressões SqlGeometry e expressões de resultado Union, mostradas no formato WKT (Well Known Text) para dados espaciais.

Campo com dados espaciais

Exemplo

Resultado de Union

[PointLocation]

POINT(1 2)

POINT(3 4)

MULTIPOINT((1 2), (3 4))

[PathDefinition]

LINESTRING(1 2, 3 4)

LINESTRING(5 6, 7 8)

MULTILINESTRING((7 8, 5 6), (3 4, 1 2))

[PolygonDefinition]

POLYGON((1 2, 3 4, 5 2, 1 2))

POLYGON((-1 2, -3 4, -5 2, -1 2))

MULTIPOLYGON(((1 2, 5 2, 3 4, 1 2)), ((-5 2, -1 2, -3 4, -5 2)))

=Union(Fields!PointLocation.Value)
=Union(Fields!PathDefinition.Value)
=Union(Fields!PolygonDefinition.Value, "Group1")

Consulte também

Referência

Exemplos de expressões (Construtor de Relatórios e SSRS)

Conceitos

Uso de expressões em relatórios (Construtor de Relatórios e SSRS)

Tipos de dados em expressões (Construtor de Relatórios e SSRS)

Escopo das expressões para totais, agregações e coleções internas (Construtor de Relatórios e SSRS)