Projetando conjuntos de dados de referência

Ao projetar um conjunto de dados de referência, você deve decidir qual formato de valores usar, quais pares de valores de código constituem o conjunto e se o conjunto deve ser relacionado a quaisquer outros conjuntos existentes. Você pode importar os conjuntos de dados de referência já existentes e modificá-los para se adequar às suas necessidades, ou criar um novo conjunto de dados de referência manualmente.

Os dados de referência são usados para categorizar outros dados dentro de aplicativos corporativos e bancos de dados. Os dados de referência podem ser padronizados por organizações como a ISO. Os dados de referência podem ser hierárquicos. Pode haver vários conjuntos de dados de referência para o mesmo domínio, no qual os mapeamentos de casos entre os valores de dados de referência podem ser especificados.

Um conjunto de dados de referência consiste em vários valores de dados de referência, em que cada valor de dados de referência deve, pelo menos, ter um código e seu valor definido.

Você pode criar um novo conjunto de dados de referência usando a interface do usuário ou importar suas propriedades a partir de um arquivo ` CSV `. O mesmo se aplica aos valores dos dados de referência: eles podem ser inseridos manualmente ou importados do arquivo CSV. Observe que os arquivos ` CSV ` para conjuntos de dados de referência e para valores de dados de referência são diferentes.

Você pode utilizar um dos seguintes métodos para importar conjuntos de dados de referência:

  • Importe um ou mais conjuntos de dados de referência a partir de um arquivo ZIP previamente exportado usando uma solicitação de API. O arquivo ZIP contém um arquivo ` CSV ` com as propriedades que definem um ou mais conjuntos de dados de referência e, para cada conjunto de dados de referência, um arquivo ` CSV ` que lista os valores dos dados de referência.
  • Importe informações do conjunto de dados de referência a partir de um arquivo ` CSV ` usando a interface do usuário ou uma solicitação de API. Vários conjuntos de dados de referência podem ser importados em um arquivo. Este método não inclui valores de dados de referência-eles devem ser importados separadamente.
  • Importe valores de dados de referência de um arquivo ` CSV ` para um conjunto específico usando a interface do usuário ou uma solicitação de API.

Para saber mais sobre esses métodos de importação e as diferenças entre eles, consulte Métodos de importação para artefatos de governança.

Você também pode usar um dos conjuntos de dados de referência predefinidos. Além disso, cada Acelerador do Conhecimento fornece centenas de conjuntos de dados de referência para um setor específico que você pode usar. Veja conjuntos de dados de referência em Knowledge Accelerators.

Os planos de serviço legado IBM Knowledge Catalog e Watsonx.data intelligence têm limites para o número e o tamanho dos conjuntos de dados de referência que você pode criar.

Propriedades dos conjuntos de dados de referência

Conjuntos de dados de referência possuem essas propriedades padrão que são semelhantes a outros artefatos de governança.

Propriedade ou comportamento Há suporte? Explicação
Deve ter nomes exclusivos? True Os nomes de conjuntos de dados de referência devem ser exclusivos dentro de uma categoria.
Descrição? True Opcional. Inclua uma descrição para ajudar os usuários a encontrar esse conjunto de dados de referência.
Adicionar relações a outros conjuntos de dados de referência? True Veja Relacionamentos com outros conjuntos de dados de referência.
Incluir relacionamentos com outros tipos de artefatos de governança? True Veja Relacionamentos com outros tipos de artefatos de governança.
Incluir relacionamento no ativo? True Consulte Relacionamentos de ativos em catálogos.
Incluir atributos customizados? True Veja Atributos e relacionamentos customizados
Incluir relacionamentos customizados? True Veja Atributos e relacionamentos customizados
Organizar em categorias? True A categoria primária do artefato determina quem pode visualizá-lo ou modificá-lo. Veja Categorias.
Importar de um arquivo? True Consulte Importando artefatos de governança.
Importar de um acelerador de conhecimento? True
Exportar para um arquivo? True Veja Exportando artefatos de governança.
Gerenciado por fluxos de trabalho? True Consulte Fluxos de trabalho.
Especificar datas de início e término efetivas? True Consulte Datas efetivas.
Designar um organizador? True Consulte Organizador
Incluir tags como propriedades? True Consulte Tags.
Artefatos predefinidos? True Locais Físicos, Locais Soberanos. Veja Conjuntos de dados de referência Predefinidos

Ao criar um novo conjunto de dados de referência, deve-se decidir qual o tipo de uso. O tipo que você escolhe determina o formato da coluna de valor para valores de dados de referência:

Texto
Pode ser uma sequência ou sequência multilinhas.
Número
Não suporta valores booleanos, binários, ou hexadecimais
Data
Formato de data e hora do ISO

Propriedades dos valores de dados de referência

Um conjunto de dados de referência inclui uma série de valores de dados de referência. Estes valores consistem em, pelo menos, as colunas a seguir:

Código
Uma sequência de até 255 caractere. A coluna de código é sempre do tipo Texto.
Valor
O formato do valor é determinado pelo tipo de conjunto de dados de referência: Texto, Número, Data.
Descrição
Valores são opcionais.
parent
Valores são opcionais. O relacionamento pai aponta para outro valor de dados de referência no mesmo conjunto. Ao especificar o pai é possível construir uma árvore de hierarquia de valores de dados de referência.

Código com distinção entre maiúsculas e minúsculas

O código de distinção entre maiúsculas e minúsculas foi introduzido em 16 de fevereiro de 2024.. Para todos os conjuntos de dados de referência criados após essa data, a coluna de código faz distinção entre maiúsculas e minúsculas Quando você inclui valores em um novo conjunto de dados de referência, o código é salvo exatamente conforme você o digita. Os códigos a seguir são tratados como três entradas exclusivas:

  • EUA
  • Nós
  • br

Antes, todos os códigos eram automaticamente alterados para maiúsculas ao salvar, por exemplo:

  • us foi salvo como US
  • 1pl foi salvo como 1PL

Observe que quaisquer conjuntos de dados de referência que foram criados antes dessa mudança ser introduzida permanecem sem distinção entre maiúsculas e minúsculas e quaisquer novos valores incluídos serão salvos em maiúsculas. Esses conjuntos de dados de referência são marcados com uma tag Sem distinção entre maiúsculas e minúsculas na IU.

Colunas customizadas

Pode ser necessário capturar informações adicionais relacionadas ao código, como traduções do valor em diferentes idiomas ou outras informações de atributo de apoio relevantes para suas necessidades... Por exemplo, você pode ter um conjunto de dados de referência de códigos de país e deseja capturar alguns outros atributos, como primeiro-ministro do país, idioma ou nomes alternativos. Para esses propósitos, é possível incluir colunas customizadas das maneiras a seguir usando a IU:

  • É possível definir manualmente colunas customizadas ao criar um novo conjunto de dados de referência.. Observe que as colunas customizadas não podem ser modificadas ou incluídas manualmente quando o conjunto de dados de referência é criado.
  • Você pode usar a importação de arquivos do CSV para criar um novo conjunto de dados de referência e mapear as colunas do arquivo para novas colunas personalizadas.
  • Você pode importar ou reimportar valores de um arquivo do tipo “ CSV ” para um conjunto de dados de referência existente e usar o mapeamento de colunas para criar novas colunas personalizadas.

Para obter mais informações, consulte Importando colunas customizadas

Chaves compostas

Os valores de dados de referência em um conjunto são identificados por um código exclusivo No entanto, pode ser necessário identificar os dados usando mais de uma coluna Uma chave composta é uma combinação da coluna de códigos e de até 5 colunas customizadas em um conjunto de dados de referência A chave composta é usada para identificar exclusivamente cada valor de dados de referência. Com uma chave composta, os valores na coluna de código não precisam mais ser exclusivos A exclusividade é garantida apenas quando os valores de todas as colunas especificadas são combinados-os valores em colunas individuais não são, necessariamente exclusivos

Quando você define uma chave composta para o conjunto, cada valor de dados de referência em tal conjunto é identificado no sistema por uma representação física da chave composta, que é uma concatenação da coluna de código e as colunas customizadas da chave composta na ordem especificada quando o conjunto foi criado inicialmente. Os valores são delimitados por |, por exemplo: CODE|CC1|CC2|CC3.. Essa representação física é usada para identificar valores de dados de referência no sistema (por exemplo, para controlar relacionamentos) e não pode ser alterada.

Para saber como criar conjuntos de dados de referência com chaves compostas, consulte Criando conjuntos de dados de referência com chaves compostas

Relacionamentos com outros tipos de artefatos de governança

Relações entre classes de dados e conjuntos de dados de referência: as classes de dados podem incluir conjuntos de dados de referência em métodos de correspondência de dados. O conjunto de dados de referência é então usado para avaliar se colunas em ativos de dados atendem aos critérios para a designação da classe de dados. Consulte Incluindo correspondência de dados em classes de dados.

Relacionamento com termos de negócios: Você pode atribuir termos de negócios ao conjunto de dados de referência ou a um valor de dados de referência específico para definir ainda mais o significado do código.

Relações com outros conjuntos de dados de referência

Você pode criar relacionamentos hierárquicos para seus conjuntos de dados de referência que estabelecem conexões lógicas entre eles. Também é possível criar relacionamentos entre os valores em conjuntos de dados de referência Veja Relacionamentos entre conjuntos de dados de referência.

Trabalhando com conjuntos de dados de referência

Você pode trabalhar com um conjunto de dados de referência das seguintes formas:

  • Clique em (Ícone de download) para baixar os valores dos dados de referência em um arquivo do tipo ` CSV `. Você pode então editar o arquivo ` CSV ` localmente, o que geralmente proporciona mais rapidez e flexibilidade no seu trabalho.
  • Importe valores de um arquivo do tipo “ CSV ” selecionando “Carregar arquivo” no menu de ações ao lado do nome dos dados de referência e seguindo as instruções.
  • Crie seus próprios valores clicando em (Incluir ícone).
  • Edite um valor de dados de referência (seu valor, descrição ou valor pai) clicando em (Ícone de edição).
  • Reorganize como as coluna são exibidas na visualização de valor de dados de referência clicando em Gerenciar colunas.
  • Exclua valores de dados de referência clicando em Excluir valor. Marque diversos valores para exclusão com a tecla Ctrl.
  • Atribua artefatos relacionados ao conjunto de dados de referência, tais como termos de negócios ou classificações.
  • Adicionar termos de negócios relacionados a um valor escolhido.
  • Inclua valores relacionados em um valor escolhido. É possível relacionar valores do mesmo conjunto ou entre conjuntos diferentes. Você pode importá-los a partir de um arquivo do tipo “ CSV ” selecionando “Carregar valores relacionados” no menu de ações ao lado do nome dos dados de referência e seguindo as instruções.

Para saber mais sobre as tarefas comuns a todos os artefatos de governança, consulte Gerenciamento de artefatos de governança

Saiba Mais