CREATE MODEL MONITOR¶

Sintaxe¶

CREATE [ OR REPLACE ] MODEL MONITOR [ IF NOT EXISTS ] <monitor_name> WITH
    MODEL = <model_name>
    VERSION = '<version_name>'
    FUNCTION = '<function_name>'
    SOURCE = <source_name>
    WAREHOUSE = <warehouse_name>
    REFRESH_INTERVAL = '<refresh_interval>'
    AGGREGATION_WINDOW = '<aggregation_window>'
    TIMESTAMP_COLUMN = <timestamp_name>
    [ BASELINE = <baseline_name> ]
    [ ID_COLUMNS = <id_column_name_array> ]
    [ PREDICTION_CLASS_COLUMNS = <prediction_class_column_name_array> ]
    [ PREDICTION_SCORE_COLUMNS = <prediction_column-name_array> ]
    [ ACTUAL_CLASS_COLUMNS = <actual_class_column_name_array> ]
    [ ACTUAL_SCORE_COLUMNS = <actual_column_name_array> ]

Parâmetros obrigatórios¶

monitor_name

Especifica o identificador do monitoramento de modelo; deve ser exclusivo no esquema em que o monitor é criado e deve estar no mesmo esquema que o modelo que está sendo monitorado.

Se o identificador do monitoramento de modelo não for totalmente qualificado (na forma de db_name.schema_name.name ou schema_name.name), o comando criará o modelo no esquema atual para a sessão.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

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

MODEL = model_name

O nome do modelo a ser monitorado. Deve estar no mesmo esquema em que o monitor é criado.

VERSION = 'version_name'

Nome da versão do modelo a ser monitorada.

FUNCTION = function_name

Nome da função específica na versão do modelo a ser monitorada.

SOURCE = source_name

Nome da tabela ou exibição de origem com o recurso, as inferências e os rótulos da verdade fundamental.

WAREHOUSE = warehouse_name

O nome do warehouse do Snowflake a ser usado para as operações de computação interna do monitor.

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.

AGGREGATION_WINDOW = 'aggregation_window'

A janela na qual o monitor agrega dados. O valor deve ser uma cadeia de caracteres que represente um período de tempo, como '1 day'. Somente dias são compatíveis. Você pode usar o singular («dia») ou o plural («dias») para o nome do intervalo, mas não é possível abreviar.

TIMESTAMP_COLUMN = timestamp_name

Nome da coluna nos dados de origem com os carimbos de data/hora. Deve ser do tipo TIMESTAMP_NTZ ou DATE.

Parâmetros opcionais¶

BASELINE = baseline_name

Nome da tabela ou exibição de linha de base que contém um instantâneo de dados semelhante a SOURCE, que é usado para calcular o desvio. Um instantâneo desses dados é incorporado ao objeto do monitor. Embora esse parâmetro seja opcional, se não for definido, o monitor não poderá detectar desvios.

ID_COLUMNS = id_column_name_array

Uma matriz de nomes de colunas de cadeia de caracteres que, juntos, identificam exclusivamente cada linha nos dados de origem. Consulte Constantes ARRAY.

PREDICTION_CLASS_COLUMNS = prediction_class_column_name_array

Uma matriz de cadeias de caracteres que nomeia todas as colunas da classe de previsão na fonte de dados. Consulte Constantes ARRAY. As colunas devem ser do tipo NUMBER.

PREDICTION_SCORE_COLUMNS = prediction_column_name_array

Uma matriz de cadeias de caracteres que nomeia todas as colunas de pontuação de previsão na fonte de dados. Consulte Constantes ARRAY. As colunas devem ser do tipo NUMBER.

ACTUAL_CLASS_COLUMNS = actual_class_column_name_array

Uma matriz de cadeias de caracteres que nomeia todas as colunas de classe reais na fonte de dados. Consulte Constantes ARRAY. As colunas devem ser do tipo NUMBER.

ACTUAL_SCORE_COLUMNS = actual_column_name_array

Uma matriz de cadeias de caracteres que nomeia todas as colunas de pontuação reais na fonte de dados. Consulte Constantes ARRAY. As colunas devem ser do tipo NUMBER.

Requisitos de controle de acesso¶

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

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.

Notas de uso¶

Os seguintes requisitos se aplicam aos parâmetros:

• A tarefa modelo deve ser tabular_binary_classification ou tabular_regression.

• No momento, não há suporte para modelos de múltiplas saídas. Embora as colunas de previsão e dados reais sejam matrizes, as matrizes devem ter apenas um elemento.

• Pelo menos uma das colunas de previsão deve ser especificada.

• As colunas reais são opcionais, mas as métricas de precisão não serão computadas se não forem especificadas.

• Uma coluna pode ser especificada uma vez em todos os parâmetros (por exemplo, um ID de coluna não pode ser também uma coluna de previsão).

O número de recursos monitorados é limitado a 500.

A configuração básica das instâncias do MODEL MONITOR, incluindo o modelo que ele monitora e as fontes de dados que usa, não pode ser alterada depois que o monitoramento é criado. É possível modificar apenas algumas opções usando ALTER MODEL MONITOR. Para alterar a configuração de um monitor, elimine a instância e crie uma nova.

A replicação é compatível apenas com as instâncias da classe CUSTOM_CLASSIFIER.