Monitoramento do administrador Cortex Analyst

Para melhorar a qualidade das respostas fornecidas pelo Cortex Analyst, você deve continuar refinando o modelo ou a exibição semântica. Para ajudá-lo a refinar o modelo ou a exibição, o Cortex Analyst registra as solicitações em uma tabela de eventos no banco de dados Snowflake.

Os registros incluem o seguinte:

  • O usuário que fez a pergunta

  • A pergunta feita

  • SQL gerado

  • Erros e/ou avisos

  • Corpos de solicitação e resposta

  • Outros metadados

Há um pequeno atraso, na ordem de 1 a 2 minutos, entre o momento da solicitação até ela aparecer na exibição.

Acesso aos logs

É possível visualizar esses logs na guia Monitoring do modelo semântico no Snowsight. Para visualizar os logs, os usuários devem ter o privilégio SELECT nas tabelas referenciadas, além de:

  • OWNERSHIP na exibição semântica (ao usar exibições semânticas)

  • Privilégio WRITE na área de preparação (para modelos semânticos armazenados em um arquivo na área de preparação)

Como alternativa, é possível consultar os logs diretamente do banco de dados Snowflake usando SQL, dependendo de seus privilégios.

Consulta de logs com SQL

Chame a função de tabela SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS para recuperar os registros de uma exibição ou um modelo semântico específico. Essa função de tabela realiza verificações de controle de acesso para garantir que o chamador tenha os privilégios necessários para acessar os dados da solicitação.

A seguir, um exemplo de como chamar a função:

SELECT * FROM TABLE(
  SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
    '<semantic_model_or_view_type>',
    '<semantic_model_or_view_name>'
  )
);
Copy

Ao chamar essa função, passe os seguintes argumentos:

  • semantic_model_or_view_type: especifica o tipo de modelo semântico ou exibição usado nas solicitações:

    • Para um modelo semântico definido em um arquivo em um estágio, especifique 'FILE_ON_STAGE'.

    • Para uma exibição semântica, especifique 'SEMANTIC_VIEW'.

  • semantic_model_or_view_name: especifica o local onde o modelo semântico ou a exibição é definida:

    • Para um modelo semântico definido em um arquivo em um estágio, especifique o caminho totalmente qualificado para o arquivo de especificação do modelo semântico (por exemplo, @my_db.my_schema.my_stage/path/to/file.yaml).

    • Para uma exibição semântica, especifique o nome totalmente qualificado da exibição semântica.

Retorna: uma tabela com todas as solicitações de API para o modelo semântico ou a exibição especificada.

Se uma consulta foi feita usando YAML em linha (em vez de exibição semântica ou arquivo na área de preparação), a solicitação pode ser acessada por meio da função de tabela, mas fica visível na exibição e na tabela de eventos detalhadas abaixo.

Se você usa uma função que recebeu a função de aplicativo SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN, pode consultar a exibição SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V. Essa exibição inclui todas as solicitações para Cortex Analyst em todos os modelos e as exibições semânticos.

Você também pode consultar os dados de evento brutos na tabela de eventos SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_RAW. As respostas estão no formato de telemetria aberta. Observe que a exibição SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V contém os mesmos dados em um formato mais legível.

Linguagem: Português