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.

Se você omitir IN ..., o escopo do comando dependerá se a sessão tem um banco de dados em uso:

If a database is currently in use, the command returns the objects you have privileges to view in the database. This has the same effect as specifying IN DATABASE.
If no database is currently in use, the command returns the objects you have privileges to view in your account. This has the same effect as specifying IN ACCOUNT.

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 o operador de canal (->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.

For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.