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>
}
]
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
semdb_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 tabelat1
estiver emschema1
e a tabelat1
estiver emschema2
e ambas estiverem no escopo do contexto do banco de dados especificado (ou seja, o banco de dados selecionado é o pai deschema1
eschema2
), então SHOW TABLES exibirá apenas uma das tabelast1
.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 oschema_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 |
---|---|
|
Data e hora em que o monitoramento de modelo foi criado. |
|
Nome do modelo do monitoramento. |
|
Banco de dados no qual o monitoramento de modelo está armazenado. |
|
Esquema no qual o monitoramento de modelo é armazenado. |
|
Warehouse usado para monitorar o modelo. |
|
O intervalo de atualização (atraso de destino) para acionar a atualização do monitoramento de modelo. |
|
A janela de agregação para o cálculo de métricas. |
|
A tarefa do modelo que está sendo monitorado, seja TABULAR_BINARY_CLASSIFICATION ou TABULAR_REGRESSION. |
|
O estado do monitoramento de modelo:
|
|
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. |
|
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. |
|
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. |
|
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:
|
Nome da tabela ou exibição de origem ou de linha de base. |
---|---|
|
Banco de dados no qual a tabela ou exibição está armazenada. |
|
Esquema no qual a tabela ou exibição está armazenada. |
|
O status da tabela:
|
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 |
---|---|
|
Nome do modelo sendo monitorado. |
|
Nome da versão do modelo sendo monitorado. |
|
Nome da função específica sendo monitorada na versão do modelo especificado. |
|
Banco de dados no qual o modelo é armazenado. |
|
Esquema no qual o modelo é armazenado. |
|
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. |
|
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.Os nomes das colunas de saída para este comando são gerados em minúsculas. Se você consumir um conjunto de resultados deste comando com o operador de canal ou a função RESULT_SCAN, use identificadores entre aspas duplas para os nomes das colunas na consulta para garantir que eles correspondam aos nomes das colunas na saída que foi verificada. Por exemplo, se o nome de uma coluna de saída for
type
, especifique"type"
para o identificador.