Tipo de dados Moeda

Moeda é um tipo de dados de coluna criado para valores monetários. Ele aparece junto com os tipos conhecidos — Numérico, Inteiro, Texto e os demais — em todas as listas de tipos de dados e armazena os valores como decimais exatos de ponto fixo: 18 dígitos de precisão com 4 casas decimais. Isso dá espaço para cerca de ±100 trilhões, com exatidão de 1/10.000 de unidade, sem arredondamento de ponto flutuante.

O ganho é velocidade. Uma coluna Moeda ocupa metade da largura em memória de uma coluna Numérico, de modo que painéis e etapas de fluxo de trabalho que varrem tabelas cheias de valores leem cerca de metade dos dados e terminam mais rápido. Numérico continua sendo o padrão de alta precisão (38 dígitos de precisão, 10 casas decimais); Moeda é o tipo mais enxuto que você adota onde os valores são monetários.

Quando usar Moeda

Escolha Moeda para colunas que contêm valores monetários — custo, receita, preço, margem, gasto, valores alocados. Essas são as colunas que dominam os modelos de rentabilidade e financeiros, portanto mudar o tipo delas costuma ser o maior ganho isolado para painéis e fluxos de trabalho que fazem muitas varreduras.

Continue com Numérico quando:

Os valores puderem ultrapassar cerca de ±100 trilhões ou precisarem de mais de 4 casas decimais — pense em taxas de câmbio, taxas unitárias, porcentagens e fatores de alocação
A coluna misturar valores monetários com outras medidas ou você não tiver certeza do que ela conterá

Onde definir

O tipo Moeda está disponível em qualquer lugar em que você escolhe o tipo de dados de uma coluna.

No mapeamento de colunas de uma etapa de fluxo de trabalho

No mapeamento de colunas de saída de qualquer etapa — a grade do Data Mapper —, escolha Moeda na lista suspensa de tipo de dados da coluna, da mesma forma que escolheria Numérico ou Texto. A etapa grava essa coluna como Moeda a partir da próxima execução.

Nas propriedades da coluna de uma tabela

Abra as Propriedades da coluna de uma tabela e use o controle Tipo de dados para alternar uma coluna entre Numérico e Moeda. A alteração entra em vigor na próxima vez que a tabela for recriada — por exemplo, na próxima vez que a etapa de fluxo de trabalho que a produz for executada.

Com um assistente de IA ou ferramentas MCP

Agentes conectados por MCP também podem definir o tipo: o valor do tipo de dados é currency onde quer que um tipo de coluna seja informado — ao criar uma coluna, definir uma tabela ou configurar uma etapa. Pedir ao seu assistente para “transformar as colunas de valor em moeda” costuma ser a forma mais rápida de alterar o tipo de uma tabela larga.

Como o tipo Moeda se comporta

Algumas regras mantêm o tipo Moeda previsível em toda a plataforma:

Moeda é sempre uma escolha explícita sua. Importações, detecção automática de tipo, resultados de SQL e colunas derivadas (somas, expressões, saídas de alocação) sempre usam Numérico como padrão. Onde você quiser Moeda em um resultado, altere você mesmo o tipo dessa coluna de saída.
Depois de definido, ele é lembrado. Uma coluna declarada como Moeda continua sendo Moeda nas leituras, nas etapas seguintes e nas recriações da tabela. Quando uma etapa seguinte preenche o mapeamento de colunas a partir da tabela, o tipo Moeda passa automaticamente para a configuração da etapa.
As agregações retornam Numérico. Uma SUM ou outra agregação de uma coluna Moeda produz um resultado Numérico — defina a coluna de saída de volta como Moeda se quiser que o agregado seja armazenado dessa forma.
Células vazias são importadas como 0. Em importações de arquivos, uma célula vazia em uma coluna Moeda é carregada como 0, exatamente como acontece com Numérico.

Relacionados

Usar tabelas e visões — como as tabelas armazenam colunas e por que os tipos de dados importam para tamanho e velocidade
Propagação de colunas — propague uma alteração de tipo para as etapas seguintes que consomem a coluna
Explorador de tabelas — inspecione o tipo de dados de cada coluna rapidamente