Se as consultas que usam a extensão bigquery_fdw falharem, use as seguintes mensagens de erro
e as correções recomendadas para restaurar o acesso em tempo real aos
dados do BigQuery no AlloyDB para PostgreSQL. As causas comuns incluem uma
extensão desativada, permissões ausentes do BigQuery para a conta de serviço
do cluster e definições de tabela externa que não correspondem aos nomes de coluna
ou tipos de dados no BigQuery.
Para informações sobre como usar o wrapper de dados externos do BigQuery para acessar dados, consulte Configurar o acesso do AlloyDB para PostgreSQL a dados em tempo real no BigQuery.
Problemas de extensão e metadados
Nesta seção, listamos erros de extensão e metadados que você pode encontrar e fornecemos sugestões de como corrigir cada um deles.
A extensão bigquery_fdw está desativada
Correção recomendada
Para resolver o problema, siga estas etapas:
Verifique se a flag de banco de dados
bigquery_fdw.enabledestá definida comoon. É possível verificar isso de uma das seguintes maneiras:- Confira as flags de banco de dados atuais na instância.
- Conecte-se à instância e execute o seguinte comando em
psql:
SHOW bigquery_fdw.enabled;Se a flag
bigquery_fdw.enabledforoff, definabigquery_fdw.enabledcomoon.
Problemas de permissão e acesso
Nesta seção, listamos erros de permissão e acesso que podem ser encontrados e fornecemos as correções recomendadas.
Acesso negado: permissão bigquery.tables.get negada para a tabela
A extensão não conseguiu criar uma sessão de leitura do BigQuery com o seguinte erro:
Error in non-idempotent operation: Access Denied: Table TABLE_NAME: Permission bigquery.tables.get denied on table TABLE_NAME (or it may not exist).
Isso indica que a conta de serviço do cluster do AlloyDB não tem permissões de leitor de dados do BigQuery.
Correção recomendada
Para resolver esse problema, forneça ao cluster principal service_account_email um dos seguintes papéis:
- Leitor de dados do BigQuery (
roles/bigquery.dataViewer) - Um papel personalizado que contém as permissões
bigquery.tables.getebigquery.tables.getData.
Acesso negado a bigquery.readsessions.create
A extensão não conseguiu criar uma sessão de leitura do BigQuery com o seguinte erro:
Error in non-idempotent operation: request failed: the user does not have 'bigquery.readsessions.create' permission for PROJECT_NAME.
Isso indica que a conta de serviço do cluster do AlloyDB não tem permissões de usuário de sessão de leitura do BigQuery.
Correção recomendada
Para resolver esse problema, forneça ao service_account_email do cluster principal um dos seguintes papéis:
- Usuário de sessão de leitura do BigQuery (
roles/bigquery.readSessionUser) - Um papel personalizado que contém as permissões
bigquery.readsessions.createebigquery.readsessions.getData.
O usuário não tem a permissão bigquery.jobs.create
A extensão não conseguiu criar uma sessão de leitura do BigQuery com o seguinte erro:
Error in non-idempotent operation: Access Denied: Project PROJECT_NAME: User does not have bigquery.jobs.create permission in project PROJECT_NAME.
Correção recomendada
Para resolver esse problema, forneça ao cluster do AlloyDB service_account_email um dos seguintes papéis:
- Usuário de jobs do BigQuery (
roles/bigquery.jobUser). - Um papel personalizado que contém a permissão
bigquery.jobs.create.
Problemas de configuração e tipo de dados
Nesta seção, listamos os erros de configuração e de tipo de dados que você pode encontrar e fornecemos as correções recomendadas.
Os campos selecionados não existem no esquema da tabela
Ocorreram os seguintes problemas:
Error in non-idempotent operation: request failed: The following selected fields do not exist in the table schema: POSTGRES_COLUMN_NAME(S). Error in non-idempotent operation: Unrecognized name: POSTGRES_COLUMN_NAME(S);
Isso indica nomes de coluna incorretos na definição da tabela externa.
Correção recomendada
Para resolver esse problema, verifique se o nome exato da coluna (com diferenciação de maiúsculas de minúsculas) existe na tabela correspondente do BigQuery especificada na definição.
Sintaxe de entrada inválida para mapeamento de tipo
A operação falhou com o seguinte erro:
ERROR: invalid input syntax for type POSTGRES_COLUMN_DATA_TYPE: BIGQUERY_COLUMN_VALUE_RECEIVED.
Isso indica um mapeamento incorreto do tipo de dados da coluna na definição da tabela estrangeira.
Correção recomendada
Para resolver esse problema, verifique se o mapeamento de tipo de dados é compatível. Por exemplo, uma coluna de string no BigQuery não pode ser mapeada para uma coluna de números inteiros no PostgreSQL. Para mais informações, consulte Mapeamentos de tipo de dados.
Tipo de dados de coluna do BigQuery não compatível
Ocorreram os seguintes problemas:
ERROR: bigquery_fdw extension encountered internal error for column: POSTGRES_COLUMN_DATA_TYPE. Only avro logical type: AVRO_BIGQUERY_LOGICAL_TYPE is supported for avro type: AVRO_BIGQUERY_DATA_TYPE. encountered internal error for column:POSTGRES_COLUMN_NAME. Data type: BIGQUERY_DATA_TYPE is not supported.
Isso indica que o tipo de dados da coluna que está sendo consultada não é compatível.
Correção recomendada
Para resolver esse problema, consulte Mapeamentos de tipos de dados.
Não é possível ler entidades que não são tabelas
A extensão falhou com o seguinte erro:
ERROR: bigquery_fdw extension failed to create BigQuery read session with error: Error in non-idempotent operation: request failed: non-table entities cannot be read with the storage API.
Isso indica que o tipo de tabela do BigQuery que está sendo consultado não é compatível.
Correção recomendada
Para resolver esse problema, verifique se você está consultando um tipo de entidade compatível do BigQuery, como uma tabela padrão.