DESCRIBE MODEL MONITOR¶

Exibe informações sobre um monitoramento de modelo específico. Esse comando exibe todas as informações mostradas pelo comando SHOW MODEL MONITORS, além de informações adicionais.

DESCRIBE pode ser abreviado como DESC.

Consulte também:: CREATE MODEL MONITOR, ALTER MODEL MONITOR, SHOW MODEL MONITORS, DROP MODEL MONITOR

Sintaxe¶

{ DESCRIBE | DESC } MODEL MONITOR <monitor_name>

Copy

Parâmetros¶

monitor_name

Especifica o identificador do monitoramento de modelo a ser descrito.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

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.
As colunas a seguir são as colunas adicionais exibidas por DESCRIBE em comparação com SHOW
`aggregation_status`	Uma representação em cadeia de caracteres de um objeto JSON com o status de agregação de cada tipo de tabela dinâmica aninhada. A chave pode ser SOURCE_AGGREGATED ou ACCURACY_AGGREGATED. O valor pode ser ACTIVE ou SUSPENDED.
`aggregation_last_error`	Uma representação em cadeia de caracteres de um objeto JSON com o último erro de cada tipo de tabela dinâmica aninhada. A chave pode ser SOURCE_AGGREGATED ou ACCURACY_AGGREGATED. O valor é uma mensagem de erro ou cadeia de caracteres vazia se a última execução tiver sido concluída com êxito.
`aggregation_last_data_timestamp`	Uma representação de cadeia de caracteres de um objeto JSON com a última vez que o tipo de tabela dinâmica aninhada foi atualizado. A chave pode ser SOURCE_AGGREGATED ou ACCURACY_AGGREGATED. O valor é um carimbo de data/hora.
`columns`	Uma representação de cadeia de caracteres de um objeto JSON com nomes de colunas que estão sendo usadas na tabela de origem. Consulte Especificação de objeto JSON da coluna.

Especificação de objeto JSON da tabela¶

A seguir, o formato da representação JSON de 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: o status não foi definido.

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: o status não foi definido.

Especificação de objeto JSON do modelo¶

A seguir, o formato 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.)

Especificação de objeto JSON da coluna¶

A seguir, o formato da representação das colunas JSON, conforme usado pela coluna columns na saída do comando:

Campo	Descrição
`timestamp_column`	Nome da coluna de carimbo de data/hora na fonte de dados.
`id_columns`	Uma matriz de nomes de colunas de cadeia de caracteres que, juntos, identificam exclusivamente cada linha nos dados de origem.
`prediction_class_columns`	Uma matriz de cadeias de caracteres que nomeia todas as colunas da classe de previsão na fonte de dados.
`prediction_score_columns`	Uma matriz de cadeias de caracteres que nomeia todas as colunas de pontuação de previsão na fonte de dados.
`actual_class_columns`	Uma matriz de cadeias de caracteres que nomeia todas as colunas de classe reais na fonte de dados.
`numerical_columns`	Uma matriz de cadeias de caracteres que nomeia todas as colunas de recursos numéricos que o monitoramento de modelo usa da tabela de origem.
`string_columns`	Uma matriz de cadeias de caracteres que nomeia todas as colunas de recursos de cadeia de caracteres (categóricas) que o monitoramento de modelo usa da tabela de origem.
`boolean_columns`	Uma matriz de cadeias de caracteres nomeando todas as colunas de recursos boolianos (categóricos) que o monitoramento de modelo usa da tabela de origem.

Requisitos de controle de acesso¶

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio	Objeto	Notas
Qualquer	Monitoramento de modelo

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.