CREATE COMPUTE POOL¶

Sintaxe¶

CREATE COMPUTE POOL [ IF NOT EXISTS ] <name>
  MIN_NODES = <num>
  MAX_NODES = <num>
  INSTANCE_FAMILY = <instance_family_name>
  [ AUTO_RESUME = { TRUE | FALSE } ]
  [ INITIALLY_SUSPENDED = { TRUE | FALSE } ]
  [ AUTO_SUSPEND_SECS = <num>  ]
  [ COMMENT = '<string_literal>' ]

Parâmetros obrigatórios¶

name

Cadeia de caracteres que especifica o identificador (ou seja, o nome) do pool de computação; deve ser exclusivo para sua conta.

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

MIN_NODES = num

Especifica o número mínimo de nós para o pool de computação. Este valor deve ser maior que 0. Para obter mais informações, consulte Criação de um pool de computação.

MAX_NODES = num

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

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.

Os valores INSTANCE_FAMILY na tabela a seguir podem ser agrupados em 3 categorias:

• Tipos de instância genéricas: fornecem um equilíbrio entre CPU, memória e disco. Isso não inclui GPU. Esses nomes de família de instâncias começam com «CPU».

• Tipos de instância com muita memória: semelhantes aos tipos de instância genéricos, mas fornecem mais memória. Esses nomes de família de instâncias começam com «HighMemory».

• Tipos de instância com GPU anexado: esses nomes de famílias de instâncias começam com «GPU».

Mapeamento da tabela de consumo	INSTANCE_FAMILY	vCPU	Memória (GiB)	Armazenamento (GiB)	GPU	Memória GPU por GPU (GiB)	Descrição
CPU | XS	CPU_X64_XS	2	8	250	n/a	n/a	Menor instância disponível para Snowpark Containers. Ideal para economizar custos e começar.
CPU | S	CPU_X64_S	4	16	250	n/a	n/a	Ideal para hospedar vários serviços/trabalhos enquanto economiza custos.
CPU | M	CPU_X64_M	8	32	250	n/a	n/a	Ideal para ter um aplicativo full stack ou múltiplos serviços
CPU | L	CPU_X64_L	32	128	250	n/a	n/a	Para aplicativos que precisam de um número incomumente grande de CPUs, memória e armazenamento.
CPU de alta memória | S	HIGHMEM_X64_S	8	64	250	n/a	n/a	Para aplicativos com uso intensivo de memória.
CPU de alta memória | M	HIGHMEM_X64_M	32	256	250	n/a	n/a	Para hospedar vários aplicativos com uso intenso de memória em uma única máquina.
CPU de alta memória | L	HIGHMEM_X64_L	128	1024	250	n/a	n/a	A maior máquina com muita memória disponível para processar grandes dados na memória.
GPU | S	GPU_NV_S	8	32	250	1 NVIDIA A10G	24	Nosso menor tamanho NVIDIA GPU disponível para Snowpark Containers para começar.
GPU | M	GPU_NV_M	48	192	250	4 NVIDIA A10G	24	Otimizado para cenários de uso intensivo de GPU, como Visão computacional ou LLMs/VLMs
GPU | L	GPU_NV_L	192	2048	250	8 NVIDIA A100	40	Maior instância GPU para casos de GPU especializados e avançados, como LLMs e clustering etc.

O vínculo da tabela de consumo no cabeçalho da primeira coluna fornece informações sobre a taxa de consumo de crédito para o INSTANCE_FAMILY específico.

Parâmetros opcionais¶

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 RESUME) antes de iniciar um serviço ou trabalho no pool de computação.

• Se AUTO_RESUME for TRUE, se você iniciar um novo serviço em um pool de computação suspenso, o Snowflake iniciará o pool de computação. Da mesma forma, quando você usa um serviço invocando uma função de serviço ou acessando a entrada (consulte Como usar um serviço), o Snowflake inicia o pool de computação suspenso anteriormente e retoma o serviço.

Padrão: TRUE

INITIALLY_SUSPENDED = { TRUE | FALSE }

Especifica se o pool de computação é criado inicialmente no estado suspenso. Se você criar um pool de computação com INITIALLY_SUSPENDED definido como TRUE, o Snowflake não provisionará nenhum nó solicitado para o pool de computação no momento da criação do pool de computação. Você pode iniciar o pool de computação suspenso usando ALTER COMPUTE POOL … RESUME.

Padrão: FALSE

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. Um pool de computação inativo é aquele em que nenhum serviço ou trabalho está em execução em nenhum nó do pool.

Padrão: 3600 segundos

COMMENT = 'string_literal'

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

Padrão: sem valor

Requisitos de controle de acesso¶

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

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¶

Crie um pool de computação de 1 nó. Este comando de exemplo especifica os parâmetros mínimos necessários:

CREATE COMPUTE POOL tutorial_compute_pool
  MIN_NODES = 1
  MAX_NODES = 1
  INSTANCE_FAMILY = CPU_X64_XS;

O comando a seguir especifica o parâmetro opcional AUTO_RESUME:

CREATE COMPUTE POOL tutorial_compute_pool
  MIN_NODES = 1
  MAX_NODES = 1
  INSTANCE_FAMILY = CPU_X64_XS
  AUTO_RESUME = FALSE;