Solucionar problemas do conector agregado do Google Analítica

info

Beta

Esse recurso está na versão beta. Para usá-lo, um administrador do Workspace deve ativar Lakeflow Connect for Google analítica Aggregated na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Resolva erros de permissão (403), de solicitação (400), de token expirado (401), de cota (429) e de servidor transiente do conector Google analítica Aggregated gerenciado no Lakeflow Connect.

Para obter orientação geral de solução de problemas aplicável a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.

Permissão negada (403)

Mensagem de erro:

O pipeline falha com uma resposta HTTP 403, e o erro é classificado como um erro de configuração.

Causa: A identidade autenticada não consegue acessar a propriedade do Google analítica 4 (GA4), ou a API de dados do Google analítica não está habilitada no projeto do Google Cloud que possui as credenciais.

Solução:

1. Confirme se a API Google Analítica Data está ativada no projeto do Google Cloud. Consulte Ativar a API Google analítica Data.
2. Confirme se a identidade tem pelo menos a função Visualizador em todas as propriedades em property_ids ou property_id:
   • Para uma account de serviço que usa sua própria identidade, adicione o endereço de email da account de serviço a cada propriedade. Consulte Conceda à account de serviço acesso às suas propriedades.
   • Para uma account de serviço que usa delegação em todo o domínio, confirme que o usuário email do usuário para representar tem acesso a cada propriedade e que o escopo https://www.googleapis.com/auth/analytics.readonly está autorizado para o ID do cliente da account de serviço.
   • Para autenticação OAuth user-to-machine (U2M), confirme se o usuário que fez login tem acesso a cada propriedade.

Para atualizar as credenciais, edite a conexão no Explorador de Catálogos. Consulte Criar uma conexão agregada do Google analítica.

Solicitação inválida (400)

Mensagem de erro:

O pipeline falha com uma resposta HTTP 400, e o erro é classificado como um erro de configuração.

Causa: A API de dados do Google analítica rejeitou a solicitação de relatório. As causas comuns incluem um ID de propriedade que não é numérico ou um relatório personalizado cujo dimensions e metrics incluem um nome de API desconhecido ou uma combinação incompatível.

Solução:

• Confirme que cada ID de propriedade seja o ID de propriedade numérico do GA4. Consulte ID da propriedade na documentação do Google.
• Para um objeto custom_report, confirme se cada valor em dimensions e metrics é um nome de API válido listado em Dimensões e métricas da API. Verifique a combinação com Método: properties.checkCompatibility.
• Confirme que dimensions, metrics e property_ids são strings de matriz JSON, por exemplo '["country"]'. Veja exemplos.

Access token expirado (401)

Mensagem de erro:

O pipeline falha com uma resposta HTTP 401.

Causa: O access token que a conexão usa expirou ou foi revogado.

Solução:

O conector refresh automaticamente o access token e tenta novamente quando recebe uma resposta 401. Se o erro persistir:

• Para conexões OAuth U2M, faça uma nova autenticação editando a conexão no Catalog Explorer e concluindo o fluxo de login novamente. Se o aplicativo OAuth usa o tipo de usuário Externo com o status de publicação Teste , os tokens de refresh do Google expiram após 7 dias. Consulte Configurar a tela de consentimento do OAuth.
• Para conexões de account de serviço, confirme se a key de account de serviço na conexão existe no console do Google Cloud. Se a key tiver sido excluída, crie uma key e atualize a conexão.

Cota esgotada (429)

Mensagem de erro:

O pipeline reporta respostas HTTP 429 da API analítica do Google.

Motivo: O pipeline esgotou uma das cotas da API de dados da propriedade, como tokens por hora ou solicitações concorrentes.

Solução:

O conector faz backoff automaticamente e tenta novamente as solicitações limitadas por taxa. Se o pipeline continuar falhando, reduza o número de tabelas ou propriedades em um único pipeline, defina um start_date posterior ou programar execuções de pipeline com menos frequência. Para limites de cota, consulte Limites e cotas na documentação do Google.

Erros de servidor transitórios (500, 502, 503, 504)

Mensagem de erro:

O pipeline falha com uma resposta HTTP 500, 502, 503 ou 504.

Causa: A API de dados do Google analítica retornou um erro de servidor temporário que não está relacionado às suas credenciais ou à configuração do pipeline.

Solução:

O conector repete automaticamente erros transitórios com backoff exponencial. Se o pipeline continuar falhando após as repetições, execute o pipeline novamente mais tarde.