Solucionar problemas do conector Strac

info

Beta

Esse recurso está em Beta. 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 Strac gerenciado e como resolvê-los.

Strac API key inválida ou não autorizada

Causa: Strac retornou uma resposta HTTP 401 ou 403. A key da API está ausente, incorreta ou não autorizada para o Endpoint de eventos de auditoria. O conector trata isso como um erro de configuração e faz com que o pipeline falhe.

soluções:

1. Confirme se a API Key na conexão do Unity Catalog corresponde a uma Strac API key atual e se ela usa o prefixo sk_ correto para o seu ambiente (sk_test_ ou sk_live_).
2. Confirme se o Endpoint da API na conexão do Unity Catalog corresponde ao host e ao estágio para o mesmo ambiente.
3. Se a key for inválida ou não autorizada, solicite uma nova key da Strac, atualize a conexão com o novo valor e execute o pipeline novamente.

Para obter detalhes, consulte Configure a autenticação para o Strac.

Limite de taxa da API Strac excedido

Causa: Strac retornou uma resposta HTTP 429 porque a taxa de solicitações excedeu o limite da API.

soluções:

O conector respeita o cabeçalho de resposta Retry-After, então retorna para o backoff exponencial e tenta novamente automaticamente. Se isso acontecer repetidamente, reduza a frequência de agendamento do pipeline ou o número de pipelines concorrentes que compartilham a mesma API key Strac.

Strac API temporariamente indisponível

Causa: Strac retornou um erro transitório do servidor (HTTP 500, 502, 503 ou 504).

soluções:

O conector tenta novamente automaticamente com backoff exponencial. Se o problema persistir, aguarde e, em seguida, execute o pipeline novamente.