// Referência de erro do PostgreSQL

PostgreSQL 22023: valor de parâmetro inválido

Uma configuração ou argumento de função tem um valor fora do que é aceito: um fuso horário desconhecido, uma unidade incorreta em uma configuração de memória, um passo igual a zero em generate_series.

SQLSTATE
22023
Nome
invalid_parameter_value
Categoria
Exceção de dados
Mensagem de erro
invalid value for parameter "TimeZone": "Mars/Olympus"

O que significa

22023 (invalid_parameter_value) significa que o valor é do tipo correto, mas não é um valor permitido. Para parâmetros de configuração, a mensagem é invalid value for parameter "name": "value", frequentemente com uma dica listando as unidades ou valores válidos. Muitas funções internas usam o mesmo código para argumentos inválidos, como step size cannot equal zero de generate_series.

Leia atentamente a mensagem e a dica: elas indicam o parâmetro e, geralmente, o que é permitido.

Causas comuns

  • Um nome de fuso horário que o PostgreSQL não reconhece (os nomes válidos estão em pg_timezone_names).
  • Uma configuração de memória ou de tempo com uma unidade incorreta, como work_mem = '64mb' em vez de '64MB' (as unidades diferenciam maiúsculas de minúsculas).
  • Um argumento de função fora de seu intervalo ou conjunto permitido, como um passo zero ou uma palavra-chave de opção desconhecida.

Como corrigir

  1. Verifique os valores válidos para uma configuração.

    SELECT name, unit, vartype, min_val, max_val, enumvals
    FROM pg_settings WHERE name = 'work_mem';
  2. Escolha um fuso horário da lista que o PostgreSQL reconhece.

    SELECT name FROM pg_timezone_names WHERE name ILIKE '%new_york%';
    SET TimeZone = 'America/New_York';
  3. Use as unidades exatamente como o PostgreSQL as escreve: kB, MB, GB, TB para memória e us, ms, s, min, h, d para tempo.

    SET work_mem = '64MB';
    SET statement_timeout = '30s';

Reproduza com segurança

SET TimeZone = 'Mars/Olympus';  -- ERROR: invalid value for parameter "TimeZone": "Mars/Olympus"

Erros relacionados

Mais erros de exceção de dados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.