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.

Nota

Usar comandos SHOW sem uma cláusula IN em um contexto de banco de dados pode resultar em menos resultados do que o esperado.

Os objetos com o mesmo nome são exibidos apenas uma vez se não for usada a cláusula IN. Por exemplo, se a tabela t1 estiver em schema1 e a tabela t1 estiver em schema2 e ambas estiverem no escopo do contexto do banco de dados especificado (ou seja, o banco de dados selecionado é o pai de schema1 e schema2), então SHOW TABLES exibirá apenas uma das tabelas t1.

SCHEMA, . SCHEMA 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.

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

Notas de uso¶

O comando não precisa de um warehouse em funcionamento para ser executado.
O comando retorna apenas objetos para os quais a função atual do usuário atual recebeu pelo menos um privilégio de acesso.
O privilégio de acesso MANAGE GRANTS permite implicitamente que seu titular consulte todos os objetos da conta. Por padrão, somente o administrador de conta (usuários com a função ACCOUNTADMIN) e o administrador de segurança (usuários com a função SECURITYADMIN) têm o privilégio MANAGE GRANTS.

Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada. Você também pode usar o operador de canal para consultar a saída desse comando.