Editor de exibição semântica¶
O editor de exibição semântica permite ajustar sua exibição semântica ou criar uma do zero. Você pode usar esta interface para editar exibições criadas pelo Autopilot ou carregar e editar especificações YAML existentes.
Acessando o editor¶
Você pode acessar o editor usando um catálogo ou o Cortex Analyst.
Para acessar o editor por meio de um catálogo, siga estas etapas:
Faça login no Snowsight.
Selecione catalog.
Selecione o banco de dados e o esquema.
Selecione Semantic views e a sua exibição.
Selecione a guia Semantic information.
Siga as etapas abaixo para acessar o editor pelo Cortex Analyst:
Faça login no Snowsight.
No menu de navegação, selecione AI & ML » Cortex Analyst.
Selecione a guia Semantic views.
Abra a exibição.
Editando metadados¶
Depois de acessar o editor, você poderá editar os metadados da exibição semântica.
Para editar o nome ou a descrição:
Selecione Edit ao lado do nome da exibição semântica.
Atualize os campos Name ou Description.
Selecione Save.
Dica
Inclua descrições detalhadas sobre o tipo de análise para o qual essa exibição é útil.
Gerenciando tabelas lógicas¶
Uma tabela lógica é uma exibição de uma tabela do banco de dados física.
Para adicionar uma tabela:
Selecione + Logical Table.
Selecione a tabela ou exibição física.
Selecione Next.
Selecione as colunas a serem incluídas.
Selecione Generate logical table.
Para editar uma tabela:
Selecione Edit (ou More options » Edit Logical Table) ao lado do nome da tabela.
Modifique os campos Name, Description, Synonyms ou Primary Key.
Selecione Save.
Dica
Use o botão Generate fields para preencher automaticamente as descrições ou os sinônimos usando AI.
Gerenciando conteúdo (fatos, dimensões, métricas)¶
Para adicionar um item:
Selecione + ao lado de Facts, Dimensions ou Metrics.
Insira os detalhes:
Name
Expression
Data Type
Selecione Add.
Para editar ou remover um item:
Selecione um item existente para editá-lo ou selecione More options para removê-lo.
Tipos de conteúdo:
Dimensões: dados categóricos, como região do produto.
Fatos: dados quantitativos, como receita líquida.
Métricas: agregações, como SUM(receita).
Nota
Métricas derivadas (que combinam outras métricas) e modificadores de acesso privado são recursos específicos compatíveis com exibições semânticas.
Gerenciando relacionamentos¶
Os relacionamentos definem como as tabelas são unidas.
Para adicionar um relacionamento:
Selecione + ao lado de «Relationships».
Insira um Name para o relacionamento.
Selecione Left Table e Right Table.
Especifique Join Columns para cada tabela.
(Opcional) Especifique um tipo de junção, se necessário, para compatibilidade legada.
Selecione Add.
O relacionamento aparece na lista de relacionamentos e permite junções entre as tabelas especificadas.
Nota
Normalmente, você não precisa especificar o tipo de junção para uma exibição semântica. O Cortex Analyst determina isso no momento da consulta, embora você possa especificá-lo para YAMLs legados, se necessário.
Recursos avançados¶
Para melhorar a precisão do Cortex Analyst, você pode adicionar o seguinte como contexto:
Consultas verificadas¶
Consultas verificadas ensinam o modelo como responder a perguntas complexas.
Selecione + ao lado de Verified Queries.
Insira uma Question de linguagem natural.
Insira a SQL Query correspondente.
Selecione Add.
A consulta verificada é salva e será usada para orientar o Cortex Analyst ao responder a perguntas semelhantes.
Sinônimos¶
Sinônimos ajudam os usuários a encontrar dados usando terminologia alternativa, como «cliente» para «consumidor».
Navegue até a tabela ou coluna à qual deseja adicionar sinônimos.
Selecione Edit.
No campo Synonyms, insira termos alternativos separados por vírgulas.
Selecione Save.
Instruções personalizadas¶
As instruções personalizadas fornecem regras comerciais específicas para orientar a geração de consultas.
Selecione a seção Custom Instructions.
Insira regras comerciais específicas, como «Sempre filtrar por usuários ativos, a menos que especificado de outra forma».
Selecione Save.
As instruções personalizadas serão aplicadas quando o Cortex Analyst gerar consultas usando esta exibição semântica.
Carregando um arquivo YAML¶
Se você já tem um YAML de modelo semântico:
No menu de navegação, selecione AI & ML » Cortex Analyst.
Selecione Create new » Upload YAML file.
Selecione seu arquivo.
Selecione Convert and save para criar uma exibição semântica nativa com base nele.