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

Para criar uma exibição semântica, você deve usar uma função com os privilégios descritos em Privilégios necessários para criar uma exibição semântica.

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

Use the AI-assisted generator to create a semantic view that combines semantic information from multiple sources. Instead of creating a semantic view manually with your own YAML specification, you can use the model generator within Snowsight to save time. The process of creating a semantic view requires the following information:

A description with basic information about the view
Context, such as example SQL queries
The data source (at least one table or view) that you’re using
The columns that you’re using

The AI-assisted generator handles inputs in the following ways:

Example SQL queries
- Validate the list of queries and throw out invalid queries.
- Extract all tables and columns from the queries and present them for review before adding to the semantic view.
- Extract relationships from the queries.
- Add valid queries to the semantic view as verified queries.
Table metadata
- Extract all table and column descriptions.
- Add primary and unique keys to the semantic view by analyzing metadata or counting distinct values to determine cardinality and relationship types.
Query history
- Surface historical SQL queries as suggestions to the semantic view. The AI-assisted generator identifies the most common types of queries that fit within the bounds of the selected tables and columns.
- Find valid relationships and column types for the semantic view.
- Cortex Analyst uses the query history accessible by the role used to create the semantic model to generate both relationships and verified query suggestions.

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.
Select a location to store the semantic view after creation.
Enter a name for the semantic view.
For Description, specify information about the semantic view.
Selecione Next.
To provide context, add the following information:
- For SQL Queries, provide example questions and their respective SQL queries that you want to use as part of the view.
For Select tables, provide the data source that you’re using to create the semantic view.

You must provide at least one table or view. There’s no limit on the tables or views that you can specify, but Snowflake recommends not using more than 10.
Selecione Next.
For Select columns, select the columns that you’re using to create the semantic view.

You can select all the columns or specific columns. For performance reasons, Snowflake recommends not using more than 50 columns.
Select whether you want to add sample values from each column to the semantic view. Sample values help improve the accuracy of Cortex Analyst’s results.
Select whether you want to add AI-generated descriptions for tables and columns to the semantic view. The AI-generated descriptions are based on the column names and sample values.
Select Create and save. You can view the progress of the view generation, including details about the steps that the view generator is taking, on the semantic view page. The process can take a few minutes.
Optional: To make additional modifications, edit the view either by using Snowsight or by editing the YAML file directly.

Cortex Analyst automatically generates suggestions to improve the semantic view after creation. After the suggestions appear, which might take several minutes, you can review them and apply them to the view as needed.

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¶

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 |ellipsis-explorer|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.