Usar o Cortex Analyst Semantic View Generator¶
O Cortex Analyst Semantic View Generator fornece uma interface gráfica de usuário (GUI) para criar e gerenciar exibições semânticas. Esse assistente orienta você no processo de definição da semântica do seu negócio, tornando-o acessível aos usuários que talvez não estejam familiarizados com o SQL.
Para obter mais informações sobre como usar o gerador e gerenciar modelos semânticos no YAML, consulte os tópicos a seguir:
Criação de uma exibição semântica¶
Para usar o Cortex Analyst Semantic View Generator para criar uma nova exibição semântica:
No Snowsight, selecione AI & ML.
Localize o bloco Cortex Analyst e selecione Try. A janela Select a semantic model é aberta.
Em Role and warehouse:
Selecione a função que deve ser a proprietária da exibição semântica.
Selecione o warehouse que deve ser usado para consultas dessa exibição semântica.
Em Select from, selecione Semantic Views.
No menu que exibe No Database selected, selecione o banco de dados e o esquema em que deseja criar a exibição semântica.
Selecione Create new. O assistente do Semantic View Generator é exibido.
Na etapa Description do assistente:
Em Location to store, selecione o banco de dados e o esquema em que o modelo deve ser armazenado, caso você ainda não tenha selecionado um local.
Em Name, digite um nome para seu modelo semântico.
Você deve especificar um nome que comece com uma letra ou sublinhado e que contenha apenas letras, números, sublinhados ou cifrões.
(Opcional) Em Description, descreva os dados que seu modelo semântico disponibiliza e descreva os tipos de perguntas que os usuários podem fazer.
Selecione Next: Select tables.
Na etapa Select tables do assistente:
Na guia Find tables and views, selecione as tabelas ou exibições que contêm os dados que você deseja usar em sua exibição semântica.
Você deve selecionar pelo menos uma tabela ou exibição.
Para melhorar o desempenho, não selecione mais de dez tabelas.
Se quiser ver a lista de tabelas e exibições que você selecionou, selecione a guia Selected.
Selecione Next: Select columns.
Na etapa Select columns do assistente:
Selecione as colunas a serem incluídas no modelo.
Para selecionar todas as colunas em uma tabela ou exibição, selecione a tabela ou exibição.
Para melhorar o desempenho, não selecione mais de 50 colunas.
Selecione Create and Save.
A janela Cortex Analyst é aberta, exibindo os detalhes sobre o modelo semântico que você criou.
Em Logical tables:
Revise os fatos, as dimensões e as métricas definidas para cada tabela ou exibição.
Forneça nomes e descrições adequados aos seus negócios.
Acrescente os fatos, dimensões e métricas adicionais necessários.
Em Relationships:
Confirme todas as relações definidas pelo gerador.
Modifique as propriedades da relação conforme necessário.
Acrescente as relações adicionais necessárias.
Se você tiver feito alguma alteração na exibição semântica, selecione Save no canto superior direito da janela Cortex Analyst.
Editar uma exibição semântica¶
Para editar uma exibição semântica:
No Snowsight, selecione AI & ML.
Localize o bloco Cortex Analyst e selecione Try. A janela Select a semantic model é aberta.
Em Role and warehouse:
Selecione a função proprietária da exibição semântica.
Selecione o warehouse usado para consultas da exibição semântica.
Em Select from, selecione Semantic Views.
No menu do banco de dados, selecione o banco de dados e o esquema que contêm a exibição semântica que você deseja editar.
Selecione a exibição semântica que deseja editar e selecione Open.
Faça as alterações na exibição semântica. Você pode:
Modificar descrições e informações básicas.
Adicionar ou remover fontes de dados.
Alterar as seleções de coluna.
Atualizar relações.
Adicionar, modificar ou remover fatos, dimensões e métricas.
Se você planeja usar o Cortex Analyst com essa visualização, considere o seguinte:
Adicione consultas de amostra à seção Verified Queries.
Essas são consultas de exemplo que ajudam o Cortex Analyst a entender como usar a exibição semântica.
Adicione consultas que representem casos de uso comuns para seus dados.
Adicione sinônimos para suas tabelas, fatos, dimensões ou métricas.
Esses são termos alternativos que os usuários podem usar em consultas.
Os sinônimos ajudam o Cortex Analyst a interpretar corretamente as perguntas dos usuários.
Adicione instruções personalizadas.
Elas fornecem contexto adicional sobre como os dados devem ser interpretados.
Inclua regras ou restrições comerciais que devem ser consideradas.
Selecione Save no canto superior direito da janela Cortex Analyst.
Práticas recomendadas para usar o Cortex Analyst Semantic View Generator¶
Forneça descrições claras:
Use terminologia comercial em todos os nomes e descrições.
Forneça descrições detalhadas o suficiente para que os usuários não técnicos possam entender.
Inclua perguntas representativas de usuários:
Inclua perguntas que possam ajudar o gerador de modelos a entender melhor sua intenção.
Inclua variações de como as perguntas podem ser feitas.
Analise cuidadosamente as sugestões geradas:
Certifique-se de que as perguntas sejam relevantes para o caso de uso.
Certifique-se de que as relações sugeridas correspondam ao seu entendimento do negócio.
Teste com perguntas reais:
Depois de criar sua exibição semântica, teste-a com perguntas comerciais reais.
Refine sua exibição semântica, com base em quão bem o modelo aceita essas perguntas.
Itere o desenvolvimento da exibição semântica:
Comece com um esquema de estrela simples.
Comece com as principais tabelas e métricas e depois expanda. Sugerimos três tabelas para manter as coisas simples.
Obtenha feedback dos usuários corporativos e refine sua exibição semântica.
Solução de problemas¶
Se sua exibição semântica não estiver listada na lista de visualizações do Cortex Analyst Semantic View Generator, atualize a lista de modelos (não a página em si).
Se ocorrerem erros com as relações na exibição semântica, certifique-se de que essas relações correspondam à estrutura de dados real.
Se as consultas estiverem lentas, reduza o número de tabelas ou colunas.
Se o Cortex Analyst produzir resultados inesperados ao usar sua exibição semântica, revise os fatos, as dimensões e as métricas na exibição semântica.