{

Métodos de importação para artefatos de governança

É possível importar artefatos de governança com um arquivo. Você pode importar um tipo de artefato de governança por vez ou importar todos os artefatos de governança de outra instância IBM watsonx.data intelligence.

Compatibilidade entre ambientes de implementação

Você pode exportar e importar artefatos de governança entre as instâncias do IBM watsonx.data intelligence nos seguintes ambientes de implementação:

  • Cloud Pak for Data 3.5
  • Cloud Pak for Data 4.x
  • Cloud Pak for Data 5.x
  • IBM watsonx

Os valores de Stewards não são compatíveis entre as instâncias IBM watsonx.data intelligence IBM watsonx e Cloud Pak for Data 3.5 ou 4.x.

Você pode importar artefatos de governança de IBM InfoSphere Information Governance Catalog para IBM watsonx.data intelligence instâncias em Cloud Pak for Data 3.5 e 4.x. Para importar artefatos de governança de IBM InfoSphere Information Governance Catalog para IBM watsonx.data intelligence em IBM watsonx, você deve editar cada arquivo CSV para se adequar ao formato dos arquivos IBM watsonx.data intelligence artefato CSV. Por exemplo, você pode precisar fazer os seguintes tipos de edital:

  • Remover colunas não suportadas
  • Separe os diferentes tipos de artefatos em vários arquivos CSV
  • Modificar colunas suportadas
  • Adicionar colunas necessárias

Comparação de métodos de importação

Escolha o método de importação adequado para seus objetivos e circunstâncias.

Importar um único tipo de artefato

Você pode importar um único tipo de artefato de governança por vez com um arquivo CSV.

Este método é útil nos seguintes tipos de circunstâncias:

  • Você quer que os artefatos importados sejam sujeitos a fluxo de trabalho.
  • Você deseja adicionar valores para uma propriedade a um tipo de artefato de governança. Exporte esse tipo de artefato como um arquivo CSV, edite o arquivo CSV e, em seguida, importe-o. Por exemplo, você pode usar este método para adicionar um atributo personalizado aos seus termos de negócio.
  • Você quer definir artefatos em outro programa. Crie arquivos CSV para cada tipo de artefato. Por exemplo, você pode usar este método para definir artefatos em um programa de planilha e depois importá-los.

Consulte Importação de artefatos de governança por tipo com arquivos CSV e formato de arquivo CSV para importar artefatos de governança.

Importar vários tipos de artefatos

Você pode importar vários tipos de artefatos de governança com um arquivo ZIP criado ao exportar vários tipos de artefatos de governança existentes de uma instância do IBM watsonx.data intelligence. O arquivo ZIP contém arquivos CSV para categorias e todos os tipos de artefatos exportados. Os arquivos CSV correspondem ao formato do arquivo de importação CSV, exceto por:

  • A coluna ID do artefato extra, que contém identificadores para artefatos em vez de identificar artefatos por nome e caminho de categoria.
  • Artefatos relacionados são definidos com IDs de artefatos em vez de contexto e nome.

Este método é útil nos seguintes tipos de circunstâncias:

  • Você deseja mover todos os artefatos de governança de uma instância do IBM watsonx.data intelligence para outra.

Consulte Importando vários tipos de artefatos de controle de uma instância com um arquivo ZIP Também é possível usar o comando cpd-cli para exportar e importar artefatos de controle com um arquivo ZIP dentro de um cluster do Cloud Pak for Data ou entre clusters diferentes Para obter mais informações, consulte Migração de artefatos de governança na documentação IBM Software Hub.

A tabela a seguir resume as diferenças entre importar artefatos com arquivos CSV ou um arquivo ZIP.

Características arquivo CSV Arquivo ZIP
Criação de Arquivo Exportar um tipo de artefatos existentes
Criar um arquivo em um programa de planilha
Exportar artefatos de IBM InfoSphere Information Governance Catalog e ajustar o formato		 Exportar vários tipos de artefatos de uma instância
Número de tipos de artefato Categorias ou um tipo de artefato por arquivo. Vários tipos de artefatos, com categorias e cada tipo de artefato em um arquivo CSV separado.
importar métodos • Através da UI
• Pedido de API		 Solicitação da API da CLI
:
Fluxo de trabalho Todos os artefatos são importados como rascunho e estão sujeitos a fluxo de trabalho. As categorias são publicadas imediatamente porque não estão sujeitas a fluxo de trabalho. Todos os artefatos e categorias são publicados imediatamente.
Permissões necessárias Permissões para criar ou editar categorias. Você deve ser pelo menos um Editor na categoria para a qual está importando. Para obter detalhes, consulte Permissões necessárias.. A permissão Gerenciar glossário

Artefatos de governança que você pode importar

Com ambos os métodos de importação, é possível importar categorias e os seguintes tipos de artefatos de governança:

Restrições:

  • Artefatos reimportados (artefatos vinculados a versões publicadas) podem ser publicados apenas como uma nova revisão, não como uma versão.
  • Você pode importar valores para todas as propriedades desses tipos de artefatos de governança, incluindo relacionamentos com outros artefatos. No entanto, os relacionamentos são importados apenas quando o artefato relacionado existe ou é definido no mesmo processo de importação. Para adicionar relações que o processo de importação pulou, primeiro pubque todos os artefatos de rascunho importados e, em seguida, execute o processo de importação novamente.
  • Não é possível usar o CSV para mover artefatos de governança e suas relações entre instâncias d Cloud Pak for Data. Por exemplo, se você tentar exportar classes de dados com o método Match para referenciar dados para CSV e, em seguida, importá-los para outra instância Cloud Pak for Data, a importação falhará, pois o ID do artefato não está incluído nas importações e exportações CSV. Use a importação ZIP em vez disso.
  • Ao importar um conjunto de dados de referência de um arquivo CSV, os valores dos dados de referência desse conjunto não são importados. Você deve usar um arquivo separado CSV para importar os valores para o conjunto de dados. Alternativamente, você pode usar uma importação ZIP para importar tanto o conjunto de dados de referência quanto seus valores de dados de referência. Para obter mais informações, consulte Importando arquivos para conjuntos de dados de referência.
  • Não é possível importar regras de proteção de dados nem regras de SLA de qualidade de dados.

Métodos para mesclar artefatos importados e existentes

Quer você importe artefatos com arquivos CSV ou um arquivo ZIP, é necessário escolher o que acontecerá quando você importar artefatos de governança que já existem e os valores das propriedades forem diferentes. A tabela a seguir resume os três métodos de mesclagem.

Método de mesclagem API do Efeito sobre os valores originais Efeito sobre os valores importados
Substituir todos os valores merge_option=all Descarte todos os valores originais. Aceite todos os valores importados, até valores vazios.
Substituir por valores definidos merge_option=specified Retenha valores originais se os valores importados estiverem vazios. Aceite todos os valores importados, exceto valores vazios.
Substituir valores vazios merge_option=empty Reter valores originais, exceto valores vazios. Aceite apenas valores importados que substituam valores vazios.

Para novos artefatos, cada um desses métodos produz os mesmos resultados.

Substituir todos os valores

Todos os valores originais do artefato são descartados e substituídos pelos valores do artefato importado. Se o valor de um imóvel para o artefato importado estiver vazio, quaisquer valores originais para essa propriedade são removidos.

Por exemplo, suponha que você tenha um termo comercial publicado chamado release e importe um arquivo CSV para modificá-lo. A tabela a seguir mostra o efeito da opção Recolocar todos os valores :

Propriedade Valores originais Valores no arquivo CSV Valores resultantes
Nome liberação liberação liberação
Tipo de artefato glossário_termo glossário_termo glossário_termo
Categoria marketing marketing marketing
Descrição termo de exemplo exemplo de termo editado exemplo de termo editado
Etiquetas beta beta
Termos relacionados marketing>> versão marketing>> data marketing>> data
Classificações

Confidencial

O artefato de rascunho resultante tem essas alterações nos valores originais:

  • A descrição original é substituída por uma nova descrição.
  • O valor vazio original para tags é substituído por um valor.
  • O termo relacionado original é substituído por um novo termo relacionado.
  • O valor de classificação original é substituído por um valor vazio.
Nota:

Ao usar a opção all de mesclagem, você deve garantir que todo o conteúdo do CSV esteja consistente em relação às relações entre os artefatos. Por exemplo, se o arquivo ZIP importado contiver um termo e uma classe de dados conectados por uma relação, essa relação deverá estar presente tanto nas classes de dados CSV quanto nos termos CSV. Caso contrário, o comportamento de importação do relacionamento será imprevisível, o relacionamento poderá ou não ser importado

Ao importar arquivos ZIP que contêm valores de dados de referência, deve-se sempre usar merge_option=all na chamada API.

Substituir por valores definidos

Os valores originais e vazios do artefato são substituídos pelos valores fornecidos do artefato importado. Se o valor de uma propriedade para o artefato importado estiver vazio, quaisquer valores originais para essa propriedade serão retidos.

Por exemplo, suponha que você tenha um termo comercial publicado chamado release e importe um arquivo CSV para modificá-lo. A tabela a seguir mostra o efeito da opção Substituir por valores definidos :

Propriedade Valores originais Valores no arquivo CSV Valores resultantes
Nome liberação liberação liberação
Tipo de artefato glossário_termo glossário_termo glossário_termo
Categoria marketing marketing marketing
Descrição termo de exemplo exemplo de termo editado exemplo de termo editado
Etiquetas beta beta
Termos relacionados marketing>> versão marketing>> data marketing>> data
Classificações

Confidencial

Confidencial

O artefato de rascunho resultante tem essas alterações nos valores originais:

  • A descrição original é substituída por uma nova descrição.
  • O valor vazio original para tags é substituído por um valor.
  • O termo relacionado original é substituído por um novo termo relacionado.

Substituir valores vazios

Os valores vazios do artefato original são substituídos pelos valores fornecidos do artefato importado.

Por exemplo, suponha que você tenha um termo comercial publicado chamado release e importe um arquivo CSV para modificá-lo. A tabela a seguir mostra o efeito da opção Substituir valores vazios :

Propriedade Valores originais Valores no arquivo CSV Valores resultantes
Nome liberação liberação liberação
Tipo de artefato glossário_termo glossário_termo glossário_termo
Categoria marketing marketing marketing
Descrição termo de exemplo exemplo de termo editado termo de exemplo
Etiquetas beta beta
Termos relacionados marketing>> versão marketing>> data marketing>> versão
Classificações

Confidencial

Confidencial

O artefato de rascunho resultante tem essa mudança para os valores originais:

  • O valor vazio original para tags é substituído por um valor.

Tratamento de versões e datas efetivas ao importar artefatos

Os rascunhos importados dos artefatos existentes podem ser publicados apenas como uma nova revisão, não como uma versão.

As datas de vigência são ignoradas no processo de importação.

Se os rascunhos importados forem artefatos novos (ou seja, não estiverem atribuídos a nenhuma versão publicada), a data de início será definida automaticamente como a data de publicação.

Se os artefatos forem reimportados (ou seja, os rascunhos importados estiverem vinculados às versões publicadas), a data de início efetiva já estará definida na versão ativa existente e permanecerá a mesma após a publicação do rascunho importado.

Uma versão obtém a data de término efetiva no momento em que se torna inativa ao ser substituída por uma nova versão.

Considerações de segurança

Os dados de governança exportados para arquivos do CSV são sanitizados contra ataques conhecidos de injeção de código ( CSV ), para garantir a segurança dos programas de planilhas que interpretam automaticamente os dados do CSV. Como resultado, quaisquer valores de texto que comecem com um dos seguintes caracteres:

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

são precedidos por um caractere de aspa simples ('). Para tornar a funcionalidade consistente, os arquivos importados CSV são analisados adicionalmente para remover automaticamente o caractere de aspa simples ('). A sanitização também se aplica ao importar e exportar artefatos de governança para arquivos ZIP, pois eles 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