Uso da Snowsight para criar e gerenciar exibições semânticas¶

Na Snowsight, você pode criar e gerenciar exibições semânticas:

Criação de uma exibição semântica
- Using the AI-assisted generator to create a semantic view
- Carregamento da especificação YAML para criar uma exibição semântica
Editar uma exibição semântica
Concessão de privilégio a outra função para usar uma exibição semântica

Criação de uma exibição semântica¶

Na Snowsight, você pode criar uma exibição semântica usando um assistente ou carregando uma especificação do modelo semântico.

Carregamento da especificação YAML para criar uma exibição semântica

Nota

To create a semantic view, you must use a role with the following privileges:

CREATE SEMANTIC VIEW on the schema where you are creating the semantic view.
USAGE on the database and schema where you are creating the semantic view.
SELECT on the tables and views used in the semantic view.

Using the AI-assisted generator to create a semantic view¶

Use o gerador assistido por AI para criar uma exibição semântica que combina informações semânticas de várias fontes. Em vez de criar uma exibição semântica manualmente com sua própria especificação YAML, use o gerador de modelos no Snowsight para economizar tempo. O processo de criação da exibição semântica requer as seguintes informações:

Uma descrição com informações básicas sobre a exibição
Contexto, como consultas SQL de exemplo
A fonte de dados (pelo menos uma tabela ou exibição) que você está usando
As colunas que você está usando

O gerador assistido por AI processa as entradas das seguintes maneiras:

Consultas SQL de exemplo
- Validar a lista de consultas e descartar as consultas inválidas.
- Extrair todas as tabelas e colunas das consultas e apresentá-las para revisão antes de adicioná-las à exibição semântica.
- Extrair relacionamentos das consultas.
- Adicionar consultas válidas à exibição semântica como consultas verificadas.
Metadados da tabela
- Extrair todas as descrições de tabelas e colunas.
- Adicionar chaves primárias e exclusivas à exibição semântica analisando os metadados ou contando os valores distintos para determinar os tipos de cardinalidade e relacionamento.
Histórico de consultas
- Mostrar as consultas SQL históricas como sugestões para a exibição semântica. O gerador assistido por AI identifica os tipos mais comuns de consultas que se adaptam aos limites das tabelas e colunas selecionadas.
- Encontrar relacionamentos e tipos de coluna válidos para a exibição semântica.
- O Cortex Analyst usa o histórico de consultas acessível pela função usada para criar o modelo semântico para gerar relacionamentos e sugestões de consultas verificadas.

Faça login no Snowsight.
No menu de navegação, selecione AI & ML » Cortex Analyst.
At the top of the navigation menu, select Create new » Create new Semantic View.
Selecione um local para armazenar a exibição semântica após a criação.
Enter a name for the semantic view.
Em Description, especifique as informações sobre a exibição semântica.
Selecione Next.
Para fornecer contexto, adicione as seguintes informações:
- Em SQL Queries, insira perguntas de exemplo e as respectivas consultas SQL que você deseja usar como parte da exibição.
For Select tables, provide the data source that you’re using to create the semantic view.

É necessário fornecer pelo menos uma tabela ou exibição. Não há limite para as tabelas ou exibições que podem ser especificadas, mas a Snowflake não recomenda usar mais de 10.
Selecione Next.
Em Select columns, selecione as colunas que você está usando para criar a exibição semântica.

É possível selecionar todas as colunas ou colunas específicas. Por motivos de desempenho, a Snowflake não recomenda usar mais de 50 colunas.
Selecione se deseja adicionar valores de amostra de cada coluna à exibição semântica. Os valores de amostra ajudam a melhorar a precisão dos resultados do Cortex Analyst.
Selecione se deseja adicionar descrições geradas por AI das tabelas e colunas à exibição semântica. As descrições geradas por AI são baseadas nos nomes das colunas e nos valores de amostra.
Selecione Create and save. Você pode visualizar o progresso da geração da exibição, incluindo os detalhes sobre as etapas que o gerador da exibição está seguindo, na página da exibição semântica. O processo pode levar alguns minutos.
Opcional: para fazer outras modificações, edite a exibição usando o Snowsight ou diretamente no arquivo YAML.

O Cortex Analyst gera automaticamente sugestões para melhorar a exibição semântica após a criação. Depois que as sugestões aparecerem, o que pode levar vários minutos, você poderá revisá-las e aplicá-las à exibição conforme necessário.

Carregamento da especificação YAML para criar uma exibição semântica¶

Se você pretende criar a exibição semântica de Cortex Analyst, crie uma área de preparação para o arquivo YAML.
Carregue o arquivo YAML de uma das seguintes maneiras:
- Explorador de objetos de banco de dados
  1. Faça login no Snowsight.
  2. No menu de navegação, selecione Catalog » Database Explorer.
  3. Selecione o banco de dados e o esquema nos quais você quer criar a exibição semântica.
  4. Selecione Create » Semantic View » Upload YAML file.
  5. Selecione o arquivo YAML a ser carregado.
  6. Em Select database, schema and stage, selecione o banco de dados, o esquema e a área de preparação em que deseja carregar o arquivo YAML.
  7. Se você quiser que o arquivo YAML seja carregado em um caminho específico na área de preparação, especifique esse caminho.
  8. Selecione Upload.
- Cortex Analyst:
  1. Faça login no Snowsight.
  2. No menu de navegação, selecione AI & ML » Cortex Analyst.
  3. Selecione Create new » Upload YAML file.
  4. Selecione o arquivo YAML a ser carregado.
  5. Selecione Convert and save.

Editar uma exibição semântica¶

Nota

Editar uma exibição semântica no Snowsight substitui efetivamente a exibição existente. Para substituir uma exibição semântica existente, você deve usar uma função que tenha recebido os seguintes privilégios:

CREATE SEMANTIC VIEW on the schema where you are creating the semantic view.
USAGE on the database and schema where you are creating the semantic view.
SELECT on the tables and views used in the semantic view.

Para editar uma exibição semântica:

Acesse a exibição semântica de uma das seguintes maneiras:
- Explorador de objetos de banco de dados
  1. Faça login no Snowsight.
  2. No menu de navegação, selecione Catalog » Database Explorer.
  3. Selecione o banco de dados e o esquema que contêm a exibição semântica.
  4. Selecione Semantic views.
  5. Selecione a exibição semântica.
  6. Selecione a guia Semantic information.
- Cortex Analyst:
  1. Faça login no Snowsight.
  2. No menu de navegação, selecione AI & ML » Cortex Analyst.
  3. Selecione a guia Semantic views.
  4. Em Select database to see semantic views, selecione o banco de dados e o esquema que contêm a exibição semântica que você quer editar.
  5. Selecione a exibição semântica que você quer editar.
Faça alterações na exibição semântica. Você pode fazer os seguintes tipos de alterações:
- Para modificar o nome ou a descrição da exibição semântica:
  1. Selecione Edit ao lado do nome da exibição semântica.
  2. Faça alterações no nome ou na descrição.
  3. Selecione Apply.
- Para adicionar uma nova tabela lógica à exibição semântica:
  1. Selecione + Logical Table no explorador de objetos de banco de dados ou + em Cortex Analyst.
  2. Na etapa Select a table do assistente:
    1. Selecione a tabela ou exibição que contém os dados que você quer utilizar na exibição semântica.
    2. Selecione Next.
  3. Na etapa Select columns do assistente:
    1. Selecione as colunas a serem incluídas na exibição.
      
      Para selecionar todas as colunas em uma tabela ou exibição, selecione a tabela ou exibição.
    2. Selecione Generate logical table.
- Para fazer alterações no nome, na descrição, nos sinônimos ou na chave primária de uma tabela lógica na exibição semântica:
  1. Selecione » Edit Logical Table ao lado do nome da tabela lógica no explorador de objetos de banco de dados ou Edit ao lado do nome da tabela lógica em Cortex Analyst.
  2. Faça as alterações no nome, na descrição, nos sinônimos e na chave primária.
    
    Se você não especificou a descrição ou os sinônimos, pode selecionar Generate fields para preencher esses campos automaticamente.
  3. Selecione Save.
- Para adicionar fato, dimensão ou métrica:
  1. Abra o formulário de adição de novo item:
    - No explorador de objetos de banco de dados, selecione e Fact, Dimension ou Metric.
    - Em Cortex Analyst, selecione + ao lado de Facts, Dimensions ou Metrics.
  2. Insira informações sobre o novo fato, dimensão ou métrica e selecione Add.
- Para modificar ou remover um fato, uma dimensão ou uma métrica:
  1. Selecione Facts, Dimensions ou Metrics para exibir a lista de fatos, dimensões ou métricas.
  2. Para o fato, a dimensão ou a métrica que você quer alterar:
    - Selecione Edit para modificar o item.
    - Selecione » Remove fact, Remove dimension ou Remove metric para remover o item.
- Para adicionar um relacionamento:
  1. Abra o formulário de adição de novo item:
    - No explorador de objetos de banco de dados, selecione + Relationship:
    - Em Cortex Analyst, selecione + ao lado de Relationships.
  2. Insira um nome para o relacionamento, selecione as tabelas nele e escolha as colunas que serão usadas para unir as tabelas.
  3. Selecione Add.
Se você planeja usar o Cortex Analyst com essa exibição, considere o seguinte:
- Adicione consultas de amostra à seção Verified Queries. Observe que essa seção está disponível apenas no Cortex Analyst.
  - 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.

Concessão de privilégio a outra função para usar uma exibição semântica¶

Para conceder a outra função os privilégios para visualizar e consultar uma exibição semântica:

Acesse a exibição semântica de uma das seguintes maneiras:
- Explorador de objetos de banco de dados
  1. Faça login no Snowsight.
  2. No menu de navegação, selecione Catalog » Database Explorer.
  3. Selecione o banco de dados e o esquema que contêm a exibição semântica.
  4. Selecione Semantic views.
  5. Selecione a exibição semântica.
  6. Selecione » Share.
- Cortex Analyst:
  1. Faça login no Snowsight.
  2. No menu de navegação, selecione AI & ML » Cortex Analyst.
  3. Selecione a guia Semantic views.
  4. Selecione a exibição semântica.
  5. Selecione Share.
Selecione a função à qual os privilégios devem ser concedidos para visualizar e consultar a exibição semântica.
Selecione Done.

Dessa forma, os privilégios SELECT e REFERENCES são concedidos à função selecionada na exibição semântica.

Consulta de exibição semântica¶

Se você está visualizando uma exibição semântica no explorador de objetos de banco de dados, pode abrir uma planilha para construir uma consulta para essa exibição selecionando » Query with SQL.

Para obter informações sobre como construir a consulta, consulte Consulta de exibições semânticas.

Melhores práticas para criar uma exibição semântica¶

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 a exibição semântica não constar na lista de exibições, atualize a lista de modelos (não a própria página).
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.