CSV formato de arquivo para importar e exportar relações entre ativos

O arquivo ` CSV `, utilizado para importar e exportar detalhes de relações entre ativos, deve seguir regras específicas de formatação.

Limitações

  • A codificação do arquivo é UTF-8.
  • O tamanho máximo recomendado para um arquivo é de 10.000 linhas.
  • Os nomes das relações são os nomes padrão exibidos para as relações.
  • As relações só podem ser estabelecidas entre um ativo ou coluna e outro ativo, coluna ou artefato.
  • Não são suportadas relações entre um artefato e um ativo ou coluna.
  • São suportadas relações entre contêineres (áreas de trabalho).

Linha de cabeçalho

Os cabeçalhos na primeira linha do arquivo ` CSV ` indicam quais propriedades são importadas para as relações.

  • A linha de cabeçalho deve ser a primeira linha do arquivo e não deve ser repetida.
  • O cabeçalho deve incluir os campos obrigatórios.

Campos obrigatórios

A linha de cabeçalho do arquivo ` CSV ` deve incluir os seguintes cabeçalhos obrigatórios:

Relationship Name
Exibir o nome da relação em inglês por padrão. Não utilize nomes localizados.
Exemplo Contains
Source Item Type
Tipo da relação de origem: ativo ou coluna.
Exemplo column
Source Workspace Type
Contêiner de origem: catálogo, projeto ou espaço.
Exemplo project
Source Workspace Name
Nome do contêiner de origem.
Exemplo Test project
Source Asset Name
Nome do recurso de origem.
Exemplo Test asset
Source Column Name
Nome da coluna se Source Item Type for column.
Exemplo Column1
Target Item Type
Tipo da relação de destino: ativo, coluna ou artefato.
Exemplo artifact
Target Workspace Type
Recipiente de destino: catálogo, projeto ou espaço. Opcional se Target Item Type for artifact.
Target Workspace Name
Nome do contêiner de destino. Opcional se Target Item Type for artifact.
Target Asset Name
Nome do ativo de destino. Opcional se Target Item Type for artifact
Target Asset Resource Key
Chave de recurso do ativo de destino. Opcional se Target Item Type for artifact.
Target Column Name
Nome da coluna de destino se Target Item Type for column. Opcional se Target Item Type for artifact ou asset.
Target Category
Caminho da categoria do artefato. Opcional se Target Item Type for asset ou column.
Exemplo Root category>>Subcategory
Target Artifact Name
Nome do artefato. Opcional se Target Item Type for asset ou column.
Exemplo Test category
Target Artifact Type
Uma das seguintes categorias do artefato: categoria, termo_do_glossário, classificação, classe_de_dados, regra, política, dados_de_referência. Opcional se Target Item Type for asset ou column.
Exemplo category

Cabeçalhos opcionais

Para definir relações mais detalhadas entre os ativos, adicione os cabeçalhos opcionais apropriados ao seu arquivo ` CSV `.

Source Asset Resource Key
Chave de recurso do ativo de origem.
Exemplo testdata.csv

Exemplos de relações entre recursos no arquivo ` CSV `

Relationship Name,Source Item Type,Source Workspace Type,Source Workspace Name,Source Asset Name,Source Asset Resource Key,Source Column Name,Target Item Type,Target Workspace Type,Target Workspace Name,Target Asset Name,Target Asset Resource Key,Target Column Name,Target Category,Target Artifact Name,Target Artifact Type
Has part,asset,catalog,import test,BANK_CLIENTS,0000:0000:0000:0000:0000:FFFF:A92C:974B|50000|BANK:/BANK1/BANK_CLIENTS,,column,catalog,csv-test-2,BANK_ACCOUNTS,0000:0000:0000:0000:0000:FFFF:091E:6D11|50000|Bank:/BANK2/BANK_ACCOUNTS,CUSTOMER_ID,,,
Implements,column,catalog,import test,BANK_CLIENTS,0000:0000:0000:0000:0000:FFFF:A92C:974B|50000|BANK:/BANK1/BANK_CLIENTS,CLIENT_ID,artifact,,,,,,Locations,Physical Locations,reference_data
Governs,asset,catalog,import test,BANK_CLIENTS,0000:0000:0000:0000:0000:FFFF:A92C:974B|50000|BANK:/BANK1/BANK_CLIENTS,,artifact,,,,,,[uncategorized],Account Number,data_class
Contains,asset,catalog,import test,BANK_CLIENTS,0000:0000:0000:0000:0000:FFFF:A92C:974B|50000|BANK:/BANK1/BANK_CLIENTS,,asset,catalog,csv-test-1,0 - EMD Mapping 1,/root###jjw_EMD_out###0 - EMD Mapping 1,,,,

No exemplo, há quatro registros que ilustram as relações:

  1. Has part:transferir um ativo para uma coluna em um catálogo diferente.
  2. Implements: coluna para artefato reference_data.
  3. Governs: de ativo para artefato data_class.
  4. Contains: de um recurso para outro recurso em um catálogo diferente.

Saiba mais