Monitoramento do administrador Cortex Analyst

Para melhorar a qualidade das respostas fornecidas pelo Cortex Analyst, é necessário continuar refinando o modelo semântico. Para ajudá-lo a refinar o modelo, o Cortex Analyst registra as solicitações em uma tabela de evento no banco de dados Snowflake. No momento, esse recurso só está disponível para modelos semânticos armazenados em um estágio (passado pelo parâmetro do corpo da solicitação semantic_model_file).

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

Use a UDTF snowflake.local.cortex_analyst_requests para recuperar os logs de um modelo semântico específico. Esta função realiza verificações de controle de acesso para garantir que o usuário chamador tenha os privilégios necessários.

A seguir, um exemplo de como usar a UDTF:

SELECT * FROM table(SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
  semantic_model_type = 'FILE_ON_STAGE',
  semantic_model_name = '@my_db.my_schema.my_stage/path/to/file.yaml'
));
Copy

Parâmetros:

  • semantic_model_type: atualmente, somente é possível usar FILE_ON_STAGE.

  • semantic_model_name: o URL de arquivo de estágio totalmente qualificado. Por exemplo, @my_db.my_schema.my_stage/path/to/file.yaml.

Retorna: uma tabela com todas as solicitações de API para o modelo semântico especificado.

Se você tiver a função de aplicativo snowflake.cortex_analyst_requests_admin, poderá consultar a exibição snowflake.local.cortex_analyst_requests_v. Esta exibição inclui todas as solicitações para Cortex Analyst em todos os modelos semânticos.

Se você tiver a função de aplicativo snowflake.cortex_analyst_requests_admin, também poderá consultar eventos brutos da tabela de evento snowflake.local.cortex_analyst_requests_raw. As respostas estão no formato de telemetria aberta. A exibição snowflake.local.cortex_analyst_requests_v tem os mesmos dados que a tabela de evento snowflake.local.cortex_analyst_requests_raw, mas em um formato mais legível.

Linguagem: Português