Variável de Referência em Fórmulas do Notion: Quando Usar Propriedades

Ao escrever fórmulas em bancos de dados do Notion, você frequentemente precisa se referir a outras colunas na mesma linha. A função prop é a forma padrão de obter valores de uma propriedade específica. No entanto, muitos usuários encontram problemas de desempenho ou erros de fórmula quando chamam prop repetidamente para a mesma propriedade dentro de uma fórmula complexa. Este artigo explica o que é uma variável de referência, por que ela pode melhorar o desempenho e a legibilidade da fórmula, e quando você deve usar uma variável em vez de chamar prop várias vezes.

Uma variável de referência armazena o valor de uma propriedade uma vez e o reutiliza em toda a fórmula. Isso reduz o número de consultas a propriedades e torna a fórmula mais fácil de depurar. Você aprenderá a sintaxe para criar variáveis, os cenários exatos em que as variáveis superam as chamadas repetidas de prop e as limitações que você deve observar.

O que é uma Variável de Referência em Fórmulas do Notion

No Notion, uma fórmula é uma expressão única que pode incluir funções, operadores e referências a outras propriedades do banco de dados. Quando você escreve prop("Data de Vencimento"), o mecanismo da fórmula consulta o valor da propriedade Data de Vencimento para a linha atual. Se você precisar desse valor em três lugares diferentes, deve escrever prop("Data de Vencimento") três vezes. Cada chamada dispara uma consulta à propriedade, o que pode tornar as fórmulas lentas em bancos de dados grandes com centenas ou milhares de linhas.

Uma variável de referência permite armazenar o resultado de uma chamada prop() em um contêiner nomeado usando a função let(). A sintaxe é:

let(nomeVariavel, prop("Nome da Propriedade"), expressão que usa nomeVariavel)

A função let() recebe três argumentos: o nome da variável (sem aspas), o valor a ser atribuído e a expressão final onde a variável é usada. O nome da variável deve começar com uma letra e pode conter letras, números e sublinhados. A variável está disponível apenas dentro da chamada let() — ela não persiste fora da fórmula.

Como let() Difere de prop()

Chamar prop("Nome") repetidamente dentro de uma fórmula faz com que o mecanismo busque o valor da propriedade a cada vez. Com let(), a propriedade é buscada uma vez e armazenada na memória durante a avaliação da fórmula. Essa diferença é importante quando a fórmula referencia a mesma propriedade três ou mais vezes. Para fórmulas que referenciam uma propriedade apenas uma vez, usar let() adiciona complexidade desnecessária sem benefício de desempenho.

Quando Usar uma Variável de Referência

Use uma variável de referência nestas situações específicas:

1. Você referencia a mesma propriedade três ou mais vezes
   Se sua fórmula usa prop("Status") em múltiplas condições, armazene-a uma vez com let(). Exemplo: uma fórmula que verifica se o Status é “Concluído”, depois formata a data e também conta tarefas concluídas. Três chamadas prop() se tornam uma.
2. O nome da propriedade é longo ou contém caracteres especiais
   Escrever prop("Endereço de Email do Gerente do Projeto") quatro vezes é propenso a erros. Uma variável como emailGP reduz erros de digitação e torna a fórmula mais curta.
3. Você precisa realizar um cálculo no valor de uma propriedade antes de reutilizá-lo
   Se você precisa converter uma data em número ou extrair uma substring, armazene o valor transformado em uma variável. Por exemplo, let(diaNum, day(prop("Data de Início")), ...) permite reutilizar diaNum sem recalcular.
4. Você está construindo uma instrução condicional ou switch aninhada
   Lógica complexa com if() ou ifs() se torna legível quando resultados intermediários têm nomes descritivos como estaAtrasado ou pontuacaoPrioridade.

Passos para Substituir Chamadas Repetidas de prop() por uma Variável

Siga este processo para refatorar uma fórmula existente que usa prop() várias vezes.

1. Identifique a propriedade usada mais de duas vezes
   Abra seu banco de dados do Notion e clique na célula da propriedade de fórmula. Revise a fórmula e conte quantas vezes cada prop("NomeDaPropriedade") aparece. Qualquer propriedade que apareça três ou mais vezes é candidata a uma variável.
2. Envolva toda a expressão existente com let()
   Coloque let(nomeVariavel, prop("NomeDaPropriedade"), antes da fórmula existente e feche com ) no final. Por exemplo, se sua fórmula é prop("Preço") * 1.1 + prop("Preço") * 0.05, altere para let(p, prop("Preço"), p * 1.1 + p * 0.05).
3. Substitua cada ocorrência de prop(“NomeDaPropriedade”) pelo nome da variável
   Dentro da expressão após a vírgula, substitua cada prop("Preço") por p. Não inclua aspas ao redor do nome da variável.
4. Teste a fórmula
   Clique fora do editor de fórmula ou pressione Enter. Verifique se o resultado é o mesmo de antes. Se você vir um erro, verifique se o nome da variável está escrito de forma consistente e se os parênteses de let() estão balanceados.
5. Adicione mais variáveis para outras propriedades repetidas
   Você pode aninhar várias chamadas let() para armazenar vários valores. Exemplo: let(p, prop("Preço"), let(q, prop("Quantidade"), p * q)). Cada variável está disponível apenas dentro de seu próprio escopo let().

Erros Comuns ao Usar Variáveis de Referência

Mesmo usuários experientes do Notion cometem erros com variáveis. Aqui estão os problemas mais frequentes e como evitá-los.

Conflito de nome da variável com um nome de propriedade

Se você nomear uma variável como Status e seu banco de dados também tiver uma propriedade chamada Status, a fórmula pode se tornar ambígua. Sempre use um nome distinto, como statusTarefa ou s. O Notion não impede que você use o mesmo nome, mas isso pode causar comportamento inesperado.

Esquecer de fechar os parênteses do let()

A função let() requer três argumentos e um parêntese de fechamento. Um erro comum é colocar o parêntese de fechamento no lugar errado, o que trunca a fórmula. Conte os parênteses: cada ( de abertura deve ter um ) correspondente. Use um editor de código ou o realce de sintaxe embutido do Notion para identificar incompatibilidades.

Usar uma variável fora de seu escopo

Uma variável definida dentro de um let() está disponível apenas na expressão que segue. Se você tentar referenciar p fora do bloco let(), a fórmula retorna um erro. Aninhe chamadas let() para passar valores para níveis mais profundos ou defina a variável no nível mais externo se precisar dela em todos os lugares.

Usar let() quando prop() é chamado apenas uma vez

Adicionar uma variável para uma propriedade usada apenas uma vez adiciona complexidade sem ganho de desempenho. A fórmula se torna mais difícil de ler e depurar. Reserve variáveis para propriedades referenciadas duas ou mais vezes.

Quando prop() é Chamado Uma Vez vs Quando Usar uma Variável

Cenário	Chamadas repetidas de prop()	Usando variável let()
Fórmula referencia a mesma propriedade 1 vez	Simples, legível, sem problema de desempenho	Complexidade desnecessária, sem benefício
Fórmula referencia a mesma propriedade 2 vezes	Aceitável, mas variável pode melhorar legibilidade	Opcional — use se o nome da propriedade for longo
Fórmula referencia a mesma propriedade 3 ou mais vezes	Consultas redundantes, mais lento em bancos grandes	Recomendado — uma consulta, execução mais rápida
Nome da propriedade é longo (mais de 20 caracteres)	Propenso a erros de digitação, difícil de ler	Nome de variável mais curto reduz erros
Cálculo intermediário necessário	Deve repetir o cálculo a cada vez	Armazena resultado uma vez, reutiliza sem recalcular

Esta tabela mostra que o limite para usar uma variável é três ou mais referências à mesma propriedade. Para duas referências, a decisão depende da legibilidade. Para uma referência, evite variáveis.

Quando Não Usar uma Variável de Referência

Variáveis nem sempre são a melhor escolha. Evite-as nestes casos:

• A fórmula é muito curta (uma ou duas referências a propriedades). Adicionar uma variável torna a fórmula mais longa sem melhorar o desempenho.
• Você precisa referenciar a propriedade apenas uma vez dentro de um cálculo simples. Exemplo: prop("Preço") * 1.1 é melhor que let(p, prop("Preço"), p * 1.1).
• Você está usando uma propriedade dentro de uma fórmula de rollup ou lookup. Rollups e lookups já armazenam valores em cache de forma diferente. Variáveis dentro dessas fórmulas podem causar confusão porque o escopo de let() é limitado à célula da fórmula.
• Você está compartilhando o banco de dados com outras pessoas que não se sentem confortáveis com fórmulas avançadas. Variáveis adicionam complexidade. Se sua equipe precisa editar fórmulas, chamadas prop() mais simples podem ser mais fáceis de entender.

Conclusão

Usar uma variável de referência com a função let() em fórmulas do Notion reduz consultas a propriedades e melhora tanto o desempenho quanto a legibilidade quando a mesma propriedade é referenciada três ou mais vezes. Você pode armazenar o valor de uma propriedade uma vez, dar a ele um nome descritivo e reutilizá-lo em toda a fórmula sem repetir chamadas prop(). Para fórmulas com uma ou duas referências à mesma propriedade, mantenha as chamadas diretas prop() para manter a fórmula simples. Comece auditando suas fórmulas mais complexas — especialmente aquelas com instruções if() ou ifs() aninhadas — e refatore-as com variáveis let(). Um próximo passo prático é testar a diferença de desempenho duplicando um banco de dados com 500 linhas e comparando os tempos de carregamento antes e depois da refatoração.