ALTER COMPUTE POOL

Modifica as propriedades de um pool de computação existente.

Consulte também:

CREATE COMPUTE POOL , DESCRIBE COMPUTE POOL, DROP COMPUTE POOL , SHOW COMPUTE POOLS

Sintaxe

ALTER COMPUTE POOL [ IF EXISTS ] <name> { SUSPEND | RESUME }

ALTER COMPUTE POOL [ IF EXISTS ] <name> STOP ALL;

ALTER COMPUTE POOL [ IF EXISTS ] <name> SET [ MIN_NODES = <num> ]
                                            [ MAX_NODES = <num> ]
                                            [ AUTO_RESUME = { TRUE | FALSE } ]
                                            [ AUTO_SUSPEND_SECS = <num> ]
                                            [ COMMENT = '<string_literal>' ]

ALTER COMPUTE POOL [ IF EXISTS ] <name> UNSET { AUTO_SUSPEND_SECS |
                                                AUTO_RESUME       |
                                                COMMENT
                                              }
                                              [ , ... ]
Copy

Parâmetros

name

Especifica o identificador do pool de computação 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.

{ SUSPEND | RESUME }

Suspende um pool de computação ou retoma um pool de computação suspenso anteriormente. Quando você suspende um pool de computação, o Snowflake suspende todos os serviços no pool de computação em questão, mas os trabalhos continuam em execução até atingirem um estado terminal (DONE ou FAILED), após o qual os nós do pool de computação são liberados.

STOP ALL

Descarta todos os serviços e cancela trabalhos em execução no pool de computação. O Snowflake remove todos os contêineres do pool de computação.

SET ...

Define uma ou mais propriedades ou parâmetros especificados para o pool de computação:

MIN_NODES = num

Especifica o número mínimo de nós do pool de computação.

MAX_NODES = num

Especifica o número máximo de nós do pool de computação.

AUTO_RESUME = { TRUE | FALSE }

Especifica se um pool de computação deve ser retomado automaticamente quando um serviço ou trabalho é enviado a ele. Se AUTO_RESUME for FALSE, você precisará retomar explicitamente o pool de computação (usando ALTER COMPUTE POOL <nome> RESUME) antes de iniciar um serviço ou trabalho no pool de computação.

AUTO_SUSPEND_SECS = num

Número de segundos de inatividade após os quais você deseja que o Snowflake suspenda automaticamente o pool de computação. Inatividade significa nenhum serviço e nenhum trabalho em execução em qualquer nó do pool de computação.

COMMENT = 'string_literal'

Especifica um comentário para o pool de computação.

UNSET ...

Especifica uma (ou mais) propriedades e/ou parâmetros a serem removidos da definição do pool de computação, que os redefine aos padrões (consulte CREATE COMPUTE POOL):

  • AUTO_SUSPEND_SECS

  • AUTO_RESUME

  • COMMENT

Requisitos de controle de acesso

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio

Objeto

Notas

OPERATE

Pool de computação

Para suspender ou retomar um pool de computação, a função requer estas permissões.

MODIFY

Pool de computação

Para alterar o pool de computação e definir propriedades, a função requer essa permissão.

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 define as propriedades MAX_NODES e AUTO_RESUME para um pool de computação:

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE
Copy