Pular para o conteúdo principal

Solucionar problemas do conector Shopify

info

Beta

Este recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakeflow Connect for Shopify 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 Shopify e como resolvê-los.

Para obter diretrizes gerais de solução de problemas aplicáveis a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas em pipelines de ingestão gerenciados.

O pipeline falha ao autenticar

Causa: O Shopify retornou uma resposta HTTP 401, 402 ou 403. Geralmente, isso significa um dos seguintes problemas: o ID do cliente ou o segredo do cliente não é válido, o aplicativo do Shopify não está instalado na loja ou o subdomínio da loja está incorreto.

soluções:

  1. Verifique se o Store Subdomain , o Client ID e o Client Secret na conexão do Unity Catalog correspondem ao aplicativo no seu Shopify Dev Dashboard.
  2. Confirme se o aplicativo está instalado na loja da qual você deseja fazer a ingestão.

Para recuperar as credenciais novamente, consulte Configurar a autenticação para o Shopify.

O aplicativo não tem os escopos de acesso necessários

Mensagem de erro:

Please check that your shopify app has access to the required scopes. See https://shopify.dev/docs/api/usage/access-scopes for more details.

Causa: A aplicação do Shopify não tem os escopos de acesso que as tabelas ingeridas exigem.

soluções:

Adicione os escopos de acesso necessários à versão do aplicativo no Shopify Dev Dashboard e reinstale o aplicativo. Para ver os escopos que cada tabela exige, consulte Escopos de acesso necessários.

Não foi possível criar a exportação em massa

Mensagem de erro:

Shopify bulk query could not be created: <error details>

Causa: O Shopify rejeitou a solicitação de exportação em massa usada pelas tabelas collection_product e inventory_level. O Shopify executa uma exportação em massa por loja por vez, portanto, uma exportação concorrente pode bloquear uma nova.

soluções:

Aguarde a conclusão de qualquer outra exportação em massa no armazenamento e execute o pipeline novamente. Se o erro persistir, confirme se o aplicativo tem os escopos de acesso para as tabelas afetadas. Consulte Escopos de acesso necessários.

Limite de taxa da API do Shopify excedido

Causa: A Shopify retornou uma resposta HTTP 429 ou um erro THROTTLED de GraphQL porque o conector atingiu o limite de taxa da API da loja. A Shopify limita a taxa da API GraphQL Admin por custo de query, e o limite depende do seu plano da Shopify. Consulte a referência de limites de taxa da Shopify.

soluções:

O conector aguarda e tenta novamente de forma automática. Se isso acontecer repetidamente, reduza a frequência de programação do pipeline ou o número de pipelines concorrentes que compartilham a mesma loja do Shopify.