Solucionar problemas do conector Workiva

info

Beta

Esse recurso está em Beta. Os administradores do workspace 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 gerenciado do Workiva e como resolvê-los.

Credenciais do Workiva sem um escopo obrigatório

Causa: O Workiva retornou uma resposta HTTP 403 porque o aplicativo OAuth2 não está autorizado para o recurso solicitado. O conector trata isso como um erro de configuração e falha no pipeline. Uma causa comum é um aplicativo que não possui o escopo activity:read (necessário para activities) ou o escopo organization:read (necessário para users e roles).

soluções:

1. Em sua organização Workiva, confirme se o aplicativo OAuth2 possui os escopos activity:read e organization:read.
2. Se você adicionar um escopo, gere credenciais atualizadas, se necessário, e atualize a conexão do Unity Catalog com o novo Client ID e Client Secret .
3. Execute o pipeline novamente.

Para obter detalhes, consulte Configurar autenticação para o Workiva.

Workiva access token rejeitado

Causa: A Workiva retornou uma resposta HTTP 401. O access token expirou ou as credenciais do cliente estão incorretas. O conector faz refresh automaticamente do token e tenta novamente uma vez; se a nova tentativa ainda falhar, o pipeline falha com um erro de credenciais inválidas.

soluções:

1. Confirme se o Client ID e o Client Secret na conexão do Unity Catalog correspondem a uma aplicação OAuth2 do Workiva atual e ativa.
2. Confirme se o Organization ID na conexão do Unity Catalog corresponde à sua organização Workiva.
3. Se as credenciais estiverem incorretas ou revogadas, crie novas credenciais no Workiva, atualize a conexão e execute o pipeline novamente.

Para obter detalhes, consulte Configurar autenticação para o Workiva.

Limite de taxa da API do Workiva excedido

Causa: O Workiva retornou uma resposta HTTP 429 porque a taxa de solicitação excedeu o limite da API.

soluções:

O conector respeita o cabeçalho de resposta Retry-After, então recorre ao backoff exponencial 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 o mesmo aplicativo OAuth2 do Workiva.

A API do Workiva está temporariamente indisponível

Causa: o Workiva retornou um erro de servidor transitório (HTTP 500, 502, 503 ou 504).

soluções:

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