Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
Construtor de Relatórios da Microsoft (SSRS) Designer de Relatórios do Power BI no SQL Server Data Tools
Para incluir valores agregados no seu relatório paginado, pode usar funções agregadas incorporadas nas expressões. A função agregada padrão para campos numéricos é SUM. Pode editar a expressão e usar uma função agregada incorporada diferente ou especificar um âmbito diferente. O âmbito identifica qual o conjunto de dados a utilizar para o cálculo.
À medida que o processador de relatórios combina os dados do relatório e o layout do relatório, as expressões para cada item do relatório são avaliadas. À medida que visualiza cada página do relatório, vê os resultados de cada expressão nos itens do relatório renderizados.
A tabela seguinte lista categorias de funções incorporadas que pode incluir numa expressão:
Para determinar os escopos válidos para uma função, consulte o tópico de referência de função individual. Para mais informações e exemplos, consulte Escopo de Expressão para Totais, Agregados e Coleções Incorporadas (Construtor de Relatórios e SSRS).
Observação
Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, no Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.
Funções Agregadas Incorporadas
As seguintes funções incorporadas calculam valores de resumo para um conjunto de dados numéricos não nulos no âmbito padrão ou no âmbito nomeado.
| Function | Descrição |
|---|---|
| Preço médio | Devolve a média de todos os valores numéricos não nulos especificados pela expressão, avaliados no âmbito dado. |
| Contagem | Devolve uma contagem de valores não nulos especificados pela expressão, avaliados no contexto do âmbito dado. |
| ContagemDistinto | Devolve uma contagem de todos os valores não nulos distintos especificados pela expressão, avaliados no contexto do âmbito dado. |
| Máx. | Devolve o valor máximo de todos os valores numéricos não nulos especificados pela expressão, no contexto do âmbito dado. Podes usar isto para especificar o valor máximo de um eixo gráfico para controlar a escala. |
| Min | Devolve o valor mínimo de todos os valores numéricos não nulos especificados pela expressão, no contexto do âmbito dado. Podes usar isto para especificar o valor mínimo de um eixo gráfico para controlar a escala. |
| StDev | Devolve o desvio padrão de todos os valores numéricos não nulos especificados pela expressão, avaliados no âmbito dado. |
| StDevP | Devolve o desvio padrão populacional de todos os valores numéricos não nulos especificados pela expressão, avaliado no contexto do âmbito dado. |
| Sum | Devolve a soma de todos os valores numéricos não nulos especificados pela expressão, avaliados no âmbito dado. |
| União | Devolve a união de todos os valores de dados espaciais não nulos do tipo SqlGeometry ou SqlGeography especificados pela expressão, avaliados no âmbito dado. |
| Var | Devolve a variância de todos os valores numéricos não nulos especificados pela expressão, avaliados no âmbito dado. |
| VarP | Devolve a variância populacional de todos os valores numéricos não nulos especificados pela expressão, avaliada no contexto do âmbito dado. |
Voltar ao topo
Restrições a Campos, Coleções e Funções Agregadas Incorporadas
A tabela seguinte resume as restrições nas localizações dos relatórios sobre onde pode adicionar expressões que contenham referências a coleções globais incorporadas.
| Localização no Relatório | Campos | Parâmetros | ReportItems | Número da página TotalPages |
Fonte de dados Conjunto de dados |
Variáveis | RenderFormat |
|---|---|---|---|---|---|---|---|
| Cabeçalho da página Rodapé da página |
Yes | Yes | No máximo, um Nota 1 |
Yes | Yes | Yes | Yes |
| Body | Yes Nota 2 |
Yes | Apenas itens no âmbito atual ou num âmbito de contenção Nota 3 |
Não | Yes | Yes | Yes |
| Parâmetro de Relatório | Não | Apenas parâmetros anteriores na lista Nota 4 |
Não | Não | Não | Não | Não |
| Campo | Yes | Yes | Não | Não | Não | Não | Não |
| Parâmetro de consulta | Não | Yes | Não | Não | Não | Não | Não |
| Expressão de grupo | Yes | Yes | Não | Não | Yes | Não | Não |
| Expressão de classificação | Yes | Yes | Não | Não | Yes | Yes Nota 5 |
Não |
| Expressão de filtro | Yes | Yes | Não | Não | Yes | Yes Nota 6 |
Não |
| Código | Não | Yes Nota 7 |
Não | Não | Não | Não | Não |
| Relatório.Língua | Não | Yes | Não | Não | Não | Não | Não |
| Variáveis | Yes | Yes | Não | Não | Yes | Âmbito atual ou escopo de contenção | Não |
| Agregados | Yes | Yes | Apenas no cabeçalho/rodapé da página | Apenas nas agregaçōes de itens de relatório | Yes | Não | Não |
| Funções de pesquisa | Yes | Yes | Yes | Não | Yes | Não | Não |
Nota 1. Os ReportItems devem existir na página de relatório renderizado, ou o seu valor é Nulo. Se a visibilidade de um item do relatório depender de uma expressão que avalia como False, o item do relatório não existe na página.
Nota 2. Se uma referência de campo for usada num âmbito de grupo, e a referência de campo não estiver incluída na expressão do grupo, então o valor para o campo é indefinido, a menos que exista apenas um valor no escopo. Para especificar um valor, use First ou Last e o âmbito do grupo.
Nota 3. Expressões que incluem uma referência a ReportItems podem especificar valores para outros ReportItems no mesmo âmbito de grupo ou num âmbito de grupo que contém.
Nota 4. Os valores das propriedades para parâmetros anteriores podem ser nulos.
Nota 5. Apenas em formulários de membros. Não é possível usar expressões de ordenação por região de dados.
Nota 6. Apenas nos filtros de Membro. Não se podem utilizar nas expressões de filtro de regiões de dados ou de conjuntos de dados.
Nota 7. A coleção de Parâmetros só é inicializada depois de o bloco de código ser processado, pelo que métodos não podem ser usados para controlar parâmetros na inicialização.
Nota 8. O tipo de dado para todos os agregados, exceto Count e CountDistinct, deve ser o mesmo tipo de dado, ou nulo, para todos os valores.
Voltar ao topo
Restrições aos Agregados Aninhados
A tabela seguinte resume as restrições sobre quais funções agregadas podem especificar outras funções agregadas como agregados aninhados.
| Context | RunningValue | Número da linha | First Último |
Anterior | Soma e outras funções de pré-classificação | Agregados de ReportItem | Funções de pesquisa | Função de Agregação |
|---|---|---|---|---|---|---|---|---|
| Valor em Execução | Não | Não | Não | Não | Yes | Não | Yes | Não |
| First Último |
Não | Não | Não | Não | Yes | Não | Não | Não |
| Anterior | Yes | Yes | Yes | Não | Yes | Não | Yes | Não |
| Soma e outras funções de pré-classificação | Não | Não | Não | Não | Yes | Não | Yes | Não |
| Agregados de ReportItem | Não | Não | Não | Não | Não | Não | Não | Não |
| Funções de pesquisa | Yes | Yes Nota 1 |
Yes Nota 1 |
Yes Nota 1 |
Yes Nota 1 |
Yes Nota 1 |
Não | Não |
| Função de Agregação | Não | Não | Não | Não | Não | Não | Não | Não |
- Nota 1. As funções agregadas só são permitidas dentro da expressão Fonte de uma função de Consulta se a função de Consulta não estiver contida num agregado. Funções agregadas não são permitidas dentro das expressões de Destino ou Resultado de uma função de Pesquisa.
Voltar ao topo
Cálculo de Valores em Execução
As seguintes funções incorporadas calculam valores contínuos para um conjunto de dados. RowNumber é semelhante ao RunningValue, pois devolve o valor em execução de uma contagem que incrementa para cada linha dentro do escopo contido. O parâmetro de âmbito para estas funções deve especificar um âmbito de contenção, que controla quando a contagem reinicia.
| Function | Descrição |
|---|---|
| Número de Linha | Devolve uma contagem contínua do número de linhas para o âmbito especificado. A função RowNumber reinicia a contagem em 1, não em 0. |
| RunningValue | Devolve um agregado contínuo de todos os valores numéricos não nulos especificados pela expressão, avaliados para o âmbito dado. |
Voltar ao topo
Recuperação de contagens de linhas
A função incorporada seguinte calcula o número de linhas no âmbito dado. Use esta função para contar todas as linhas, incluindo as linhas com valores nulos.
| Function | Descrição |
|---|---|
| CountRows | Devolve o número de linhas no âmbito especificado, incluindo linhas com valores nulos. |
Voltar ao topo
Consulta de Valores de Outro Conjunto de Dados
As seguintes funções de consulta recuperam valores de um conjunto de dados especificado.
| Function | Descrição |
|---|---|
| Função de Pesquisa | Devolve um valor de um conjunto de dados para uma expressão especificada. |
| Função LookupSet | Devolve um conjunto de valores de um conjunto de dados para uma expressão especificada. |
| Função de Multiconsulta | Devolve o conjunto de valores de primeira correspondência para um conjunto de nomes de um conjunto de dados que contém pares nome/valor. |
Voltar ao topo
Recuperação de Valores Dependentes de Ordenação
As seguintes funções incorporadas retornam o primeiro, último ou valor anterior dentro de um determinado âmbito. Estas funções dependem da ordem de ordenação dos valores dos dados. Use estas funções, por exemplo, para encontrar o primeiro e o último valor de uma página para criar um cabeçalho de página ao estilo de dicionário. Use o Anterior para comparar um valor numa linha com o valor da linha anterior dentro de um âmbito específico, por exemplo, para encontrar valores percentuais ano a ano numa tabela.
| Function | Descrição |
|---|---|
| Primeira | Devolve o primeiro valor no âmbito dado da expressão especificada. |
| Última | Devolve o último valor no âmbito dado da expressão especificada. |
| Anterior | Devolve o valor ou o valor agregado especificado para a instância anterior de um item dentro do âmbito especificado. |
Voltar ao topo
Recuperação de Agregados do Servidor
A seguinte função incorporada recupera agregados personalizados do fornecedor de dados. Por exemplo, ao utilizar um tipo de fonte de dados do Analysis Services, pode recuperar agregados calculados no servidor dessa fonte de dados para os utilizar num cabeçalho de grupo.
| Function | Descrição |
|---|---|
| Agregado | Devolve um agregado personalizado da expressão especificada, conforme definido pelo fornecedor de dados. |
Voltar ao topo
Testes para o âmbito
A seguinte função incorporada testa o contexto atual de um item de relatório para verificar se este pertence a um âmbito específico.
| Função | Description |
|---|---|
| InScope | Indica se a instância atual de um item está dentro do âmbito especificado. |
Voltar ao topo
Recuperação do Nível Recursivo
A função incorporada seguinte recupera o nível atual quando uma hierarquia recursiva é processada. Use o resultado desta função com a propriedade Padding numa caixa de texto para controlar o nível de indentação de uma hierarquia visual para um grupo recursivo. Para mais informações, consulte Criação de Grupos de Hierarquia Recursiva (Construtor de Relatórios e SSRS).
| Função | Description |
|---|---|
| Nível | Devolve o nível atual de profundidade numa hierarquia recursiva. |
Voltar ao topo