Solucionar problemas do conector Verkada

info

Beta

Este recurso está em Beta. Os administradores do Workspace podem controlar o acesso a este recurso 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 Verkada e como resolvê-los.

Para orientações gerais de solução de problemas que se aplicam a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.

A Verkada rejeita o access token

Mensagem de erro:

Verkada access token rejected. Refreshing credentials and retrying.

Causa: A key da API armazenada na conexão do Unity Catalog não é válida, expirou, foi rotacionada ou foi criada para uma região diferente da sua organização.

soluções:

Verifique se a API Key e a Data Region na conexão do Unity Catalog correspondem à sua organização Verkada. O conector faz o refresh do token de curta duração automaticamente, portanto, uma falha persistente aponta para a API key. Se a key foi rotacionada, crie uma nova key e atualize a conexão. Consulte Configurar autenticação para Verkada e Criar uma conexão Verkada.

O pipeline falha com um erro de permissão

Causa: A key da API não tem acesso somente para leitura ao produto que uma tabela lê — Core para audit_log ou Controle de acesso para users. As permissões da key da API do Verkada não podem ser editadas após a criação da key.

soluções:

Crie uma nova key de API com acesso Somente leitura aos produtos necessários e, em seguida, atualize a conexão do Unity Catalog. Consulte Configurar Verkada.

As solicitações estão sujeitas a limites de taxa

Causa: A Verkada limita a API a 300 solicitações por minuto por organização e retorna 429 Too Many Requests quando o limite é excedido.

soluções:

O conector respeita o cabeçalho Retry-After e tenta novamente de forma automática com backoff exponencial, portanto, a limitação de taxa geralmente é transitória. Se o problema persistir, evite executar vários pipelines na mesma organização Verkada ao mesmo tempo.