Solucionar problemas do conector Zip
Beta
Este recurso está em Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse 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 Zip gerenciado e como resolvê-los.
O pipeline falha ao autenticar (HTTP 401)
Causa: A API key armazenada em sua conexão do Unity Catalog não é válida. Zip retorna status 401 (The provided API key is not valid) quando uma key é digitada incorretamente, expira ou é excluída.
soluções:
Verifique se o **Token de API** armazenado em sua conexão do Unity Catalog corresponde a uma active key na tab **Chaves de API** no Zip. Se a key expirou ou não existe mais, crie uma key e atualize a conexão. Veja Configurar a autenticação para o Zip e Criar uma conexão Zip.
O pipeline falha com um erro de permissões (HTTP 403)
**Causa:** O pipeline ingere um tipo de registro ao qual sua key de API **Restrita** não concede acesso. O Zip bloqueia o acesso a tipos de registro deixados em branco na configuração da key.
soluções:
No Zip, edite a key restrita e selecione acesso de, no mínimo, **Somente leitura** para cada tipo de registro que o pipeline ingere. Alternativamente, use uma **key** padrão. Consulte Configurar a autenticação para Zip.
O pipeline está com limite de taxa (HTTP 429)
Causa: O Zip limita a API a 150.000 solicitações por dia, por API key. Outros aplicativos que compartilham a API key do conector consomem a mesma cota.
soluções:
O conector aguarda e tenta novamente as solicitações limitadas por taxa durante uma atualização do pipeline. Se as atualizações ainda falharem, crie uma key de API dedicada para o conector, reduza a frequência de execução do pipeline ou ingira menos tabelas. Consulte Configurar autenticação para Zip.