CREATE COMPUTE POOL¶
Cria um novo pool de computação na conta atual.
Dica
Além do SQL, você também pode usar outras interfaces, como Snowflake REST APIs, Snowflake Python APIs e Snowflake CLI. Consulte Interfaces alternativas.
- Consulte também:
- ALTER COMPUTE POOL , DESCRIBE COMPUTE POOL, DROP COMPUTE POOL , SHOW COMPUTE POOLS 
Sintaxe¶
CREATE COMPUTE POOL [ IF NOT EXISTS ] <name>
  [ FOR APPLICATION <app-name> ]
  MIN_NODES = <num>
  MAX_NODES = <num>
  INSTANCE_FAMILY = <instance_family_name>
  [ AUTO_RESUME = { TRUE | FALSE } ]
  [ INITIALLY_SUSPENDED = { TRUE | FALSE } ]
  [ AUTO_SUSPEND_SECS = <num>  ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
  [ 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. Nomes entre aspas para caracteres especiais ou nomes que diferenciam maiúsculas de minúsculas não são suportados. 
- 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». 
 - INSTANCE_FAMILY, consulte Tabela de consumo do serviço Snowflake - vCPU - Memória (GiB) - Armazenamento (GB) - Limite de largura de banda (Gbps) - GPU - Memória GPU por GPU (GiB) - Limite de nós - Descrição - CPU_X64_XS - 1 - 6 - 100 - Até 12,5 - n/a - n/a - 50 - Menor instância disponível para Snowpark Containers. Ideal para economizar custos e começar. - CPU_X64_S - 3 - 13 - 100 - Até 12,5 - n/a - n/a - 50 - Ideal para hospedar vários serviços/trabalhos enquanto economiza custos. - CPU_X64_M - 6 - 28 - 100 - Até 12,5 - n/a - n/a - 50 - Ideal para ter um aplicativo full stack ou múltiplos serviços - CPU_X64_SL - 14 - 54 - 100 - Até 12,5 - n/a - n/a - 50 - Para aplicativos que precisam de um grande número de CPUs, memória e armazenamento. - CPU_X64_L - 28 - 116 - 100 - 12,5 - n/a - n/a - 50 - Para aplicativos que precisam de um número incomumente grande de CPUs, memória e armazenamento. - HIGHMEM_X64_S - 6 - 58 - 100 - AWS e GCP: até 12,5, Azure: 8 - n/a - n/a - 50 - Para aplicativos com uso intensivo de memória. - HIGHMEM_X64_M, . CPU de alta memória | M - 28 - AWS: 240, Azure e GCP: 244 - 100 - AWS: 12,5, Azure e GCP: 16 - n/a - n/a - 50 - Para hospedar vários aplicativos com uso intenso de memória em uma única máquina. - HIGHMEM_X64_SL, . CPU de alta memória | SL . (somente Azure e GCP) - 92 - 654 - 100 - 32 - n/a - n/a - 20 - A maior máquina de alta memória do Azure ou GCP disponível para processamento de grandes volumes de dados em memória. - HIGHMEM_X64_L, . CPU de alta memória | L . (somente AWS) - 124 - 984 - 100 - 50 - n/a - n/a - 20 - A maior máquina de alta memória do AWS disponível para processamento de grandes volumes de dados em memória. - GPU_NV_S, . GPU | S . (somente AWS, exceto nas regiões de Cingapura, Suíça Norte, Paris e Osaka) - 6 - 27 - 300 (NVMe) - Até 10 - 1 NVIDIA A10G - 24 - 10 - Nosso menor tamanho NVIDIA GPU disponível para Snowpark Containers para começar. - GPU_NV_M (somente AWS, exceto nas regiões de Singapura, Norte da Suíça, Paris e Osaka) - 44 - 178 - 3,4 TB (NVMe) - 40 - 4 NVIDIA A10G - 24 - 10 - Otimizado para cenários de uso intensivo de GPU, como Pesquisa Visual Computacional ou LLMs/VLMs. - GPU_NV_L (somente AWS, disponível somente nas regiões US West e US East da AWS mediante solicitação; disponibilidade limitada pode ser possível em outras regiões mediante solicitação) - 92 - 1112 - 6,8 TB (NVMe) - 400 - 8 NVIDIA A100 - 40 - Mediante solicitação - Maior instância de GPU para casos de GPU especializados e avançados, como LLMs e clustering etc. - GPU_NV_XS (somente Azure, exceto regiões Norte da Suíça, UAE North, US Central e UK South) - 3 - 26 - 100 - 8 - 1 NVIDIA T4 - 16 - 10 - Nosso menor tamanho de GPU NVIDIA Azure disponível para contêineres Snowpark para começar. - GPU_NV_SM (somente Azure, exceto região US Central) - 32 - 424 - 100 - 40 - 1 NVIDIA A10 - 24 - 10 - Um tamanho menor de GPU NVIDIA Azure disponível para contêineres Snowpark para começar. - GPU_NV_2M (somente Azure, exceto região US Central) - 68 - 858 - 100 - 80 - 2 NVIDIA A10 - 24 - 5 - Otimizado para cenários de uso intensivo de GPU, como Pesquisa Visual Computacional ou LLMs/VLMs. - GPU_NV_3M (somente Azure, exceto regiões US Central, Norte da Europa e UAE North) - 44 - 424 - 100 - 40 - 2 NVIDIA A100 - 80 - Mediante solicitação - Otimizado para cenários de uso intensivo de memória com GPU, como Pesquisa Visual Computacional ou LLMs/VLMs. - GPU_NV_SL (somente Azure, exceto regiões US Central, Norte da Europa e UAE North) - 92 - 858 - 100 - 80 - 4 NVIDIA A100 - 80 - Mediante solicitação - Maior instância de GPU para casos de GPU especializados e avançados, como LLMs e clustering etc. - GPU_GCP_NV_L4_1_24G (somente Google Cloud) - 6 - 28 - 300 - Até 16 - 1 NVIDIA L4 - 24 - 10 - Nosso menor tamanho NVIDIA GPU disponível para Snowpark Containers para começar. - GPU_GCP_NV_L4_4_24G (somente Google Cloud) - 44 - 178 - 1200 - Até 50 - 4 NVIDIA L4 - 24 - 10 - Cenários de uso do GPU como Visão Computacional ou LLMs. - GPU_GCP_NV_A100_8_40G (somente Google Cloud, disponível apenas nas regiões GCP US Central1 e Europe West4 mediante solicitação) - 92 - 654 - 2500 - Até 100 - 8 NVIDIA A100 - 40 - Mediante solicitação - Otimizado para cenários de uso intensivo de memória com GPU, como Pesquisa Visual Computacional ou LLMs/VLMs. - 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_FAMILYespecífico.
- A coluna Limite de nós indica o número máximo de nós que uma conta Snowflake pode provisionar para o tipo - INSTANCE_FAMILYespecífico. Entre em contato com seu representante de conta para aumentar o limite.
 
Parâmetros opcionais¶
- FOR APPLICATION app_name
- Especifica o nome do Snowflake Native App. Se especificado, o pool de computação só poderá ser usado pelo aplicativo nativo. A saída do comando SHOW COMPUTE POOLS inclui as colunas - is_exclusivee- applicationpara indicar se o pool de computação foi criado exclusivamente para um aplicativo e fornece o nome do aplicativo.
- 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. Se - auto_suspend_secsfor definido como 0, o Snowflake não suspende o pool de computação automaticamente.- Padrão: 3600 segundos 
- 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 Cota de tags para objetos. 
- COMMENT = 'string_literal'
- Especifica um comentário para o pool de computação. - Padrão: sem valor 
Requisitos de controle de acesso¶
A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:
| 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;
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;
Interfaces alternativas¶
- Snowflake REST APIs - Cria um ponto de extremidade do pool de computação (ou altera um existente) 
 
- Snowflake Python APIs 
- Snowflake CLI - Comando snow object create