ALTER MODEL MONITOR

Modifica as propriedades de um monitoramento de modelo:

  • Suspende ou retoma o monitor.

  • Define a tabela de linha de base que o monitor usa.

  • Define o intervalo de atualização para operações de tabela dinâmica no monitor.

  • Define o warehouse que o monitor usa.

  • Adiciona ou remove colunas de segmento para monitorar segmentos de dados específicos.

Consulte também:

CREATE MODEL MONITOR, SHOW MODEL MONITORS, DESCRIBE MODEL MONITOR, DROP MODEL MONITOR

Sintaxe

ALTER MODEL MONITOR [ IF EXISTS ] <monitor_name> { SUSPEND | RESUME }

ALTER MODEL MONITOR [ IF EXISTS ] <monitor_name> SET
   [ BASELINE='<baseline_table_name>' ]
   [ REFRESH_INTERVAL='<refresh_interval>' ]
   [ WAREHOUSE=<warehouse_name> ]

ALTER MODEL MONITOR [ IF EXISTS ] <monitor_name> ADD segment_column = '<segment_column_name>'

ALTER MODEL MONITOR [ IF EXISTS ] <monitor_name> DROP segment_column = '<segment_column_name>'
Copy

Parâmetros

monitor_name

Especifica o identificador (ou seja, o nome) do monitoramento de modelo.

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.

SET ...

Especifica uma ou mais propriedades do monitoramento de modelo a serem definidas.

BASELINE='<baseline_table_name>'

Define a tabela de linha de base que o monitor usa.

WAREHOUSE = warehouse_name

Define o warehouse que o monitor usa.

REFRESH_INTERVAL = 'refresh_interval'

O intervalo em que o monitor atualiza seu estado interno. O valor deve ser uma cadeia de caracteres que represente um período de tempo, como '1 day'. As unidades compatíveis incluem segundos, minutos, horas, dias, semanas, meses, trimestres e anos. É possível usar o singular (“hora”) ou o plural (“horas”) para o nome do intervalo, mas não pode abreviá-lo.

ADD segment_column = '<segment_column_name>'

Adiciona uma coluna de segmento ao monitor. A coluna especificada deve existir nos dados de origem e ser do tipo STRING. Você pode adicionar até cinco colunas de segmento por monitor. Cada coluna de segmento deve ter menos de 25 valores exclusivos para garantir um desempenho ideal.

DROP segment_column = '<segment_column_name>'

Remove uma coluna de segmento do monitor.

Para obter mais informações sobre segmentos, consulte ML Observability: monitoramento do comportamento do modelo ao longo do tempo.

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

Modificar

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. Observe que uma função com privilégio concedido em um esquema permite que essa função resolva o esquema. Por exemplo, uma função com privilégio CREATE concedido em um esquema pode criar objetos nesse esquema sem também ter USAGE concedido nesse 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.