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.

Atualmente, esse recurso só está disponível para modelos semânticos armazenados em um estágio (especificado no corpo da solicitação pelo campo semantic_model_file) e exibições semânticas (especificadas no campo semantic_view).

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

Acesso aos logs

É possível visualizar esses logs na guia Monitoring do modelo semântico no Snowsight. Os usuários devem ter o privilégio WRITE no estágio e o privilégio SELECT nas tabelas referenciadas para visualizar os logs.

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 você estiver usando uma função que tenha recebido a função de aplicativo SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN, poderá consultar a exibição SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V. Essa exibição inclui todas as solicitações para o Cortex Analyst em todos os modelos e exibições semânticas.

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.