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

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

Uso do assistente 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.

  1. Acesse o assistente para criar exibições semânticas de uma das seguintes maneiras:

    • Explorador de objetos de banco de dados

      1. Em Snowsight, selecione Data » Databases.

      2. Selecione o banco de dados e o esquema nos quais você quer criar a exibição semântica.

      3. Selecione Create » Semantic View » Create with guided setup.

    • Cortex Analyst:

      1. Em Snowsight, selecione AI & ML » Cortex Analyst.

      2. Selecione Create new » Create new Semantic View.

  2. Na etapa Getting started do assistente:

    1. Em Location to store, selecione o banco de dados e o esquema nos quais o modelo deve ser armazenado.

    2. Em Name, insira um nome para a exibição semântica.

      Você deve especificar um nome que comece com uma letra ou sublinhado e que contenha apenas letras, números, sublinhados ou cifrões.

    3. (Opcional) Em Description, descreva os dados que a exibição semântica disponibiliza.

    4. Selecione Next.

  3. Na etapa Select tables do assistente:

    1. Na guia All, selecione as tabelas ou exibições que contêm os dados que você quer usar na exibição semântica. Observe o seguinte:

      • 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.

    2. Selecione Next.

  4. 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.

      Para melhorar o desempenho, não selecione mais de 50 colunas.

    2. Selecione Create and Save.

  5. Em Logical tables:

    1. Revise os fatos, as dimensões e as métricas definidas para cada tabela ou exibição.

    2. Forneça nomes e descrições adequados aos seus negócios.

    3. Acrescente os fatos, dimensões e métricas adicionais necessários.

  6. Em Relationships:

    1. Confirme todas as relações definidas pelo gerador.

    2. Modifique as propriedades da relação conforme necessário.

    3. Acrescente as relações adicionais necessárias.

  7. Se você fez alguma alteração na exibição semântica, selecione Save.

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

  1. Se você pretende criar a exibição semântica de Cortex Analyst, crie uma área de preparação para o arquivo YAML.

  2. Carregue o arquivo YAML de uma das seguintes maneiras:

    • Explorador de objetos de banco de dados

      1. Em Snowsight, selecione Data » Databases.

      2. Selecione o banco de dados e o esquema nos quais você quer criar a exibição semântica.

      3. Selecione Create » Semantic View » Upload YAML file.

      4. Selecione o arquivo YAML a ser carregado.

      5. 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.

      6. Se você quiser que o arquivo YAML seja carregado em um caminho específico na área de preparação, especifique esse caminho.

      7. Selecione Upload.

    • Cortex Analyst:

      1. Em Snowsight, selecione AI & ML » Cortex Analyst.

      2. Selecione Create new » Upload YAML file.

      3. Selecione o arquivo YAML a ser carregado.

      4. Selecione Convert and save.

Editar uma exibição semântica

Para editar uma exibição semântica:

  1. Acesse a exibição semântica de uma das seguintes maneiras:

    • Explorador de objetos de banco de dados

      1. Em Snowsight, selecione Data » Databases.

      2. Selecione o banco de dados e o esquema que contêm a exibição semântica.

      3. Selecione Semantic views.

      4. Selecione a exibição semântica.

      5. Selecione a guia Semantic information.

    • Cortex Analyst:

      1. Em Snowsight, selecione AI & ML » Cortex Analyst.

      2. Selecione a guia Semantic views.

      3. 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.

      4. Selecione a exibição semântica que você quer editar.

  2. 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 Mais opções » 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 Mais opções » 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.

  3. 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.

  4. 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:

  1. Acesse a exibição semântica de uma das seguintes maneiras:

    • Explorador de objetos de banco de dados

      1. Em Snowsight, selecione Data » Databases.

      2. Selecione o banco de dados e o esquema que contêm a exibição semântica.

      3. Selecione Semantic views.

      4. Selecione a exibição semântica.

      5. Selecione Mais opções » Share.

    • Cortex Analyst:

      1. Em Snowsight, selecione AI & ML » Cortex Analyst.

      2. Selecione a guia Semantic views.

      3. Selecione a exibição semântica.

      4. Selecione Share.

  2. Selecione a função à qual os privilégios devem ser concedidos para visualizar e consultar a exibição semântica.

  3. 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 Mais opções » 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.