Exportando artefatos de controle

Na IU, é possível exportar um tipo de artefato por vez de uma única categoria. Você pode usar a API IBM Knowledge Catalog para exportar todos os artefatos de governança de um tipo. As informações são exportadas para um arquivo CSV que é gravado na pasta de download padrão. O nome do arquivo padrão é <category_name>-<artifact_type>-csv-export.csv. É possível modificar esse arquivo fora do catálogo e, posteriormente, importá-lo.

Para obter informações sobre categorias de exportação, consulte Importando ou exportando categorias.

Exportando artefatos de controle de uma categoria

É possível exportar um tipo de artefato de controle de cada vez de uma categoria ou de uma categoria e suas subcategorias. Somente os artefatos com um relacionamento primário com a categoria ou suas subcategorias são exportados.

Permissões necessárias
Deve-se ser um colaborador com pelo menos a função Viewer em uma categoria para exportá-la ou com uma função customizada com a permissão para exportar um tipo de artefato.

Para exportar um tipo de artefato de controle de uma categoria:

  1. Escolha Governança > Categorias.

  2. Clique em um nome de categoria para abri-lo.

  3. Clique em Exportar.

  4. Selecione o tipo de artefato de controle para exportar.

    É possível exportar até 400 artefatos de controle por tipo.

  5. Opcional. Selecione para exportar artefatos de subcategorias da categoria atual.

    Quando você seleciona para exportar subcategorias, também tem a opção de incluir a categoria atual na exportação. Por padrão, a categoria atual não está incluída. Para exportar hierarquia de categoria completa (a categoria e todas as subcategorias na árvore) marque ambas as caixas de entrada. Para exportar todas as categorias de raiz de uma só vez, consulte Categorias Importando ou Exportar.

  6. Clique em Exportar.

Um arquivo CSV é transferido por download para o seu computador. O arquivo de exportação tem a mesma estrutura de um arquivo de importação. Consulte O formato de um arquivo CSV de importação. Se você exportar a categoria padrão do sistema [uncategorized], o arquivo CSV exportado não conterá um nome de categoria para o tipo selecionado de artefato de controle.

Exportando todos os artefatos de controle de um tipo de uma vez

É possível exportar até 400 artefatos de controle de um tipo selecionado usando a API de REST. Envie uma solicitação GET /v3/governance_artifact_types/{artifact_type}/export. Substitua o {artifact_type} pelo tipo de artefato que deseja exportar. Para exportar artefatos do tipo selecionado de todas as categorias, deixe o campo category_id vazio. Para obter detalhes, consulte a documentação da API.

Permissões necessárias
Deve-se ser um colaborador com pelo menos a função Visualizador em todas as categorias ou com uma função customizada com permissão para exportar um tipo de artefato.

Exportando todos os artefatos de controle para um arquivo ZIP

É possível exportar todos os artefatos de controle para um único arquivo ZIP usando a API de REST. Use esse tipo de exportação para mover todos os artefatos de governança de uma instância de serviço IBM watsonx.data intelligence para outra. O arquivo ZIP contém pastas para cada tipo de artefato e cada pasta contém um arquivo CSV com artefatos. É possível exportar todos os tipos de artefato ou somente os selecionados. O número máximo de artefatos de controle que pode ser exportado é 400. Esse método também permite exportar e importar colaboradores da categoria com suas funções de categoria..

Envie uma solicitação GET /v3/governance_artifact_types/export. No campo artifact_id_mode, deixe o valor padrão always, pois os valores de ID do artefato são necessários para importação. Para obter detalhes, consulte a documentação da API.

Permissões necessárias
  • Deve-se possuir uma função de serviço Gerente.

Considerações sobre Segurança

Os dados de governança exportados para arquivos CSV são tratados contra ataques conhecidos de injeção de CSV, garantindo a segurança para programas de planilha que interpretam dados CSV automaticamente. Como resultado, quaisquer valores de texto que comecem com um dos seguintes caracteres:

  • igual a (=)
  • mais (+)
  • menos (-)
  • em (@)

são precedidos por um apóstrofo ('). Para garantir a consistência da funcionalidade, os arquivos ` CSV ` importados são analisados adicionalmente para remover automaticamente o apóstrofo ('). Essa limpeza também se aplica ao importar e exportar artefatos de governança para arquivos ZIP, uma vez que estes contêm arquivos ` CSV `.

Para desativar essa funcionalidade:

  1. Editar IBM watsonx.data intelligence Glossário Implementação de serviços:

    oc edit deployment wkc-glossary-service

  2. Configure a variável de ambiente ESCAPE_FORMULAS_IN_CSV_FILES como valor false.

Para obter mais informações, consulte Injeção de CSV.

Saiba Mais