Hologres:FAQ sobre instruções SQL do Hologres

Erro: failed to import foreign schema from odps: Can't find file system factory

• Causa: O Hologres não consegue acessar o sistema de arquivos da tabela do MaxCompute devido a um erro de configuração.

• Solução: Verifique as configurações do servidor externo e da tabela externa. Alternativamente, importe os dados para uma tabela interna do Hologres.

Erro: Failed to import foreign schema from ODPS: Authorization Failed: xxx

• Causa: A conta atual não tem as permissões necessárias na tabela especificada do MaxCompute.

• Solução: Conceda as permissões necessárias à conta no MaxCompute. Para obter detalhes, consulte Gerenciar permissões de usuário usando comandos.

Erro: failed to import foreign schema from odps:Table not found -xxx

• Causa: A tabela especificada não existe no MaxCompute.

• Solução: Verifique se o nome da tabela e o projeto estão corretos no MaxCompute.

Erro: Update row with Key (id)=(xxxx) multiple times or duplicate key value violates unique constraint

• Causa: Os dados gravados contêm valores duplicados de chave primária, o que viola a restrição de unicidade.

• Solução:

  • Se o erro ocorrer em uma instrução INSERT, use a sintaxe INSERT INTO xx ON CONFLICT para desduplicar as chaves primárias. Para obter detalhes, consulte INSERT ON CONFLICT(UPSERT).

  • Se esse erro ocorrer com uma instrução INSERT...ON CONFLICT, os próprios dados de source contêm chaves primárias duplicadas. Para obter mais informações, consulte Erros comuns.

  • Esse erro também pode ocorrer se uma tabela tiver um tempo de vida (TTL) expirado e os dados expirados ainda não tiverem sido excluídos fisicamente. Nesse caso, use a função hg_remove_duplicated_pk para limpar os dados duplicados. Para obter detalhes, consulte Erros comuns.

Erro: ERROR: new row for relation violates partition constraint

• Causa: Os dados inseridos em uma tabela de partição filha não correspondem à definição do valor da partição. Por exemplo, inserir uma linha com um valor de partição diferente de '20240110' em uma partição definida para '20240110' causa esse erro. Exemplo:

  CREATE TABLE public.tbl_20240110 PARTITION OF public.tbl FOR VALUES IN('20240110');
  
  INSERT INTO public.tbl_20240110 SELECT * FROM odps_tbl where sale_date >'20240110';
  
  error: new row for relation "tbl_20240110" violates partition constraint
  

• Solução: Garanta que os dados gravados em uma tabela de partição filha atendam à restrição da partição.

Erro: null value in column "xxx" violates not-null constraint

• Causa: Um valor NULL foi gravado em uma coluna que possui uma restrição NOT NULL.

• Solução: Remova as linhas que contêm valores NULL nessa coluna e tente novamente a operação de gravação.

Erro: Dispatch query failed: Table not found

• Causa: A tabela não existe. Isso geralmente ocorre quando a tabela foi criada recentemente e seus metadados ainda não foram propagados, ou quando uma operação TRUNCATE ou DROP foi executada na tabela durante a execução da consulta.

• Solução: Use o Query Insight no HoloWeb para verificar se há operações DDL simultâneas, como TRUNCATE ou DROP. Resolva quaisquer conflitos e tente executar a consulta novamente. Evite executar operações DDL em tabelas consultadas ativamente. Para obter detalhes, consulte Query Insight.

Erro: ERROR: canceling statement due to statement timeout

• Causa: O tempo de execução da consulta excedeu o tempo limite da instrução configurado no cliente.

• Solução: Otimize a consulta para reduzir o tempo de execução ou aumente a duração do tempo limite. Para obter detalhes sobre as configurações de tempo limite, consulte Gerenciar consultas.

Erro: ERROR: Query:[xxx] Get result failed: canceling statement due to user request

• Causa: A consulta foi cancelada, geralmente porque uma operação DROP ou TRUNCATE foi executada na tabela durante a execução.

• Solução: Use o Query Insight no HoloWeb para verificar se há operações DDL conflitantes. Para obter detalhes, consulte Query Insight. Evite executar operações DDL durante a execução de consultas.

Erro: query is cancelled Cannot find index full ID:xxx (table id: x, index id: x) in storages or it is deleting

• Causa: Uma operação TRUNCATE ou DROP foi executada em uma das tabelas consultadas durante a execução. Isso alterou o ID da tabela e causou o cancelamento da consulta.

• Solução: Use o Query Insight para verificar se uma operação TRUNCATE ou DROP foi executada simultaneamente à sua consulta. Para obter detalhes, consulte Query Insight.

Erro: Feature not supported: insert into parent table

• Causa: O Hologres não oferece suporte à inserção de dados diretamente em uma tabela de partição pai.

• Solução: Insira os dados em uma tabela de partição filha específica. Para obter detalhes, consulte CREATE PARTITION TABLE.

Erro: SELECT INTO is not supported now.

• Causa: O Hologres não oferece suporte à sintaxe SELECT INTO.

• Solução: Use a sintaxe INSERT INTO SELECT para inserir dados. Para obter detalhes, consulte INSERT.

Erro: ALTER TABLE CHANGE OWNER is not supported in SLPM (Schema-Level Permission Mode)

• Causa: Não é possível usar ALTER TABLE para alterar o proprietário da tabela no modelo de permissão no nível de esquema (SLPM).

• Solução: No SLPM, os proprietários das tabelas são grupos de usuários. Para alterar as permissões de um usuário, remova-o do grupo de usuários. Para obter detalhes, consulte Remover um usuário de um grupo de usuários.

Erro: Feature not supported: INSERT ON CONFLICT RETURNING

• Causa: O Hologres não oferece suporte à sintaxe INSERT ON CONFLICT RETURNING.

• Solução: Use a sintaxe INSERT ON CONFLICT sem a cláusula RETURNING. Para obter detalhes, consulte INSERT ON CONFLICT(UPSERT).

Erro: ERROR: INSERT in ddl transaction is not supported now

• Causa: Por padrão, o Hologres não oferece suporte a instruções DML, como INSERT, dentro de um bloco de transação BEGIN...COMMIT. Exemplo:

  BEGIN;
  INSERT xxx
  commit;
  ERROR: INSERT in ddl transaction is not supported now

• Solução: Execute a instrução INSERT fora da transação ou ative as transações DML. Para obter detalhes, consulte Capacidades de transação SQL.

Erro: Creating publication with table that without binlog is not supported now

• Causa: Uma publicação foi criada para uma tabela que não tem o binlog ativado. As publicações exigem binlog para assinar alterações de dados.

• Solução: Ative o binlog na tabela antes de criar a publicação. Só é possível criar publicações para tabelas com binlog ativado. Para obter detalhes, consulte Usar JDBC para consumir binlogs do Hologres.

Erro: Feature not supported: INSERT on conflict contains un-unique column

• Causa: O alvo do conflito na instrução INSERT ON CONFLICT referencia uma coluna que não é chave primária.

• Solução: O alvo do conflito em INSERT ON CONFLICT deve referenciar apenas colunas de chave primária.

Erro: Feature not supported: UPDATE with shard keys

• Causa: O Hologres não oferece suporte a operações UPDATE em colunas de chave primária ou chave de distribuição.

• Solução: Não atualize colunas de chave primária ou chave de distribuição. Para alterar esses valores, use DELETE para remover a linha antiga e INSERT para adicionar uma nova.

Erro: time before 1925 not supported

• Causa: As funções relacionadas a tempo suportam, por padrão, o intervalo de 1925 a 2282. Valores fora desse intervalo causam um erro.

• Solução: Para funções como to_char, to_date ou to_timestamp, defina o parâmetro GUC hg_experimental_functions_use_pg_implementation antes da instrução SQL para habilitar um intervalo de tempo mais amplo. Para obter detalhes, consulte Funções de data e hora.

Erro: Group by key is type of imprecise not supported

• Causa: A cláusula GROUP BY referencia uma coluna com um tipo de dados impreciso, como FLOAT.

• Solução: Use tipos de dados precisos em vez de FLOAT na cláusula GROUP BY.

Erro: CREATE TABLE is not supported for current instance

• Causa: A instância atual é uma instância de Cluster Compartilhado (o endpoint começa com hgmc, por exemplo hgmc-cn-xxwwwkkk) ou é uma instância secundária. É possível visualizar o endpoint no console do Hologres. Instâncias de Cluster Compartilhado suportam apenas tabelas externas, não tabelas internas. Instâncias secundárias são somente leitura.

• Solução:

  • Se você usar uma instância de Cluster Compartilhado, crie uma tabela externa usando a sintaxe de tabela externa. Para obter detalhes, consulte CREATE FOREIGN TABLE. Alternativamente, use uma instância exclusiva para criar tabelas internas.

  • Se você usar uma instância secundária, crie as tabelas na instância primária.

Erro: ALTER TABLE ALTER COLUMN SET TYPE is not supported now

• Causa: O Hologres não oferece suporte à alteração do tipo de dados de uma coluna com ALTER TABLE.

• Solução: Para alterar o tipo de uma coluna, recrie a tabela com o tipo de coluna desejado.

Erro: ERROR: Currently materialized view does not support aggregate on expressions, only support single column

• Causa: Visualizações materializadas de tabela única não oferecem suporte a expressões agregadas em colunas computadas.

• Solução: Evite usar expressões em visualizações materializadas de tabela única. Use apenas agregações de coluna única. Para obter detalhes, consulte Gerenciar visualizações materializadas usando SQL.

Erro: ERROR: SELECT rule's target list has too few entries

• Causa: Visualizações materializadas em tempo real não oferecem suporte a expressões agregadas em colunas computadas.

• Solução: Evite usar expressões em visualizações materializadas em tempo real. Para obter detalhes, consulte Gerenciar visualizações materializadas usando SQL.

Erro: TransactionRowStore::DumpFlushDelta Not implemented

• Causa: A versão atual do Hologres possui uma limitação de implementação na sintaxe DELETE FROM table USING, o que causa esse erro.

• Solução: Reescreva a instrução SQL para evitar o uso da cláusula USING para exclusões em lote. Em vez disso, use a seguinte sintaxe:

  DELETE FROM table WHERE (col1, col2) IN ((val1, val2), ...);

Erro: column xxx does not exist

• Causa: A coluna especificada não existe na tabela.

• Solução: Verifique se o nome da coluna na instrução SQL está correto.

Erro: Table group xxx does not exist

• Causa: O grupo de tabelas especificado não existe.

• Solução: Especifique um grupo de tabelas existente ao criar a tabela ou crie o grupo de tabelas primeiro.

Erro: The specified partition does not exist

• Causa: Esse erro geralmente ocorre durante gravações ou atualizações de dados quando a tabela de partição filha de destino não existe.

• Solução: Crie a partição filha necessária antes de gravar os dados.

Erro: create binlog reader failed: Fail to find any shards, please check if the table group is in current virtual warehouse

• Causa: O grupo de tabelas especificado não está carregado no warehouse virtual atual.

• Solução: Verifique se o grupo de tabelas está carregado no warehouse virtual. Caso contrário, configure o warehouse virtual para carregá-lo. Para obter detalhes, consulte Autorizar um warehouse virtual a acessar dados.

Erro: Total memory used by all existing queries exceeded memory limitation

• Causa: A consulta excedeu o limite de memória e acionou um erro de falta de memória (OOM).

• Solução: Para obter detalhes, consulte Solucionar erros OOM.

Erro: internal error: Datasets has different schema

• Causa: Os esquemas dos conjuntos de dados combinados (por exemplo, em uma instrução UNION ou INSERT...SELECT) não correspondem em contagem de colunas, ordem ou tipo de dados.

• Solução: Garanta que a contagem de colunas, a ordem e os tipos de dados sejam consistentes em todas as partes da instrução.

Erro: value too long for type character varying(xxx)

• Causa: O valor dos dados excede o limite de comprimento character varying(n) definido para a coluna.

• Solução: Trunque ou transforme os dados, aumente o limite de comprimento do VARCHAR ou altere o tipo da coluna para TEXT.

Erro: Exceeds the partition limitation of 512, current match xxx partitions.

• Causa: A consulta verifica mais de 512 partições na tabela externa do MaxCompute, o que excede o limite padrão.

• Solução: Adicione mais condições de filtro de partição ou aumente o limite de verificação de partições usando o seguinte parâmetro GUC. Para obter detalhes, consulte FAQ sobre integração com MaxCompute.

  set hg_foreign_table_max_partition_limit =xx;

Erro: Build desc failed: Exceeds the scan limitation of 200 GB, current scan xxx GB.

• Causa: A quantidade de dados verificados na tabela externa do MaxCompute excede o limite de 200 GB.

• Solução:

  • Adicione mais condições de filtro para reduzir a quantidade de dados verificados.

  • Importe os dados para uma tabela interna do Hologres, que não possui limite de tamanho de verificação.

Erro: syntax error at or near "xxxxx"

• Causa: A instrução SQL apresenta um erro de sintaxe.

• Solução: Revise e corrija a sintaxe SQL.

Erro: DISTINCT is not implemented for window functions

• Causa: Atualmente, o Hologres não oferece suporte à palavra-chave DISTINCT em funções de janela.

• Solução: Remova a palavra-chave DISTINCT da função de janela.

Erro: ERROR:function xxx does not exist

• Causa: A extensão necessária não está instalada ou a chamada da função usa uma sintaxe inválida.

• Solução: Instale a extensão necessária ou corrija a sintaxe da função.

Erro: ERROR: function jsonb_set(json, text[], jsonb, boolean) does not exist

• Causa: Os tipos de argumento não correspondem à assinatura da função JSONB_SET.

• Solução: Garanta que o primeiro argumento de JSONB_SET seja do tipo JSONB, não JSON. Para obter detalhes, consulte Tipos de dados JSON e JSONB.

Erro: You have NO privilege 'odps:Select' on xxx

• Causa: A conta atual não tem permissões para consultar a tabela do MaxCompute.

• Solução: Conceda as permissões necessárias à conta no MaxCompute.

Erro: The sensitive label of column 'xxx' is 2, but your effective label is 0

• Causa: A conta atual tem acesso apenas a algumas colunas na tabela do MaxCompute.

• Solução: Conceda permissões mais amplas no nível de coluna no MaxCompute ou consulte apenas as colunas às quais você tem acesso. Para obter detalhes sobre autorização, consulte Gerenciar permissões de usuário usando comandos.

Erro: extension "xxxxx" already exists

• Causa: A extensão especificada já existe no banco de dados.

• Solução: A extensão já está instalada. Nenhuma ação é necessária. Para evitar esse erro, use CREATE EXTENSION IF NOT EXISTS.

Erro: invalid input syntax for type numeric: \"\"

• Causa: A coluna NUMERIC contém dados inválidos, como strings vazias, que não podem ser analisados como um valor numérico.

• Solução: Limpe os dados de source para garantir que estejam em conformidade com o tipo NUMERIC. Por exemplo, converta strings vazias para NULL ou 0.

Erro: invalid input syntax for integer: xxx

• Causa: A coluna INT contém dados que não podem ser analisados como um número inteiro.

• Solução: Limpe os dados inválidos.

Erro: missing data for column "xxx". failed to query next

• Causa: O formato do arquivo de dados está incorreto. Isso frequentemente ocorre quando os dados contêm o delimitador especificado no comando COPY (como vírgula ou espaço), resultando em uma incompatibilidade na contagem de colunas.

• Solução: Limpe os dados ou use um delimitador diferente que não apareça nos valores dos dados.

Erro: ERROR: INSERT has more expressions than target columns

• Causa: O número de valores na instrução INSERT excede o número de colunas na tabela de destino.

• Solução: Garanta que o número de valores na instrução INSERT corresponda ao número de colunas de destino.

Erro: bigint out of range

• Causa: O valor excede o intervalo válido do tipo BIGINT.

• Solução: Garanta que os dados estejam dentro do intervalo BIGINT (-9.223.372.036.854.775.808 a 9.223.372.036.854.775.807) ou use o tipo NUMERIC para valores maiores.

Erro: numeric field overflow in function round

• Causa: O valor NUMERIC excede seu limite de precisão definido.

• Solução: Ajuste a precisão da coluna NUMERIC para acomodar os dados ou limpe os dados para se adequarem à precisão definida.

Erro: InsertOverwrite insert select table data failed : column a.unsign_type does not exist

• Causa: A coluna especificada não existe na tabela ou um nome de parâmetro está incorreto.

• Solução: Revise e corrija a sintaxe SQL.

Erro: mismatched properties: table orientation is "column" but storage format is "sst"

• Causa: Propriedades da tabela incompatíveis. O armazenamento orientado a colunas foi especificado, mas o formato de armazenamento foi definido como SST, que é incompatível.

• Solução: Revise e corrija a instrução SQL.

Erro: invalid value "" for "yyyy". Value must be an integer.

• Causa: Os dados não estão em conformidade com o formato de data e hora esperado.

• Solução: Garanta que os dados contenham valores válidos de data e hora antes da gravação.

Erro: invalid byte sequence for encoding "UTF8": 0xe9 0x80

Erro: relation "xxxx" already exists

• Causa: A tabela especificada já existe no banco de dados.

• Solução: Use um nome de tabela diferente ou use CREATE TABLE IF NOT EXISTS para evitar o erro.

Erro: character with byte sequence 0xe4 0x9e 0xab in encoding "UTF8" has no equivalent in encoding "GBK"

• Causa: Um caractere UTF-8 não tem equivalente na codificação GBK de destino.

• Solução: Limpe os dados inválidos.

Erro: column "xxx" must appear in the GROUP BY clause or be used in an aggregate function

• Causa: Uma coluna não agregada na lista SELECT não está incluída na cláusula GROUP BY. Todas as colunas na lista SELECT devem aparecer no GROUP BY ou ser usadas em uma função de agregação.

• Solução: Adicione a coluna à cláusula GROUP BY ou use-a em uma função de agregação.

Erro: SET_TABLE_PROPERTY and CREATE TABLE statement are not in the same transaction for table

• Causa: As instruções CREATE TABLE e call set_table_property não estão na mesma transação.

• Solução: Agrupe a instrução CREATE TABLE e todas as instruções call set_table_property no mesmo bloco de transação. Exemplo:

  begin;
  CREATE TABLE tbl (
   xxxx
  );
  call set_table_property('tbl', 'orientation', 'xx');
  call set_table_property('tbl', 'distribution_key', 'xxx');
  commit;

Erro: column reference "xxx" is ambiguous

• Causa: O nome da coluna em uma consulta JOIN é ambíguo porque existe em várias tabelas. Por exemplo, em SELECT id FROM t1 INNER JOIN t2 ON t1.id=t2.id, id na cláusula SELECT é ambíguo porque pode se referir a t1 ou t2.

• Solução: Qualifique a coluna com o nome da tabela ou alias (por exemplo, t1.id).

Erro: column "xxx" specified more than once

• Causa: Um nome de coluna aparece mais de uma vez em uma instrução CREATE TABLE.

• Solução: Remova a coluna duplicada da instrução CREATE TABLE.

Erro: invalid definition of a numeric type

• Causa: Uma coluna NUMERIC ou DECIMAL foi definida sem especificar sua precisão.

• Solução: Especifique a precisão para a coluna NUMERIC ou DECIMAL, como NUMERIC(38, 18).

Erro: cannot cast type date to integer

• Causa: O tipo DATE não pode ser convertido para o tipo INTEGER.

• Solução: Modifique a sintaxe SQL para usar uma conversão de tipo válida.

Erro: schema "xxxx" does not exist

• Causa: O esquema não existe no banco de dados.

• Solução: Verifique se o nome do esquema na instrução SQL está correto ou crie o esquema primeiro.

Erro: internal error: Connect timeout, err: std_exception: Connection refused

• Causa: A instância do Hologres está indisponível ou não responde.

• Solução: Abra um ticket de suporte para investigar a interrupção da instância do Hologres.

Se o nome de uma coluna começar com um dígito, coloque-o entre aspas duplas na sua consulta, conforme mostrado no exemplo a seguir:

select bizdate,"1_day_active_users","7_day_active_users" from t_active_users;