SYNCED_TABLE_USER_ERROR condição de erro

SQLSTATE: 42000

Erro do usuário do pipeline de tabela sincronizada.

ACCELERATED_SYNC_DATA_TOO_LARGE

A tabela <tableName> sincronizada tem valores de colunas demasiado grandes para usar sincronização acelerada.

Para uma nova tabela sincronizada, desative a sincronização acelerada ao criá-la a partir da interface.

Para uma tabela sincronizada existente, contacte o suporte do Azure Databricks.

ACTIVE_ENDPOINTS_LIMIT

Exemplo: <instance>. O projeto de base de dados ultrapassou o seu limite de endpoints simultaneamente ativos, pelo que o pipeline de tabela sincronizada não pode ligar-se. Detalhe: <detail>.

Para resolver este problema, reduza o número de endpoints ativos em simultâneo ou aumente o limite para o seu projeto.

ACTIVE_TIME_QUOTA_EXCEEDED

Exemplo: <instance>. O projeto da base de dados ultrapassou a sua quota de tempo ativo, pelo que o pipeline de tabelas sincronizadas não pode ligar-se. Detalhe: <detail>.

Para resolver este problema, aumente a quota de tempo ativo para o seu projeto.

BRANCH_COMPUTE_TIME_EXCEEDED

Exemplo: <instance>. O ramo da base de dados excedeu o seu tempo de computação, pelo que o pipeline de tabela sincronizada não pode ligar-se. Detalhe: <detail>.

Para resolver este problema, aumente o tempo de computação disponível para este ramo.

CHAVE_PRIMÁRIA_ALTERADA

As colunas principais especificadas para a tabela <destTableUcName> sincronizada foram alteradas.

Colunas de chave primária especificadas: (<primaryKeyColumns>). Colunas de chave primária atuais: (<existingPrimaryKeyColumns>).

Alterar as colunas principais de uma tabela sincronizada depois de esta ter sido criada não é suportado.

Para resolver este problema, pode modificar a tabela sincronizada de volta para as colunas da chave primária original, ou criar uma nova tabela sincronizada e eliminar a existente.

ALTERADA_TIPO_COLUNA_CHAVE_PRIMÁRIA

Os tipos de dados das colunas <modifiedPkColumns> de chave primária foram alterados na tabela <destTableUcName>sincronizada .

A alteração dos tipos de dados das colunas de chave primária não é suportada numa tabela sincronizada após a sua criação.

Para resolver este problema, crie uma nova tabela sincronizada e retire a existente.

CARACTERE_NÃO_NO_REPERTÓRIO

Exemplo: <instance>. Encontrada sequência de bytes inválida na tabela Delta de origem.

Detalhe: <detail>

Isso geralmente indica que a tabela Delta de origem contém caracteres que não são

compatível com a codificação do banco de dados de destino. Uma solução alternativa é converter o

tabela fonte para utilizar o BINARY TYPE e depois criar uma nova tabela sincronizada.

ALTERAÇÃO_DE_TIPO_DE_COLUNA_NÃO_SUPORTADA

Exemplo: <instance>. No momento, não há suporte para alterar o tipo de coluna.

Tabela Delta de origem: <srcTableName>. Tabela sincronizada de destino: <destTableName>.

Coluna: <columnName>. Tipo existente: <existingType>. Novo tipo: <newType>.

Para resolver esse problema, considere uma das seguintes opções:

  1. Execute uma atualização completa da tabela sincronizada existente.

  2. Criar uma nova tabela sincronizada (que pegará o novo tipo)

COMPUTE_TIME_QUOTA_EXCEEDED

Exemplo: <instance>. A conta ou projeto da base de dados excedeu a sua quota de tempo de computação, pelo que o pipeline de tabela sincronizada não pode ligar-se. Detalhe: <detail>.

Para resolver este problema, aumente a quota de tempo de cálculo para a sua conta ou projeto.

ERRO_DE_LIGAÇÃO

Exemplo: <instance>. Erro de conexão. Detalhe: <detail>.

Para resolver esse problema, verifique se a instância do banco de dados está em execução, não pausada ou parada.

Reinicie o pipeline para tentar novamente.

BASE_DE_DADOS_NÃO_EXISTE

A base de dados <databaseName> de destino não existe na instância <instance>lakebase . Por favor, verifique se a base de dados de destino existe.

DATABASE_ROLE_NOT_EXIST

Exemplo: <instance>. O papel <roleName> Postgres do qual depende o pipeline de tabelas sincronizadas não existe. Detalhe: <detail>.

Isto ocorre tipicamente quando o papel foi eliminado da instância da base de dados, por exemplo, depois de a identidade ter sido removida do espaço de trabalho.

Para resolver este problema, recrie o papel <roleName> Postgres na instância da base de dados, ou retire e recrie a tabela sincronizada usando uma identidade que ainda existe.

DATA_TRANSFER_QUOTA_EXCEEDED

Exemplo: <instance>. O projeto de base de dados ultrapassou a sua quota de transferência de dados, pelo que o pipeline de tabela sincronizada não pode ligar-se. Detalhe: <detail>.

Para resolver este problema, aumente a quota de transferência de dados para o seu projeto.

DELTA_TRUNCATED_TRANSACTION_LOG

Detalhe: <detail>.

Isto indica que o registo de transações da tabela delta foi truncado devido à eliminação manual ou à política de retenção de registos.

Para resolver este problema, faça uma atualização completa da tabela sincronizada.

OBJETOS_DEPENDENTES_AINDA_EXISTEM

Exemplo: <instance>. Não é possível eliminar uma coluna porque um existente

O objeto do PostgreSQL ainda está a referir-se à coluna. Detalhe: <detail>.

Para resolver esse problema, considere uma das seguintes opções:

  1. Adicione a(s) coluna(s) em falta de volta à tabela de origem com o(s) mesmo(s) tipo(s) de dados de antes.

  2. Elimina os objetos dependentes no PostgreSQL.

DESTINATION_NAME_NOT_A_TABLE

Exemplo: <instance>. Não é possível criar tabela <destTableUcName> sincronizada porque o nome do destino já é usado por a <objectType> na base de dados de destino.

O pipeline de tabela sincronizada não cria nem gere este objeto.

Elimina ou renomeia a existente <objectType>, ou cria a tabela sincronizada com outro nome e depois tenta novamente.

DESTINATION_SCHEMA_ACCESS_ERROR

Exemplo: <instance>. O pipeline de tabelas sincronizadas não tem permissão sobre o esquema <schemaName>de destino. Detalhe: <detail>.

O pipeline liga-se como o papel <databaseUser>Postgres , que necessita USAGE e CREATE no esquema de destino para criar e manter a tabela de destino.

Para resolver este problema, execute: GRANT USAGE, CREATE ON SCHEMA <quotedSchemaName> TO <quotedDatabaseUser>; e depois reinicie o pipeline.

COLUNAS_CHAVE_PRIMÁRIA_DUPLICADAS

As colunas <duplicatedPkColumns> são especificadas várias vezes na chave primária da tabela <destTableUcName>sincronizada .

Para resolver este problema, remova as colunas duplicadas da chave primária para que cada coluna apareça apenas uma vez.

ENDPOINT_DISABLED

Exemplo: <instance>. A instância da base de dados alvo foi desativada e não pode aceitar ligações. Detalhe: <detail>.

Isto ocorre normalmente quando a instância foi interrompida. Uma instância desativada não pode ser iniciada por uma tentativa de ligação.

Para resolver este problema, reative ou inicie a instância da base de dados e depois reinicie o pipeline.

Se a instância foi interrompida intencionalmente, pausa ou elimina a tabela sincronizada em vez disso.

ENDPOINT_NOT_FOUND

Exemplo: <instance>. O endpoint da base de dados alvo não pôde ser encontrado ou não está acessível. Detalhe: <detail>.

Para resolver este problema, verifique se a instância da base de dados existe e se a tabela sincronizada está configurada com a instância correta.

VIOLAÇÃO_DE_CONSTRANGIMENTO_DE_CHAVE_ESTRANGEIRA

Exemplo: <instance>. Violação de restrição de chave estrangeira ao sincronizar a partir da tabela de origem:

<srcTableName>. Detalhe: <detail>

A criação de restrições de chave estrangeira que referenciam tabelas de sincronização não é suportada. Por favor

Elimina a restrição da chave estrangeira e tenta novamente a sincronização.

INDEX_ROW_SIZE_EXCEEDED

Exemplo: <instance>. Os valores-chave primários na tabela <srcTableName> Delta de origem são demasiado grandes para a

Índice B-tree do PostgreSQL. O PostgreSQL limita as entradas de índice a aproximadamente 2704 bytes em todas as chaves primárias

colunas combinadas. Detalhe: <detail>.

Para resolver este problema, reduza o tamanho dos dados armazenados nas colunas principais primárias, ou use menos ou

colunas de chave primária mais curtas

ESPAÇO_INSUFICIENTE_NA_INSTÂNCIA

Não é possível executar synchronize table <tableName> em instância <instance> devido ao tamanho da base de dados.

Uso atual da instância: <instanceSize> bytes.

Tamanho estimado da tabela não comprimida: <estimatedLoadSize> bytes.

Limite de tamanho da instância: <maxInstanceSize> bytes.

Por favor, reduza a quantidade de dados a sincronizar ou retire algumas tabelas existentes na instância para libertar espaço.

INVALID_ENDPOINT

Exemplo: <instance>. A instância da base de dados rejeitou a ligação porque o endpoint solicitado não é válido para esta operação. Detalhe: <detail>.

Isto pode ocorrer quando ligações apenas de leitura não são permitidas, ou quando o cálculo solicitado não existe.

Para resolver este problema, verifique a instância de destino e a configuração do endpoint da tabela sincronizada, depois reinicie o pipeline.

INVALID_TABLE_NAME

Nome <tableName>de tabela inválido: esperado um nome em três partes (catalog.schema.table).

INVALID_TYPE_OVERRIDE

Exemplo: <instance>. Substituição de tipo inválida para a coluna <columnName>: <reason>.

INVALID_VECTOR_DATA

Dados vetoriais inválidos para a coluna <columnName>: <reason>.

IP_NOT_ALLOWED

Exemplo: <instance>. O endereço IP do pipeline da tabela sincronizada não é permitido para se ligar à instância da base de dados. Detalhe: <detail>.

Para resolver este problema, atualize a lista de IP da instância da base de dados para permitir a ligação.

LOCK_TIMEOUT

Exemplo: <instance>. Base de dados: <databaseName>. O pipeline de tabela sincronizada não conseguiu adquirir um bloqueio dentro do timeout configurado (<timeoutSeconds> segundos).

Transações detetadas <numBlockingTransactions> que detêm bloqueios na tabela alvo (duração máxima de bloqueio: <lockDurationSeconds> segundos).

As transações do utilizador estão a manter bloqueios que impedem o pipeline da tabela sincronizada de atualizar a tabela de destino.

Para mais informações sobre as transações envolvidas no erro, consulte os registos do driver Spark (procure por '[LOCK TIMEOUT DIAGNOSTICS]').

Para resolver este problema, encontre as ligações com transações de longa duração na instância do postgres usando pg_stat_activity, e feche essas transações (também pode usar pg_terminate_backend para terminar a ligação se a ligação já não for necessária).

Para evitar que este problema volte a acontecer no futuro, considere as seguintes opções:

  1. Certifique-se de que a sua aplicação efetua o commit ou desfaz a transação.

  2. Evite transações de longa duração. Defina auto_commit para ativado se o trabalho na aplicação não precisar de ser feito numa transação.

  3. Defina idle_in_transaction_session_timeout na base de dados para terminar automaticamente as transações ociosas.

Exemplo: ALTER DATABASE <databaseName> SET idle_in_transaction_session_timeout = '5min';

LOGICAL_SIZE_QUOTA_EXCEEDED

Exemplo: <instance>. O projeto de base de dados ultrapassou a sua quota lógica de tamanho, pelo que o pipeline de tabelas sincronizadas não pode ligar-se. Detalhe: <detail>.

Para resolver este problema, aumente a quota lógica de tamanho para o seu projeto ou reduza a quantidade de dados armazenados.

Chave primária mal configurada (MIS_CONFIGURED_PRIMARY_KEY)

As chaves primárias fornecidas para a tabela Delta de origem: <srcTableName> não estão disponíveis na tabela de origem.

Chaves primárias: <primaryKeys>. Colunas disponíveis: <availableColumns>. Chaves primárias em falta: <missingPkColumns>.

Para resolver esse problema, considere uma das seguintes opções:

  1. Adicione as colunas em falta à tabela de origem.

  2. Crie uma nova tabela sincronizada com a configuração correta da chave primária.

NATIVE_LOGIN_BLOCKED

Exemplo: <instance>. O login nativo (palavra-passe) está desativado para o papel de base de dados usado pelo pipeline de tabela sincronizada. Detalhe: <detail>.

Para resolver este problema, ative o login nativo para o papel de base de dados do pipeline, ou reconfigure o papel para usar um método de autenticação suportado.

NETWORK_BLOCKED

Exemplo: <instance>. O pipeline de tabelas sincronizadas não pode ligar-se à instância da base de dados a partir da sua rede. Detalhe: <detail>.

Para resolver este problema, atualize a configuração de acesso à rede da instância da base de dados para permitir a ligação.

PERMISSION_DENIED

Detalhe: <detail>.

Por favor, verifique se tem permissões suficientes.

PIPELINE_ROLE_NOT_EXIST

Exemplo: <instance>. O papel de escritor de base de dados para pipeline de tabelas sincronizadas está ausente. Detalhe: <detail>.

Isto ocorre tipicamente quando a base de dados de destino foi eliminada, o que remove o papel de escritor do pipeline.

Para resolver este problema, verifique se a base de dados de destino existe e não foi descartada.

Se a base de dados foi intencionalmente descartada, apague a tabela sincronizada e recrie-a depois de recriar a base de dados.

PRIMARY_KEY_CONSTRAINT_VIOLATION

Exemplo: <instance>. Linhas duplicadas detetadas com base na chave primária. Detalhe: <detail>

Isso provavelmente indica uma configuração incorreta das colunas de chave primária.

Verifique se você está usando o conjunto correto de chaves primárias

da tabela Delta de origem: <srcTableName>.

Para resolver este problema, crie uma nova tabela sincronizada com as informações corretas.

configuração de chave primária.

QUOTA_EXCEEDED

Exemplo: <instance>. A conta ou projeto de base de dados alvo excedeu a sua quota. Detalhe: <detail>.

Para resolver este problema, reduza o uso ou melhore o plano para aumentar a quota e depois reinicie o pipeline.

REFRESH_WITH_FOREIGN_KEY

Exemplo: <instance>. Não foi possível atualizar a tabela <destTableName> sincronizada porque a tabela

<childTableName> tem uma restrição de chave estrangeira que faz referência à tabela sincronizada.

A atualização da tabela sincronizada não é suportada quando existem restrições de chave estrangeira

fazendo referência a isso. Por favor, retira a restrição da chave estrangeira e tenta novamente a atualização.

REQUIRED_EXTENSION_NOT_INSTALLED

Exemplo: <instance>. A extensão PostgreSQL obrigatória '<extension>' não está instalada. Instala-o na instância do Lakebase antes de criar esta sincronização.

SCHEMA_BUILDER_NOT_ENABLED

A personalização do esquema de tabela sincronizada (<features>) não está ativada para este espaço de trabalho.

ESQUEMA_NÃO_EXISTE

Detalhe: <detail>.

Por favor, verifique se o esquema existe no Catálogo Unity.

ERRO_DE_LEITURA_DE_FONTE

Falha ao tentar ler da tabela de origem <tableName>. Por favor, verifique se a tabela de origem pode ser lida com sucesso através de uma SELECT consulta.

Detalhe: <detail>

SOURCE_SMART_CLONE_REQUIRED

A visualização <srcTableName> materializada de origem requer que o SmartClone esteja ativado antes de poder ser usado como uma fonte de tabela sincronizada. Corre REPAIR TABLE <srcTableName> SYNC METADATA e tenta outra vez.

SPARK_JOB_CANCELLED

O trabalho do Spark foi cancelado.

Detalhe: <detail>

CONFLITO_NOME_DA_COLUNA_DO_SISTEMA

Exemplo: <instance>. A tabela <srcTableName> Delta de origem contém uma coluna cujo nome entra em conflito com o nome de uma coluna do sistema PostgreSQL. Detalhe: <detail>.

O PostgreSQL reserva certos nomes de colunas (como xmin, xmax, ctid, cmin, cmax, tableoid) para uso interno.

Para resolver este problema, renomeie a coluna conflituosa na tabela Delta de origem e recrie a tabela sincronizada.

Ou criar uma vista com as colunas conflitantes excluídas e sincronizar a vista em vez disso.

ERRO_DE_ACESSO_AO_ESQUEMA_DO_SISTEMA

Exemplo: <instance>. O esquema interno do sistema (__db_system) não está acessível ao pipeline de tabelas sincronizadas. Detalhe: <detail>.

Isto pode acontecer quando a base de dados foi reiniciada ou o esquema interno foi abandonado e recriado sem as permissões adequadas.

Para resolver este problema, retire e recrie a tabela <destTableUcName>sincronizada.

TABELA_NÃO_EXISTE

Detalhe: <detail>.

Por favor, verifique se a tabela sincronizada existe no Unity Catalog.

TARGET_DATABASE_FULL

O espaço do banco de dados de destino <databaseName> está cheio. Não é capaz de continuar a ingerir.

CONEXÕES_EXCESSIVAS

Demasiadas ligações abertas à instância da base de dados: <instance>

Detalhe: <detail>.

Cada sincronização de tabela pode usar até 16 ligações à instância da base de dados, que contam para o limite de ligação da instância.

Para resolver este problema, experimente as seguintes opções:

  1. Reduza o número de pipelines concorrentes que escrevem para a mesma instância da base de dados.

Por exemplo, escalonar os horários do pipeline.

  1. Reduzir o número de ligações concorrentes de outras cargas de trabalho que se ligam à mesma instância da base de dados.

UNSUPPORTED_COLUMN_TYPE

Exemplo: <instance>. Tipo de coluna PostgreSQL não suportado: <columnType>.

UNTRANSLATABLE_CHARACTER

Exemplo: <instance>. Encontrei carácter intraduzível na tabela Delta de origem.

Detalhe: <detail>

Isso geralmente indica que a tabela Delta de origem contém caracteres que não são

compatível com a codificação do banco de dados de destino. Uma solução alternativa é converter o

tabela fonte para utilizar o BINARY TYPE e depois criar uma nova tabela sincronizada.

VPC_ENDPOINT_NOT_ALLOWED

Exemplo: <instance>. O endpoint VPC do pipeline de tabela sincronizada não pode ligar-se à instância da base de dados. Detalhe: <detail>.

Para resolver este problema, adicione o endpoint VPC à lista de permitidos da instância da base de dados.

WRITTEN_DATA_QUOTA_EXCEEDED

Exemplo: <instance>. O projeto da base de dados ultrapassou a sua quota de dados escritos, pelo que o pipeline de tabelas sincronizadas não pode ligar-se. Detalhe: <detail>.

Para resolver este problema, aumente a quota de dados escritos para o seu projeto.