Importando todos os artefatos de governança de uma instância com um arquivo ZIP

É possível importar todos os artefatos de governança de uma instância do IBM watsonx.data intelligence com um arquivo ZIP que você criou exportando os artefatos.

Você pode usar esse método para mover artefatos de governança de uma instância do IBM watsonx.data intelligence para outra ou para editar as propriedades do artefato de governança com uma ferramenta externa. Todos os artefatos importados são publicados imediatamente sem fluxo de trabalho.

Pré-requisitos

Antes de importar artefatos de governança com um arquivo ZIP, crie o arquivo com o formato correto e certise-se de que você tem as permissões necessárias.

Arquivo ZIP

Você deve ter um arquivo ZIP de artefatos exportados que você criou com a solicitação de API GET /v3/governance_artifact_types/{artifact_type}/export . O tamanho máximo do arquivo ZIP é 2 GB. Veja Exportando todos os artefatos de governança para um arquivo ZIP.

Permissões

Você deve ter a permissão de usuário Manage glossary (Gerenciar glossário ).

Você não precisa ser um colaborador em nenhuma das categorias que são criadas ou afetadas pelo processo de importação.

Editando o conteúdo do arquivo ZIP

O arquivo ZIP exportado contém uma pasta separada para cada tipo de artefato, com um arquivo ` CSV ` que contém esse tipo de artefato.

Você pode modificar conteúdo do arquivo ZIP exportado manualmente. Siga estas diretrizes:

  • Não crie pastas adicionais, por exemplo, uma pasta pai.
  • Não altere os nomes da pasta. As pastas para cada tipo de artefato no arquivo ZIP devem ter os seguintes nomes: category, classification, data_class, glossary_term, policy, rulee reference_data.
  • Mantenha o formato correto de cada arquivo ` CSV `. Consulte o formato de arquivo ` CSV ` para importar artefatos de governança.
  • Não remova nem renomeie a Artifact ID coluna em cada arquivo ` CSV `. Esta coluna especifica o identificador do artefato em adição ao nome do artefato.
  • Defina uma relação entre dois artefatos de governança para apenas um dos artefatos. Há duas exceções:
    1. O relacionamento é entre uma política e uma regra de controle Nesse caso, defina a relação entre os dois artefatos nos dois arquivos ` CSV `. No arquivo CSV, que contém as políticas, adicione a relação na Rule coluna. No arquivo CSV, que contém as regras de governança, adicione a relação na Parent Policies coluna.
    2. Você está usando a opção de mesclagem all .. Nesse caso, você deve garantir que todo o conteúdo do ` CSV ` seja consistente no que diz respeito às relações entre os artefatos. Por exemplo, se o arquivo ZIP de importação contiver tanto um termo quanto uma classe de dados interligados por uma relação, essa relação deve estar presente em ambas as classes de dados CSV e termos CSV. Caso contrário, o comportamento de importação do relacionamento será imprevisível, o relacionamento poderá ou não ser importado

Preparando-se para importar um arquivo ZIP

Antes de importar um arquivo ZIP, você deve preencher as seguintes tarefas:

  • Executar a ação apropriada para evitar artefatos predefinidos ausentes ou duplicados
  • Criar quaisquer propriedades e relacionamentos personalizados

Evite artefatos predefinidos duplicados ou ausentes

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. Por isso, os termos de negócios predefinidos predefinidos, classes de dados e classificações não são reconhecidos como sendo os mesmos termos de negócios predefinidos existentes, classes de dados e classificações. Como resultado, o processo de importação cria artefatos duplicados. Quando uma categoria principal não é importada devido a uma ID conflitante, os artefatos dessa categoria podem estar ausentes.

Você pode evitar os artefatos prefinados duplicados com um dos seguintes métodos:

  • 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.

    Ao importar os artefatos, são criados relacionamentos para os artefatos predefinidos de destino exisiting.

  • 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 ` para termos de negócios e outros artefatos e substitua os identificadores de artefato dos termos de negócios predefinidos pelos nomes de artefato 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.

    Ao importar os artefatos, são criados relacionamentos para os artefatos predefinidos de destino exisiting.

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.

Criar propriedades e relacionamentos personalizados

Você deve criar cada propriedade customizada ou definição de relacionamento manualmente antes de importar o arquivo ZIP. Caso contrário, os valores de propriedade e de relacionamento personalizados não são importados.

Para obter mais informações, consulte Propriedades e relacionamentos personalizados.

Opções de Merge

As opções de mesclagem a seguir estão disponíveis ao executar a importação ZIP:

all
Substitua todos os valores Os valores importados substituem valores existentes em um catálogo.
specified
Substitua por valores definidos Valores importados que não estão vazios substituem valores existentes em um catálogo.
empty
Substituir valores vazios. Valores importados substituem apenas valores vazios em um catálogo.

specified é usado como padrão..

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

Para obter mais informações sobre as opções de mesclagem, consulte Métodos para mesclar artefatos importados e existentes

Importando um arquivo ZIP

Para importar um arquivo ZIP de artefatos de governança:

  1. Se necessário, exclua os artefatos predefinidos existentes ou edite relacionamentos para artefatos predefinidos. Veja Preparando para importar um arquivo ZIP.
  2. Envie a solicitação POST /v3/governance_artifact_types/import. Inclua a opção de mesclagem e o caminho para o arquivo ZIP. Veja Documentação da API: Valores de Importação do arquivo ZIP especificado. Todos os artefatos são publicados imediatamente sem fluxo de trabalho.
  3. Quando o processo de importação estiver concluído, inclua outros colaboradores nas novas categorias. Veja Gerenciando colaboradores da categoria.

Você deve aguardar até que o processo de importação seja concluído, ou você limpe o processo paralisado, antes de poder iniciar um novo processo de importação.

Monitoramento do processo de importação

Depois de enviar a solicitação para importar o arquivo ZIP, um ID de processo é fornecido na resposta (parâmetroprocess_id ). É possível usar o ID do processo para verificar o status da importação. Envie uma solicitação GET /v3/governance_artifact_types/import/status/{process_id} para consultar o status de importação. Consulte a documentação da API: Status da importação.

Limpeza de um processo de importação paralisado

Experimental Esta é uma versão experimental e ainda não tem suporte para uso em ambientes de produção.

Se a importação de estantes, você pode limpar o processo de importação e, em seguida, importar o arquivo ZIP novamente. Você não pode iniciar um novo processo de importação até que o anterior seja concluído ou você limpa o processo paralisado. Todos os processos de importação são limpos automaticamente após 24 horas de inatividade.

Você pode verificar o status do processo de importação enviando uma solicitação GET /v3/governance_artifact_types/import/status/{process_id} . O processo é estancado se o status for IN_PROGRESS, mas artefatos não estão sendo importados.

Para limpar um processo de importação paralisado ou com falha, envie a solicitação POST /v3/governance_artifact_types/import/cleanup/{process_id} .

Consulte a documentação da API: Limpar o processo de importação de ZIP.

Saiba Mais