ALTER COMPUTE POOL¶

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> ]
                                            [ PLACEMENT_GROUP = '<placement_group_name>' ]
                                            [ INSTANCE_FAMILY = <instance_family_name> ]
                                            [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ]
                                            [ COMMENT = '<string_literal>' ]

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

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.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Especifica o nome da tag e o valor da cadeia de caracteres dela.

O valor de tag é sempre uma cadeia de caracteres, e o número máximo de caracteres do valor da tag é 256.

Para obter informações sobre como especificar tags em uma instrução, consulte Tag quotas.

PLACEMENT_GROUP = placement_group_name

Identifica o grupo de posicionamento do pool de computação. Use os comandos SHOW COMPUTE POOLS e DESCRIBE COMPUTE POOL para revisar a atribuição do pool de computação aos grupos de posicionamento.

INSTANCE_FAMILY = instance_family_name

Identifica o tipo de máquina que você deseja provisionar para os nós no pool de computação. O tipo de máquina determina a quantidade de recursos de computação no pool de computação e, portanto, o número de créditos consumidos enquanto o pool de computação está em execução. Para obter uma lista de nomes de família de instâncias disponíveis, consulte as famílias de instâncias.

INSTANCE_FAMILY só pode ser alterado quando um pool de computação é totalmente suspenso. Ao retomar, o Snowflake usa o novo tipo de instância para provisionar o pool de computação.

COMMENT = 'string_literal'

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

UNSET ...

Specifies one or more properties and/or parameters to unset for the compute pool, which resets them to the defaults. For more information, see CREATE COMPUTE POOL:

• AUTO_SUSPEND_SECS

• AUTO_RESUME

• PLACEMENT_GROUP: O grupo de posicionamento pode ser removido da definição apenas quando o pool de computação é totalmente suspenso.

• COMMENT

Requisitos de controle de acesso¶

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

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

O exemplo a seguir define «CPU_X64_S» como INSTANCE_FAMILTY para um pool de computação. Como o pool de computação deve ser interrompido para alterar a família de instâncias, ele é suspenso primeiro:

ALTER COMPUTE POOL tutorial_compute_pool SUSPEND;
ALTER COMPUTE POOL tutorial_compute_pool SET
  INSTANCE_FAMILY = CPU_X64_S;
ALTER COMPUTE POOL tutorial_compute_pool RESUME;