Resolver problemas de importação de artefatos de governança

Nomes da coluna estão incorretos

Descrição do problema

A importação falha com erro que um nome de coluna não é válido para este tipo de artefato, ou que uma coluna obrigatória está faltando, mas na verdade todas as colunas no arquivo são nomeadas corretamente e nenhuma das colunas obrigatórias está ausente.

Solução alternativa

Os cabeçalhos podem conter alguns caracteres de espaço em branco que não são visíveis na planilha ou até mesmo no editor de texto. O caractere de espaço em branco evita que o nome da coluna seja reconhecido.

• Edite o arquivo com um editor que mostra caracteres de espaço em branco.
• Tente excluir os cabeçalhos e digite seus nomes manualmente do zero.
• Verifique se a codificação de arquivo é UTF-8, e não, por exemplo, o BOM UTF-8 .

Relacionamentos com artefatos inexistentes são ignorados

Descrição do problema

Quando se define qualquer tipo de relação entre dois artefatos, o processo de importação é bem-sucedido, mas as relações com artefatos inexistentes são ignoradas. Os relacionamentos ignorados resultam em erros semelhantes a este:

GIM00015E: Artifact Average balance in column Related Terms is not found in the specified hierarchy.

Solução alternativa

Se você planeja importar vários tipos de artefatos que têm relações entre si, primeiro importe todos os artefatos, publique os artefatos importados e, em seguida, importe novamente os mesmos arquivos CSV, utilizando o método de mesclagem “Substituir todos os valores ”. Os segundo processos de importação somam as relações com os artefatos existentes.

Categoria não existe

Descrição do problema

Se uma categoria pai para um artefato não for definida no arquivo CVS, os artefatos são importados para a categoria [uncategorized] por padrão. Se uma categoria pai de um artefato estiver definida no arquivo ` CSV `, mas não existir no ambiente, a importação falhará. O processo de importação sempre cria apenas um tipo de artefato por importação. Ao importar artefatos diferentes de categorias, a categoria pai não pode ser criada.

Solução alternativa

Antes de importar artefatos de um arquivo ` CSV `, certifique-se de que as categorias para as quais você deseja importá-los existam no ambiente. Crie-os antes de iniciar o processo de importação.

Não consigo encontrar os artefatos após uma importação d CSV

Descrição do problema

Os artefatos importados pelos arquivos ` CSV ` não ficam visíveis nas páginas publicadas.

Solução alternativa

Você deve publicar os artefatos antes que eles apareçam como Publicado e estejam disponíveis para usar. Se os artefatos estiverem nas categorias importadas, você pode precisar adicionar usuários como colaboradores a essas categorias.

Não é possível localizar os artefatos após a importação de ZIP

Descrição do problema

Os artefatos que são importados por arquivos ZIP não são visíveis na UI, mas eles estão disponíveis em chamadas API.

Solução alternativa

É possível que o serviço wkc-search não estava em um estado ready durante a importação ZIP. Para resolver o problema, ressincronize com o comando a seguir:

curl -X GET "$CPD_URL/v3/glossary_terms/admin/resync?artifact_type=all" -k -H "accept: application/json" -H "Authorization: Bearer $TOKEN"

Processo de Importação ZIP cria artefatos duplicados

Descrição do problema

Artefatos em arquivos ZIP exportados são identificados com identificadores de artefato na coluna Artifact ID , em vez de pelo nome de artefato e caminho da categoria. No entanto, os identificadores de artefatos para termos comerciais predefinidos, classes de dados e classificações diferem entre cada instância do IBM watsonx.data intelligence. Portanto, artefatos predefinidos importados não são reconhecidos como sendo os mesmos dos artefatos predefinidos existentes. Portanto, o processo de importação cria artefatos duplicados.

Solução alternativa

• Exclua os artefatos predefinidos existentes da instância de destino IBM watsonx.data intelligence antes de importar artefatos. Veja Deletar artefatos publicados do mesmo tipo.

• Para classes de dados e classificações predefinidas:

  1. Excluir a categoria [uncategorized] ao criar o arquivo ZIP por meio de exportação de artefatos.
  2. Edite os arquivos ` CSV ` relativos às classes de dados e classificações e substitua os identificadores de artefato das classes de dados e classificações predefinidas nas colunas “Classificação pai” e “Classe de dados pai” pelos nomes de artefato predefinidos equivalentes e pelos caminhos de categoria.
  3. Edite os arquivos ` CSV ` para outros artefatos e substitua os identificadores de artefato das classes de dados e classificações predefinidas pelos nomes de artefato predefinidos equivalentes e pelos caminhos de categoria nas colunas “Classificações” e “Classes de dados”, para quaisquer artefatos que tenham relações com os artefatos predefinidos.

  Quando você importa os artefatos, são criadas relações com os artefatos predefinidos de destino existentes.

• Para termos de negócios predefinidos:

  1. Exclua a categoria Conhecimento Aceleradora de Dados Pessoais quando você cria o arquivo ZIP exportando artefatos.
  2. Edite os arquivos ` CSV ` relativos a termos de negócios e outros artefatos e substitua os identificadores de artefato dos termos de negócios predefinidos pelos nomes de artefatos predefinidos equivalentes e pelos caminhos de categoria na coluna “Termos relacionados” e em quaisquer outras colunas que definam relações entre termos de negócios.

  Quando você importa os artefatos, são criadas relações com os artefatos predefinidos de destino existentes.

Os conjuntos de dados de referência predefinidos na categoria Locais têm os mesmos valores de ID de artefato em todas as instâncias de IBM watsonx.data intelligence. Não há necessidade de uma solução alternativa.

As relações com classes de dados predefinidas e classificações importadas do ZIP estão ausentes

Descrição do problema

Propriedades personalizadas e valores de relacionamento não são importados.

Solução alternativa

Edite os arquivos ` CSV ` e altere os valores das classes de dados e classificações predefinidas relacionadas, substituindo os IDs dos artefatos por nomes de artefatos e caminhos de categoria; em seguida, reimporte.