Editor de exibição semântica¶
O editor de exibição semântica na Snowsight fornece uma interface visual para criar e editar exibições semânticas. Se você está refinando uma exibição criada pelo Autopilot, criando uma do zero ou editando uma especificação YAML carregada, o editor ajuda a definir conceitos comerciais, métricas e relações em seus dados.
O editor de exibição semântica permite:
Definir tabelas lógicas que mapeiam para suas tabelas de banco de dados físicas
Criar dimensões (atributos categóricos), fatos (dados em nível de linha) e métricas (medidas agregadas)
Estabelecer relações entre tabelas
Adicionar consultas verificadas como exemplos para Cortex Analyst
Fornecer instruções personalizadas para geração de consultas
Configurar sinônimos e descrições para melhorar a capacidade de descoberta
Acessando o editor¶
Você pode acessar o Editor de exibição semântica pelo catálogo de dados ou pelo Cortex Analyst.
Pelo catálogo de dados¶
Para acessar uma exibição semântica existente pelo catálogo de dados:
Faça login no Snowsight.
No menu de navegação, selecione Catalog » Database Explorer
Navegue até seu banco de dados e esquema.
Selecione Semantic Views na lista de objetos.
Selecione a exibição semântica que você quer editar.
Selecione a guia Semantic information para abrir o editor.
Pelo Cortex Analyst¶
Para acessar as exibições semânticas pelo Cortex Analyst:
Faça login no Snowsight.
No menu de navegação, selecione AI & ML » Cortex Analyst.
Selecione a guia Semantic Views.
Uma das seguintes opções:
Selecione uma exibição existente para editá-la
Selecione Create new para criar uma nova exibição semântica
Edição de metadados de exibição semântica¶
O nome e a descrição da exibição semântica ajudam os usuários a descobrir e entender a finalidade da exibição.
Para editar o nome ou a descrição da exibição semântica:
No editor, selecione Edit ao lado do nome da exibição semântica na parte superior da página.
Atualize os campos Name ou Description.
Selecione Save.
Dica
Escreva descrições claras e detalhadas que expliquem:
Quais perguntas comerciais essa exibição pode responder
Quais fontes de dados ela inclui
Quem deve usar esta exibição
Exemplo: “Análise de receita entre produtos e clientes, incluindo tendências ano a ano. Use essa exibição para analisar o desempenho de vendas por região, categoria de produto e segmento de cliente.»
Gerenciamento de tabelas lógicas¶
As tabelas lógicas representam entidades comerciais (como clientes, pedidos ou produtos) e são mapeadas para tabelas ou exibições de banco de dados físicas. Cada exibição semântica contém uma ou mais tabelas lógicas.
Adição de uma tabela lógica¶
Para adicionar uma tabela lógica à sua exibição semântica:
No editor, selecione + Logical Table.
Navegue e selecione a tabela física ou a exibição de seu banco de dados.
Selecione Next.
Escolha quais colunas incluir na tabela.
Selecione Generate logical table.
O editor gera automaticamente dimensões e fatos com base nas colunas selecionadas.
Edição de uma tabela lógica¶
Para modificar uma tabela lógica existente:
Selecione Edit ao lado do nome da tabela (ou selecione More options » Edit Logical Table).
Modifique as propriedades da tabela:
Name: o nome simples da tabela
Description: explicação do que a tabela representa
Synonyms: nomes alternativos (separados por vírgulas)
Primary Key: colunas que identificam linhas de forma única
Selecione Save.
Dica
Use o botão Generate fields para deixar a AI preencher automaticamente descrições e sinônimos com base em seus dados e nomes de colunas. Isso pode acelerar significativamente o processo de configuração inicial.
Definição de fatos, dimensões e métricas¶
Dentro de cada tabela lógica, você define os conceitos comerciais que os usuários podem consultar: dimensões, fatos e métricas.
Explicação dos tipos de conteúdo¶
Dimensões: atributos categóricos que fornecem contexto (como nome do cliente, categoria do produto ou data do pedido)
Fatos: dados quantitativos em nível de linha (como valor de venda, quantidade ou preço unitário)
Métricas: Medidas agregadas calculadas a partir de funções como SUM, AVG ou COUNT (como receita total, valor médio do pedido)
Adição de dimensões, fatos ou métricas¶
Para adicionar um novo item a uma tabela lógica:
Navegue até a tabela lógica no editor.
Selecione + ao lado de Dimensions, Facts ou Metrics.
Insira os detalhes necessários:
Name: nome descritivo do item
Expression: expressão SQL para calcular o valor
Data Type: o tipo de dados do resultado
Selecione Add
Edição ou remoção de itens¶
Para modificar ou excluir uma dimensão, fato ou métrica existente:
Selecione o item para abrir seus detalhes e editar propriedades.
Ou selecione More options » Remove para excluir o item.
Selecione Save para aplicar as alterações.
Recursos avançados¶
Métricas derivadas: você pode criar métricas em nível de exibição que combinem métricas de várias tabelas. Para obter mais informações, consulte Definição de métricas derivadas.
Modificadores de acesso privado: marque fatos ou métricas como privados para ocultá-los das consultas sem deixar de usá-los em outros cálculos. Para obter mais informações, consulte Marcação de fato ou métrica como privado.
Caminhos de junção preferidos para métricas: Se houver vários caminhos de relacionamento entre duas tabelas lógicas, você poderá escolher o relacionamento que será usado no menu Preferred join path.
Gerenciando relacionamentos¶
Os relacionamentos definem como as tabelas lógicas se unem, permitindo consultas que abrangem várias tabelas. Cada relacionamento define quais colunas em uma tabela fazem referência a colunas em outra tabela.
Adição de um relacionamento¶
Para criar um relacionamento entre duas tabelas lógicas:
No editor, selecione + ao lado de Relationships.
Insira um Name descritivo para o relacionamento (por exemplo, “pedidos_por_clientes”).
Selecione Left Table (a tabela com a chave estrangeira).
Selecione Right Table (a tabela sendo referenciada).
Especifique Join Columns para cada tabela:
Left Column: a(s) coluna(s) de chave estrangeira na tabela esquerda
Right Column: a(s) coluna(s) de chave primária ou única na tabela direita
Selecione Add.
O relacionamento agora aparece na lista “Relationships” e permite que o Cortex Analyst gere consultas unindo essas tabelas.
Nota
Para exibições semânticas, normalmente você não precisa especificar tipos de junção (externa esquerda, interna) ou tipos de relacionamento (um para um, muitos para um). Elas são inferidas automaticamente a partir dos dados e definições de chave primária no momento da consulta.
Edição ou remoção de relacionamentos¶
Para modificar ou excluir um relacionamento:
Selecione o relacionamento para exibir seus detalhes.
Edite as propriedades conforme necessário ou selecione Remove para excluí-lo.
Selecione Save para aplicar as alterações.
Recursos avançados para Cortex Analyst¶
Para melhorar a precisão e a confiabilidade do Cortex Analyst, você pode adicionar contexto e orientações por meio de consultas verificadas, sinônimos e instruções personalizadas.
Consultas verificadas¶
As consultas verificadas fornecem exemplos de perguntas com as respostas SQL corretas. Elas servem para duas coisas:
Ajudar o Cortex Analyst a entender como responder a perguntas semelhantes
Apresentar sugestões de perguntas para os usuários começarem
Para adicionar uma consulta verificada:
Selecione + ao lado de Verified Queries.
Insira Question em uma linguagem natural (por exemplo, “Quais são os 10 principais produtos por receita?”).
Insira a SQL Query correspondente que responde corretamente à pergunta.
(Opcional) Marque Use as onboarding question para mostrar isso como uma sugestão aos usuários.
Selecione Add.
Dica
Adicione consultas verificadas para:
Perguntas comerciais comuns dos usuários
Consultas complexas que exigem lógica específica
Casos extremos ou cálculos incomuns
Perguntas que demonstram as capacidades da exibição
Sinônimos¶
Nota
Adicione sinônimos manualmente em vez de gerá-los automaticamente com AI. Concentre-se em alternativas específicas de domínio, como terminologia interna, abreviações ou nomes legados. Os sinônimos gerados automaticamente geralmente reduzem a qualidade da exibição semântica.
Os sinônimos ajudam os usuários a descobrir e consultar seus dados usando uma terminologia alternativa. Por exemplo, os usuários podem chamar «consumidores» de «clientes» ou «contas».
Para adicionar sinônimos a uma tabela ou campo:
Navegue até a tabela, dimensão, fato ou métrica aos quais você quer adicionar sinônimos.
Selecione Edit para abrir as propriedades do item.
No campo Synonyms, insira termos alternativos separados por vírgulas.
Selecione Save.
Exemplos de sinônimos:
Para uma dimensão “customer_name”: “nome do cliente, nome da conta, nome do comprador”
Para uma métrica de “revenue”: “vendas, receita, ganhos”
Para uma tabela de “orders”: “pedidos de vendas, compras”
Instruções personalizadas¶
As instruções personalizadas fornecem orientações específicas para o Cortex Analyst gerar SQL e categorizar perguntas. Use as instruções personalizadas para:
Definir regras comerciais e restrições
Especificar comportamentos padrão
Lidar com perguntas ambíguas
Rejeitar certos tipos de perguntas
Para adicionar uma instrução personalizada:
No editor, selecione a seção Custom Instructions.
Insira as instruções em linguagem natural. Exemplos:
«Sempre filtre por clientes ativos (status = “ACTIVE’), a menos que especificado de outra forma”
«Arredonde todos os valores numéricos para 2 casas decimais»
“Quando perguntado sobre receita, use a métrica net_revenue, a menos que seja explicitamente solicitada a receita bruta”
«Se uma pergunta for feita sobre usuários sem especificar uma região, peça ao usuário para esclarecer qual região»
Selecione Save.
Para mais informações sobre instruções personalizadas em exibições semânticas, consulte Fornecendo instruções personalizadas para o Cortex Analyst.
Carregando um arquivo YAML¶
Se você tiver uma especificação YAML de exibição semântica ou um arquivo YAML de modelo semântico legado, você pode carregar para criar uma nova exibição semântica ou atualizar uma que já existe.
Para carregar um arquivo YAML:
No menu de navegação, selecione AI & ML » Cortex Analyst.
Selecione Create new » Upload YAML file.
Navegue e selecione o arquivo YAML.
Revise a estrutura de exibição semântica gerada no editor.
Selecione Convert and save para criar a exibição semântica como um objeto de nível de esquema.
O editor converte a especificação YAML em uma exibição semântica nativa do Snowflake, que você pode editar usando a interface visual.
Para mais informações sobre o formato de especificação YAML, consulte Especificação YAML para exibições semânticas.
Para informações sobre como converter uma especificação em uma exibição semântica programaticamente, consulte Criação de exibição semântica de uma especificação YAML.