Pular para o conteúdo principal

Solucionar problemas do conector do Notion

info

Beta

Esse recurso está em Beta. Os administradores do Workspace podem controlar o acesso a esse recurso na página Pré-visualizações ao optar pela prévia do Notion connector . Consulte Gerenciar prévias do Databricks.

Esta página descreve erros comuns que você pode encontrar com o conector Notion gerenciado 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.

A criação da conexão falha com um erro 401 Unauthorized ou invalid_client

Causa: O ID do cliente ou o segredo do cliente não corresponde à sua integração pública do Notion, ou o URI de redirecionamento da integração não corresponde à URL de retorno de chamada do seu workspace do Databricks.

soluções:

Verifique se o ID do cliente e o segredo do cliente correspondem à sua integração pública do Notion e se o URI de redirecionamento da integração corresponde exatamente à URL de retorno de chamada do seu workspace do Databricks (https://<your-workspace-domain>/login/oauth/http.html). Consulte Configurar autenticação para o Notion.

Uma página ou banco de dados está ausente dos dados ingeridos

Causa: A página ou a fonte de dados não foi compartilhada com a integração no seletor de páginas do Notion durante a configuração da conexão. O conector só pode acessar o conteúdo que você compartilha explicitamente.

soluções:

Confirme se a página ou fonte de dados foi compartilhada com a integração no seletor de páginas do Notion. Para compartilhar conteúdo adicional, edite a seleção compartilhada no Notion e, em seguida, execute o pipeline novamente. Consulte Criar uma conexão com o Notion.

O pipeline atingiu o limite de taxa

Causa: O pipeline excedeu o limite de taxa da API do Notion. O Notion retorna HTTP 429 e informa o intervalo de espera no cabeçalho de resposta Retry-After.

soluções:

O conector aguarda e tenta novamente automaticamente quando o Notion limita a taxa de uma solicitação. Se a limitação de taxa persistir, reduza a frequência com que o pipeline é executado. Consulte Ingerir dados do Notion.

O pipeline não conseguiu autenticar.

Causa: as credenciais de conexão não são mais válidas ou o segredo do cliente OAuth foi rotacionado no Notion.

soluções:

O conector faz o refresh do access token automaticamente. Se a autenticação ainda falhar, verifique o ID do cliente e o segredo do cliente na conexão. Para atualizar credenciais rotacionadas, consulte Criar uma conexão Notion.