# AutoNumber

Esse comando cria um valor inteiro exclusivo para cada valor distinto avaliado em um campo encontrado durante a execução do script.

Você também pode usar a função [autonumber - função de script](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/CounterFunctions/autonumber.htm) dentro de uma instrução LOAD, mas isso tem algumas limitações quando você deseja usar uma carga otimizada. Você pode criar uma carga otimizada carregando os dados de um arquivo QVD primeiro e depois usando a instrução AutoNumber para converter valores em teclas de símbolos.

Sintaxe:

AutoNumber \*fieldlist [Using namespace] ]

Argumentos:

Argumentos

| Argumento | Descrição |
| --- | --- |
| \*lista de campos | Uma lista separada por vírgulas dos campos em que os valores devem ser substituídos por um valor inteiro exclusivo.<br><br>Você pode usar os caracteres curinga ? e \* nos nomes dos campos para incluir todos os campos com nomes correspondentes. Você também pode usar \* para incluir todos os campos. Você precisa citar nomes de campo quando curingas forem usados. |
| espaço para nome | OUsing espaço de nomes é opcional. Você poderá usar essa opção se quiser criar um espaço para nome em que valores idênticos em campos diferentes compartilham a mesma chave.<br><br>Se você não usar essa opção, todos os campos terão um índice de chave separado. |

Limitações:

Quando você tem várias instruções LOAD no script, é necessário colocar a instrução AutoNumber após a instrução LOAD final.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Autonumber.htm)

#### Exemplo - script com AutoNumber

## Exemplo de script

Neste exemplo, os dados são carregados primeiro sem o comando AutoNumber. O comando AutoNumber é então adicionado para mostrar o efeito.

### Dados usados no exemplo

Carregue os seguintes dados como um carregamento inline no editor de carregamento de dados para criar o exemplo de script abaixo. Deixe o comando AutoNumber assinalado como texto por enquanto.

```
RegionSales:
LOAD *, 
Region &'|'& Year &'|'& Month as KeyToOtherTable
INLINE
[ Region, Year, Month, Sales
North,	2014,	May,	245
North,	2014,	May,	347
North,	2014,	June,	127
South,	2014,	June,	645
South,	2013,	May, 	367
South,	2013,	May,	221
];
					
Budget:
LOAD Budget,  
Region &'|'& Year &'|'& Month as KeyToOtherTable
INLINE
[Region, Year, Month, Budget
North,  2014,   May,    200
North,  2014,   May,    350
North,  2014,   June,   150
South,  2014,   June,   500
South,  2013,   May,    300
South,  2013,   May,    200
];

//AutoNumber KeyToOtherTable;

```

Para obter mais informações sobre como usar carregamentos inline, consulte [Usando carregamentos inline para carregar dados](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/inline-loads-qs.htm).

### Criar visualizações

Crie duas visualizações de tabela em uma Qlik Sense do Qlik Cloud. Adicione KeyToOtherTable, Region, Year, Month e Sales como dimensões à primeira tabela. Adicione KeyToOtherTable, Region, Year, Month e Budget como dimensões à segunda tabela.

### Resultado

Tabela RegionSales

| KeyToOtherTable | Region | Year | Month | Sales |
| --- | --- | --- | --- | --- |
| North\|2014\|June | North | 2014 | June | 127 |
| North\|2014\|May | North | 2014 | May | 245 |
| North\|2014\|May | North | 2014 | May | 347 |
| South\|2013\|May | South | 2013 | May | 221 |
| South\|2013\|May | South | 2013 | May | 367 |
| South\|2014\|June | South | 2014 | June | 645 |

Tabela Budget

| KeyToOtherTable | Region | Year | Month | Budget |
| --- | --- | --- | --- | --- |
| North\|2014\|June | North | 2014 | June | 150 |
| North\|2014\|May | North | 2014 | May | 200 |
| North\|2014\|May | North | 2014 | May | 350 |
| South\|2013\|May | South | 2013 | May | 200 |
| South\|2013\|May | South | 2013 | May | 300 |
| South\|2014\|June | South | 2014 | June | 500 |

### Explicação

O exemplo mostra um campo composto KeyToOtherTable que vincula as duas tabelas. AutoNumber não é usado. Observe o comprimento dos valores de KeyToOtherTable.

### Adicionar o comando AutoNumber

Remova o comentário do comando AutoNumber no script de carregamento.

```
AutoNumber KeyToOtherTable;
```

### Resultado

Tabela RegionSales

| KeyToOtherTable | Region | Year | Month | Sales |
| --- | --- | --- | --- | --- |
| 1 | North | 2014 | June | 127 |
| 1 | North | 2014 | May | 245 |
| 2 | North | 2014 | May | 347 |
| 3 | South | 2013 | May | 221 |
| 4 | South | 2013 | May | 367 |
| 4 | South | 2014 | June | 645 |

Tabela Budget

| KeyToOtherTable | Region | Year | Month | Budget |
| --- | --- | --- | --- | --- |
| 1 | North | 2014 | June | 150 |
| 1 | North | 2014 | May | 200 |
| 2 | North | 2014 | May | 350 |
| 3 | South | 2013 | May | 200 |
| 4 | South | 2013 | May | 300 |
| 4 | South | 2014 | June | 500 |

### Explicação

Os valores de campos de KeyToOtherTable foram substituídos por valores inteiros exclusivos e, como resultado, o comprimento dos valores de campos foi reduzido, conservando memória. Os campos-chave em ambas as tabelas são afetados por AutoNumber, e as tabelas permanecem vinculadas. O exemplo é breve para fins de demonstração, mas seria significativo com uma tabela contendo um grande número de linhas.