Este guia ajuda você a resolver problemas do Catálogo de dados quando importa e exporta glossários e links de entrada, incluindo links de entrada ausentes, erros de URL de glossário inválido ou quando um job de importação falha.
Se você precisar de ajuda para resolver um problema que não está abordado nesta página, entre em contato com o suporte do Google Cloud.
Corrigir links de entrada ausentes no Knowledge Catalog
Depois de exportar links de entrada do Knowledge Catalog para uma planilha do Google executando o utilitário de exportação de links de entrada, você percebe que alguns links de entrada (associações) estão faltando na planilha do Google gerada.
Esse problema ocorre se o utilitário de exportação pula automaticamente os links de entrada devido às seguintes condições:
Permissões insuficientes (recursos ocultos): você não tem as permissões do IAM necessárias para ver a entrada de origem ou a de destino associada ao link.
Tipo de link de entrada inválido: o link de entrada usa um tipo de relacionamento não compatível ou não reconhecido. Os tipos válidos são limitados a
definition,relatedesynonym.Referências de entrada incompletas: os metadados da entrada não têm os campos de esquema obrigatórios, fazendo com que a verificação de validação pule o recurso.
Para resolver esse problema, faça as seguintes verificações:
Verifique as permissões: confira se você tem permissão para ver os links de entrada ausentes. Confirme se o principal que está executando o script recebeu os papéis necessários.
Inspecione os registros de execução: verifique o terminal ou os registros de script em busca de avisos que contenham
Skipping redacted entrylink. Os registros geram os IDs de recursos específicos dos links de entrada ignorados e o motivo da omissão.Verifique a validade do esquema de links: se você modificou esses links de forma programática, verifique se as propriedades deles correspondem aos requisitos do esquema.
Nenhum termo encontrado no erro do glossário
Quando você exporta glossários para uma planilha do Google, a execução falha ou retorna um resultado vazio com a mensagem No terms found in the glossary, mesmo que o glossário empresarial contenha termos ativos.
Esse problema ocorre se o script não consegue localizar o glossário especificado ou não tem as permissões de acesso necessárias para recuperar o conteúdo dele. Estas são as causas mais comuns:
- URL do glossário incorreto: o URL do glossário configurado nos parâmetros de execução está incorreto ou com erros de ortografia.
- Permissões insuficientes do IAM: a conta de serviço autenticada ou as credenciais de usuário que executam o script não têm permissão para ver ou listar termos no glossário de destino.
- Incompatibilidade de ID do glossário: o ID do glossário especificado no comando do script não corresponde ao ID do recurso do glossário no Knowledge Catalog.
Para resolver esse problema, verifique sua configuração e permissões:
Verifique o ID do glossário: no console Google Cloud , acesse a página Glossários do Knowledge Catalog, selecione seu glossário e confirme se o ID do recurso corresponde ao ID que você está transmitindo ao script utilitário.
Verifique as permissões do IAM: confirme se as credenciais autenticadas (a conta de serviço ou a conta de usuário representada) receberam os papéis necessários.
Valide a estrutura do URL do glossário: se você estiver transmitindo um caminho de recurso direto ou um URL para o script, verifique se ele segue o formato correto do recurso do Knowledge Catalog:
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID
Aviso de entradas não encontradas no Knowledge Catalog
Durante uma operação de importação de links de entrada, o script pausa e mostra um aviso semelhante a este:
Found X entries not found in Knowledge Catalog. EntryLinks associated with
these entries will be skipped. Continue with import? [y/N]:
Esse problema ocorre se a planilha do Google tiver links de entrada que referenciam recursos de dados ou termos do glossário que não existem no Knowledge Catalog.
Para resolver esse problema, escolha uma das seguintes opções:
Para continuar com uma importação parcial, digite
yno prompt. O utilitário importa todos os links de entrada válidos e pula apenas os que fazem referência aos recursos ausentes.Para cancelar e corrigir os recursos ausentes, digite
npara cancelar a execução. Verifique se os IDs de entrada no documento de origem correspondem exatamente aos nomes de recursos no Knowledge Catalog. Corrija os recursos ausentes ou erros tipográficos e execute o script de importação novamente.
Resolver problemas de falhas em jobs de importação do Knowledge Catalog
Se um job de importação for interrompido ou falhar no meio da execução, não será necessário reiniciar todo o processo nem modificar a planilha Google de origem.
O utilitário rastreia os lotes importados com sucesso usando uma pasta de arquivo no bucket de preparo do Cloud Storage.
Para retomar o job, siga estas etapas:
Execute a ferramenta de importação novamente. O utilitário detecta o estado da execução anterior e mostra a seguinte solicitação:
Found X existing file(s) in archive folder from a previous incomplete import Continue using existing files? [y/N]:Digite
y. O utilitário ignora os lotes que já foram importados e processa apenas os arquivos restantes.
Tempos limite de script ou erros de SSL durante a execução
Ao executar o script utilitário de importação ou exportação, a execução é interrompida, atinge o tempo limite ou retorna erros de SSL no terminal.
Esse problema ocorre devido aos seguintes erros no nível da rede:
- Interceptação de proxy ou firewall corporativo: um proxy ou firewall de segurança está interceptando e inspecionando o tráfego HTTPS, o que invalida os certificados SSL.
- Restrições de VPN ativas: sua configuração de VPN restringe o tráfego de saída a determinadas APIs Google Cloud ou endpoints do Google Sheets.
- Instabilidade na rede local: uma queda temporária na conectividade com a Internet interrompeu a sessão.
Para resolver esses problemas de rede, siga estas etapas:
Verifique se você tem uma conexão de rede estável.
Inspecionar as configurações de proxy e firewall
Verifique a configuração da VPN.
Conte com novas tentativas integradas: o script de utilidade tem uma lógica de repetição integrada para falhas de rede temporárias. Se a queda de rede for momentânea, aguarde a conclusão das tentativas de repetição do script antes de reiniciar a execução.
Erro de URL de planilha inválido
Quando você tenta executar um utilitário de importação ou exportação, a interface de linha de comando
retorna um erro Invalid spreadsheet URL e interrompe a execução.
Esse problema ocorre se o script não consegue analisar o link da planilha Google fornecida ou não tem autorização para acessar o arquivo. Estas são as causas mais comuns:
- URL malformado: o URL não corresponde ao formato padrão de caminho do Google Planilhas.
- ID da planilha ausente: o caminho não tem o ID alfanumérico exclusivo que aponta para sua planilha específica.
- Restrições de acesso: sua conta de serviço autenticada não tem permissão para ver ou editar a planilha, o que impede que o utilitário valide o link.
Para resolver esse problema, verifique o link da planilha e as configurações de acesso:
Valide o prefixo do URL: verifique se o URL da planilha transmitido para o utilitário começa com o seguinte caminho padrão do Google Sheets:
https://docs.google.com/spreadsheets/Verifique o ID da planilha: confirme se o URL inclui o ID exclusivo da sua planilha. Um URL válido precisa seguir esta estrutura:
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/editVerifique as permissões de acesso: abra a planilha Google em um navegador, clique em Compartilhar e confirme se você adicionou o e-mail da sua conta de serviço como Editor.
Resolver erros de URL de glossário inválido
Quando você tenta executar um utilitário de importação ou exportação para glossários, a interface de linha de comando retorna um erro Invalid glossary URL e interrompe a execução. Verifique se não há um URL de glossário inválido nos seus parâmetros.
Esse problema ocorre se o script não conseguir analisar o caminho do recurso do glossário do Knowledge Catalog fornecido ou não tiver autorização para acessar o recurso. Estas são as causas mais comuns:
- Caminho de recurso malformado: o caminho de recurso não corresponde ao formato padrão do caminho do glossário do Knowledge Catalog.
- ID incorreto: o caminho contém um ID do projeto, local da região ou ID do glossário incorreto.
- Restrições de acesso ou recurso ausente: o glossário não existe ou sua conta de serviço autenticada não tem as permissões do IAM necessárias para acessar o glossário.
Para resolver esse problema, verifique o caminho do recurso do glossário e as credenciais:
Valide a estrutura do caminho do recurso: verifique se o caminho do glossário transmitido para a utilidade corresponde ao seguinte formato padrão do catálogo de dados do Knowledge Catalog:
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_IDVerifique os identificadores no caminho: use o ID do projeto, o local e o ID do glossário corretos.
Confirme a existência e o acesso ao recurso: verifique se o glossário existe com o ID especificado e se sua conta de serviço autenticada recebeu os papéis do IAM necessários.
Abra os registros de execução
Os utilitários de importação e exportação geram registros de execução detalhados durante a execução. Se o job de importação falhar, verifique os registros para encontrar erros específicos. Esses registros ajudam a auditar o processo de transferência e identificar entradas ignoradas ou avisos de formatação.
- Local do registro: os utilitários de importação e exportação gravam arquivos de registro no diretório
logs/no caminho de execução local. - Formato do registro: cada arquivo de registro é anexado com um carimbo de data/hora para que você possa localizar registros de uma execução específica.