As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# lag
<a name="lag-function"></a>

A função `lag` calcula o valor de atraso (anterior) para uma medida com base em partições e classificações especificadas.

`lag` é compatível com o uso em análises baseadas em SPICE e conjuntos de dados de consulta direta.

## Sintaxe
<a name="lag-function-syntax"></a>

São necessários colchetes. Para ver quais argumentos são opcionais, consulte as seguintes descrições.

```
lag
(
lag
(
 measure
 ,[ sortorder_field ASC_or_DESC, ... ] 
 ,lookup_index
 ,[ partition_field, ... ] 
)] 
)
```

## Argumentos
<a name="lag-function-arguments"></a>

*medida*   
A medida para a qual deseja a anterior. Isso pode incluir um agregado, por exemplo `sum({Sales Amt})`.

*campo da ordem de classificação*   
Uma ou mais medidas e dimensões pelas quais deseja classificar os dados, separadas por vírgulas. Você pode especificar a ordem de classificação crescente (**ASC**) ou decrescente (**DESC**).   
Cada campo na lista está entre chaves (\$1\$1), caso seja mais de uma palavra. A lista completa está entre colchetes ([ ]).

*índice de consulta*   
O índice de pesquisa pode ser positivo ou negativo, indicando a seguinte linha na classificação (positiva) ou uma linha na classificação anterior (negativa). O índice de pesquisa pode ser de 1 a 2,147,483,647. Para os mecanismos MySQL, MariaDB e Amazon Aurora com compatibilidade MySQL, o índice de pesquisa é limitado a apenas 1.

 *campo de partição*   
(Opcional) Uma ou mais dimensões pelas quais deseja particionar, separadas por vírgulas.   
Cada campo na lista está entre chaves (\$1\$1), caso seja mais de uma palavra. A lista completa está entre colchetes ([ ]).

## Exemplo
<a name="lag-function-example"></a>

O exemplo a seguir calcula a `sum(sales)` anterior, particionada pelo estado de origem, na ordem de classificação crescente em `cancellation_code`.

```
lag
(
     sum(Sales), 
     [cancellation_code ASC], 
     1, 
     [origin_state_nm]
)
```

O exemplo a seguir usa um campo calculado com `lag` para exibir o valor das vendas da linha anterior ao lado da quantidade da linha atual, classificadas por `Order Date`. Os campos dos cálculos de tabela estão nas fontes de campos do visual.

```
lag(
     sum({Sales}),
     [{Order Date} ASC],
     1
)
```

A captura de tela a seguir mostra os resultados do exemplo.

![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/lagCalc.png)


O exemplo a seguir usa um campo calculado com `lag` para exibir o valor das vendas da linha anterior ao lado da quantidade da linha atual, classificadas por `Order Date` e particionadas por `Segment`.

```
lag
	(
		sum(Sales),
		[Order Date ASC],
		1, [Segment]
	)
```

A captura de tela a seguir mostra os resultados do exemplo.

![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/lagCalc2.png)