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 detalhes, consulte Requisitos para identificadores.

STOP ALL

Suspende 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