ALTER EXPERIMENT

Modifica as propriedades de um experimento existente.

Consulte também:

CREATE EXPERIMENT , SHOW EXPERIMENTS, DROP EXPERIMENT , SHOW RUNS IN EXPERIMENT , SHOW RUN … IN EXPERIMENT

Sintaxe

ALTER EXPERIMENT <experiment_name> ADD RUN <run_name>

ALTER EXPERIMENT <experiment_name> COMMIT RUN <run_name>

ALTER EXPERIMENT <experiment_name> DROP RUN <run_name>
Copy

Parâmetros

experiment_name

Especifica o identificador do experimento a ser alterado.

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.

ADD RUN run_name

Adiciona uma nova execução com o identificador run_name; deve ser exclusivo para as execuções no experimento experiment_name.

Para obter informações sobre como executar manualmente um experimento em SQL, consulte Início da execução do experimento.

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.

COMMIT RUN run_name

Conclui a execução com o identificador run_name para o experimento experiment_name. Execuções confirmadas não podem ser alteradas.

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.

Para obter informações sobre como recuperar os resultados e artefatos de uma execução de experimento, consulte Conclusão da execução.

DROP RUN run_name

Exclui a execução com o identificador run_name.

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

MODIFY

Experimento

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.

Notas de uso

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos

O exemplo a seguir cria uma nova execução chamada run_1 no experimento my_experiment:

ALTER EXPERIMENT my_experiment ADD RUN run_1;
Copy

O exemplo a seguir conclui e registra a execução chamada run_1 no experimento my_experiment:

ALTER EXPERIMENT my_experiment COMMIT RUN run_1;
Copy
Linguagem: Português