SHOW MODEL MONITORS

Lista todos os monitoramentos de modelo que podem ser acessados no esquema atual ou especificado e exibe informações sobre cada um deles.

Consulte também:

CREATE MODEL MONITOR, ALTER MODEL MONITOR, DESCRIBE MODEL MONITOR, DROP MODEL MONITOR

Sintaxe

SHOW MODEL MONITORS
[ LIKE <pattern> ]
[ IN
    {
      ACCOUNT                  |

      DATABASE                 |
      DATABASE <database_name> |

      SCHEMA                   |
      SCHEMA <schema_name>     |
      <schema_name>
    }
 ]
Copy

Parâmetros

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

[ IN ... ]

Opcionalmente, especifica o escopo do comando. Especifique um dos seguintes:

ACCOUNT

Retorna registros para toda a conta.

DATABASE, . DATABASE db_name

Retorna registros do banco de dados atual em uso ou de um banco de dados especificado (db_name).

Se você especificar DATABASE sem db_name e nenhum banco de dados estiver em uso, a palavra-chave não terá efeito sobre a saída.

SCHEMA, . SCHEMA schema_name, . schema_name

Retorna registros do esquema atual em uso ou de um esquema especificado (schema_name).

SCHEMA é opcional se um banco de dados estiver em uso ou se você especificar o schema_name totalmente qualificado (por exemplo, db.schema).

Se nenhum banco de dados estiver em uso, a especificação SCHEMA não terá efeito sobre a saída.

Padrão: depende se a sessão tem ou não um banco de dados em uso no momento:

  • Banco de dados: DATABASE é o padrão (ou seja, o comando retorna os objetos nos quais você tem privilégios para visualizar no banco de dados).

  • Sem banco de dados: ACCOUNT é o padrão (ou seja, o comando retorna os objetos que você tem privilégios de visualização em sua conta).

Saída

A saída do comando fornece propriedades e metadados do monitoramento de modelo nas seguintes colunas:

Coluna

Descrição

created_on

Data e hora em que o monitoramento de modelo foi criado.

name

Nome do modelo do monitoramento.

database_name

Banco de dados no qual o monitoramento de modelo está armazenado.

schema_name

Esquema no qual o monitoramento de modelo é armazenado.

warehouse_name

Warehouse usado para monitorar o modelo.

refresh_interval

O intervalo de atualização (atraso de destino) para acionar a atualização do monitoramento de modelo.

aggregation_window

A janela de agregação para o cálculo de métricas.

model_task

A tarefa do modelo que está sendo monitorado, seja TABULAR_BINARY_CLASSIFICATION ou TABULAR_REGRESSION.

monitor_state

O estado do monitoramento de modelo:

  • ACTIVE: o monitoramento de modelo está ativo e funcionando corretamente.

  • SUSPENDED: o monitoramento de modelo é pausado.

  • PARTIALLY_SUSPENDED: uma condição de erro na qual uma das tabelas subjacentes parou de ser atualizada no intervalo esperado. Consulte DESCRIBE para obter mais detalhes.

  • UNKNOWN: uma condição de erro na qual o estado das tabelas subjacentes não pode ser identificado.

source

Representação em cadeia de caracteres de um objeto JSON que detalha a tabela ou exibição de origem na qual as agregações se baseiam. Se a tabela não existir ou não estiver acessível, o valor será uma cadeia de caracteres vazia. Consulte Especificação de objeto JSON da tabela.

baseline

Representação em cadeia de caracteres de um objeto JSON que detalha a tabela de linha de base sendo usada para monitoramento, da qual um clone está incorporado no objeto de monitoramento de modelo. Consulte Especificação de objeto JSON da tabela.

model

Representação em cadeia de caracteres de um objeto JSON que contém informações específicas sobre o modelo que está sendo monitorado. Consulte Especificação de objeto JSON do modelo.

comment

Comentário sobre o monitoramento de modelo.

Especificação de objeto JSON da tabela

A seguir, um exemplo da representação JSON de uma tabela, exibição ou outro objeto semelhante a uma tabela, conforme usado pelas colunas source e baseline na saída do comando:

name

Nome da tabela ou exibição de origem ou de linha de base.

database_name

Banco de dados no qual a tabela ou exibição está armazenada.

schema_name

Esquema no qual a tabela ou exibição está armazenada.

status

O status da tabela:

  • ACTIVE: a tabela ou exibição pode ser acessada pelo usuário.

  • MASKED: o usuário atual não tem acesso à tabela ou exibição. Os valores de outros campos aparecem mascarados (ou seja, como uma série de asteriscos).

  • DELETED: a tabela ou exibição foi excluída.

  • NOT_SET: a propriedade não foi definida. Aplicável somente para dados de linha de base.

Especificação de objeto JSON do modelo

A seguir, um exemplo da representação JSON de um modelo, conforme usado pela coluna model na saída do comando:

Campo

Descrição

model_name

Nome do modelo sendo monitorado.

version_name

Nome da versão do modelo sendo monitorado.

function_name

Nome da função específica sendo monitorada na versão do modelo especificado.

database_name

Banco de dados no qual o modelo é armazenado.

schema_name

Esquema no qual o modelo é armazenado.

model_status

O status do modelo. Pode ser ACTIVE, MASKED ou DELETED. MASKED indica que o usuário não tem acesso ao modelo; outros campos são exibidos como uma série de asteriscos.

version_status

O status da versão do modelo. Pode ser ACTIVE ou DELETED. (MASKED não é um status válido para uma versão de modelo, porque eles não têm controle de acesso.)

Requisitos de controle de acesso

Privilégio

Destino

Qualquer

Monitoramento de modelo