Solucionar problemas do conector do Google Search Console
Beta
Esse recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakeflow Connect para o Google Search Console na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.
Esta página descreve erros comuns que você pode encontrar com o conector gerenciado do Google Search Console e como resolvê-los.
Para obter orientações gerais de solução de problemas aplicáveis a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.
Cota de QPS da Search analítica excedida
Mensagem de erro:
Google Search Console Search Analytics QPS quota exceeded. Retrying with backoff.
Causa: O pipeline enviou solicitações em excesso para a API de Search Analytics do Google Search Console dentro de um curto intervalo de tempo e atingiu o limite de cota por usuário e por segundo do Google.
soluções:
O conector tenta novamente de forma automática com recuo quando esse erro ocorre. Se o pipeline continuar a falhar, reduza o número de URLs de site ou tabelas ingeridas em um único pipeline, ou adicione um intervalo de agendamento maior entre as execuções do pipeline para reduzir o volume geral de solicitações de API.
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 (service account ou usuário OAuth) não tem permissões suficientes em uma ou mais propriedades do Google Search Console. Isso acontece quando a identidade não é um proprietário verificado ou um usuário com permissão total na propriedade, ou quando a delegação em todo o domínio está configurada incorretamente.
soluções:
Verifique se o email da account de serviço ou o usuário OAuth tem permissão total em cada URL do site especificado em site_urls. Consulte Configurar a autenticação no Google Search Console para obter os passos sobre como conceder acesso no Google Search Console.
Se você utilizar uma conta de serviço com delegação em todo o domínio, confirme que:
- O campo User Email to Impersonate na conexão usa uma conta que possui ou tem acesso total às propriedades.
- O escopo
https://www.googleapis.com/auth/webmasters.readonlyestá autorizado no Console de Administração do Google Workspace para a ID do cliente da account de serviço.
Para atualizar as credenciais, edite a conexão no Explorador de Catálogos. Consulte Criar uma conexão com o Google Search Console.
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 analítica da Google Search Console rejeitou o pedido de relatório. Uma causa comum é um objeto custom_report cujo aggregation_type é byProperty e cujos dimensions incluem page ou cujos search_types incluem discover ou googleNews.
soluções:
Para um objeto custom_report que usa byProperty, remova page de dimensions e remova discover e googleNews de search_types, ou defina aggregation_type como auto ou byPage. Veja Relatórios personalizados.
Valor de opção de conector inválido
Mensagem de erro:
Invalid connector_options option '<option-name>' for source 'google_search_console': expected array<string>. <reason>
Invalid connector_options option '<option-name>' for source 'google_search_console': value '<value>' is not one of <allowed-values>.
Causa: o conector valida as opções do conector antes de enviar qualquer solicitação ao Google Search Console. Um valor dimensions ou search_types falha na validação quando:
- Não é um array de strings JSON válido.
- É um array vazio.
- Lista o mesmo valor mais de uma vez.
- Contém um valor que a opção não permite.
soluções:
Defina dimensions e search_types para strings de matriz JSON que listam cada valor permitido no máximo uma vez, por exemplo '["country", "device"]'. Para os valores permitidos, consulte Opções de conector. Para exemplos, consulte Exemplos.
Access token expirado (401)
Mensagem de erro:
O pipeline falha com uma resposta HTTP 401.
Causa: O access token usado pela conexão expirou ou foi revogado.
soluções:
O conector automaticamente refresh os tokens OAuth quando recebe uma resposta 401. Se o erro persistir, o token de refresh pode ter sido revogado. Autentique-se novamente editando a conexão no Explorador de Catálogo e concluindo o fluxo de login mais uma vez. Consulte Criar uma conexão com o Google Search Console.
Para conexões de account de serviço, verifique se o JSON da key da account de serviço na conexão é válido e não foi excluído no Google Cloud Console. Faça o download de uma nova key, se necessário, e atualize a conexão.
Erros transitórios de servidor (500, 502, 503, 504)
Mensagem de erro:
O pipeline falha com uma resposta HTTP 500, 502, 503 ou 504.
Causa: A API do Google Search Console retornou um erro de servidor transitório. Esses erros são temporários e não estão relacionados às suas credenciais ou à configuração do pipeline.
soluções:
O conector tenta automaticamente repetir erros transitórios com backoff exponencial. Se o pipeline continuar a falhar após as tentativas, verifique o Google Workspace Status Dashboard para quaisquer incidentes em curso no Google Search Console. Se nenhum incidente for relatado, execute o pipeline manualmente novamente.