Personalize descrições de coluna e instruções de uso

Crie descrições de coluna personalizadas e instruções de uso na tabela Configuração de coluna semântica para que as personalizações possam ser feitas transferido entre instâncias por meio de conjuntos de atualizações.

Antes de Iniciar

Função necessária: sn_query_gen.admin ou superior

Por Que e Quando Desempenhar Esta Tarefa

. Geração de consultas A camada semântica usa descrições de coluna e instruções de uso para ajudar a IA a entender o que cada campo representa e como consultá-lo. Você pode substituir as descrições geradas automaticamente do sys_documentation e adicione instruções de uso que orientam a construção da consulta.

Este procedimento usa a tabela Configuração de coluna semântica. As personalizações feitas dessa forma podem ser transferidas entre instâncias por meio de conjuntos de atualizações e substituir descrições e instruções de uso definidas diretamente na tabela de dimensão. Para testes de instância única mais simples, você pode editar os campos Rótulo semântico e Instruções de uso semântico diretamente na tabela Dimensão [sn_query_gen_dimension]. Essas mudanças podem ser substituídas por mudanças na tabela Dimensão incluída em um upgrade de plug-in.

Use a configuração de coluna quando quiser fornecer descrições personalizadas, adicionar instruções de uso para orientação de consulta ou desativar colunas específicas sem remover a tabela inteira da camada semântica.

Procedimento

1. Navegar até Geração de consulta > Configuração de coluna semântica.
2. Selecione Novo.
3. No formulário Configuração da coluna semântica, preencha as informações a seguir.

   Tabela 1. Formulário de configuração da coluna semântica

   Campo	Descrição
   Nome da tabela	A tabela à qual a coluna pertence. Deve ter uma entidade ativa na camada semântica.
   Nome da Coluna	A coluna a ser configurada. Use o nome da coluna do banco de dados, não o rótulo de exibição.
   Descrição semântica	Descrição personalizada do que a coluna representa em termos de negócios. Substitui a descrição gerada automaticamente de sys_documentation . Máximo de 2 000 caracteres.
   Instruções de uso de semântica	Orientação para IA sobre como usar esta coluna durante a geração de consulta. Inclua operadores preferenciais, formatos de valor esperado e comportamento de filtragem. Máximo de 2 000 caracteres.
   Ativo	Se a configuração da coluna foi aplicada. Quando desmarcada, a coluna retorna para o estado gerado automaticamente.

4. Selecione Enviar.
   O sistema sincroniza automaticamente a configuração com o registro de dimensão correspondente na camada semântica.

Resultado

A configuração de coluna personalizada está ativa e será usada por Geração de consultas ao processar consultas que envolvem esta coluna. Como essa personalização é armazenada na tabela Configuração de coluna semântica, ela pode ser incluída em um conjunto de atualizações e transferida para outras instâncias. Para obter mais informações, consulte System update sets.

Configurações de coluna

Os exemplos a seguir mostram descrições de coluna efetivas e instruções de uso:

Tabela 2. Exemplos de configuração de coluna

Coluna	Tipo	Descrição semântica	Instruções de uso
creation_type	Escolha	Indica como o conjunto de dados foi produzido. Valores: "Curado" (selecionado manualmente), "Derivado" (transformado de conjuntos de dados existentes), "Sintético" (gerado artificialmente).	Deixar em branco: Os valores de seleção são preenchidos automaticamente pelo sistema
dataset_creation_date	Data	A data em que o próprio conjunto de dados foi originalmente criado ou compilado, independentemente de quando o registro de ativo foi adicionado à instância.	Use operadores de data (>
base_datasets	Referência	Uma lista de outros ativos de conjunto de dados de IA dos quais este conjunto de dados é derivado ou criado, representando a linhagem do conjunto de dados.	Campo de referência. O uso ESTÁ VAZIO para encontrar conjuntos de dados originais/raiz. O uso NÃO ESTÁ VAZIO para encontrar conjuntos de dados derivados.

O que Fazer Depois

Teste sua configuração de coluna fazendo perguntas que envolvem este campo em Geração de consultas e verificando se os filtros corretos são gerados.