CREATE COMPUTE POOL¶

Cria um novo pool de computação na conta atual.

Consulte também:: ALTER COMPUTE POOL , DESCRIBE COMPUTE POOL, DROP COMPUTE POOL , SHOW COMPUTE POOLS

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>' ]

Copy

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 informações, 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)

Máx. Limit

Descrição

CPU | XS

CPU_X64_XS

2

8

250

n/a

n/a

50

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

50

Ideal para hospedar vários serviços/trabalhos enquanto economiza custos.

CPU | M

CPU_X64_M

8

32

250

n/a

n/a

20

Ideal para ter um aplicativo full stack ou múltiplos serviços

CPU | L

CPU_X64_L

32

128

250

n/a

n/a

20

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

20

Para aplicativos com uso intensivo de memória.

CPU de alta memória | M

HIGHMEM_X64_M

32

256

250

n/a

n/a

20

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

20

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

10

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

5

Otimizado para cenários de uso intensivo de GPU, como Visão computacional ou LLMs/VLMs

GPU | L

GPU_NV_L

96

1152

250

8 NVIDIA A100

40

Mediante solicitação

Maior instância GPU para casos de GPU especializados e avançados, como LLMs e clustering etc.

Mapeamento da tabela de consumo	INSTANCE_FAMILY	vCPU	Memória (GiB)	Armazenamento (GiB)	GPU	Memória GPU por GPU (GiB)	Máx. Limit	Descrição
CPU \| XS	CPU_X64_XS	2	8	250	n/a	n/a	50	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	50	Ideal para hospedar vários serviços/trabalhos enquanto economiza custos.
CPU \| M	CPU_X64_M	8	32	250	n/a	n/a	20	Ideal para ter um aplicativo full stack ou múltiplos serviços
CPU \| L	CPU_X64_L	32	128	250	n/a	n/a	20	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	20	Para aplicativos com uso intensivo de memória.
CPU de alta memória \| M	HIGHMEM_X64_M	32	256	250	n/a	n/a	20	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	20	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	10	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	5	Otimizado para cenários de uso intensivo de GPU, como Visão computacional ou LLMs/VLMs
GPU \| L	GPU_NV_L	96	1152	250	8 NVIDIA A100	40	Mediante solicitação	Maior instância GPU para casos de GPU especializados e avançados, como LLMs e clustering etc.

Observe o seguinte:

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.
A coluna de limite máx. indica o número máximo de nós que uma conta Snowflake pode provisionar para o tipo INSTANCE_FAMILY específico. Entre em contato com seu representante de conta para aumentar o limite.

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á ativo 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:

Privilégio	Objeto	Notas
CREATE COMPUTE POOL	Conta

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;

Copy

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;

Copy