Use gateways para rotear solicitações de entrada para vários pontos de extremidade¶

Se você quiser expor vários pontos de extremidade de serviço por trás de um único nome de host, poderá criar um gateway. Um gateway tem um nome de host semelhante a um ponto de extremidade de serviço público. Para obter mais informações sobre pontos de extremidade de serviço públicos, consulte Configurar entrada de serviço.

Os gateways encaminham solicitações de entrada, incluindo solicitações de inferência, de fora do Snowflake para um ou mais pontos de extremidade de serviço. Com os gateways, você pode fazer o seguinte:

• Divisão de tráfego entre serviços: você pode permitir que vários serviços compartilhem o mesmo nome de host. O roteamento é feito com base na porcentagem dada para cada serviço. Isso é útil nos seguintes cenários:

  • Cenário de teste A/B: você pode optar por atualizar um serviço e implantá-lo, mantendo o serviço original em execução. Para testes, você pode optar por rotear uma determinada porcentagem de solicitações de entrada recebidas para o serviço atualizado para testes.

  • Cenário de alta disponibilidade: você tem um serviço de alta disponibilidade implantado, digamos, em dois pools de computação, em que cada um é criado em um grupo de posicionamento diferente. Você pode optar por usar o gateway para dividir as solicitações de entrada recebidas.

• URL estável: cada gateway tem um nome de host alocado na criação. O nome do host não muda durante a vida útil do objeto de gateway. Você pode alterar o objeto gateway para rotear para pontos de extremidade diferentes ou ter configurações de porcentagem diferentes. As alterações entram em vigor em um minuto.

A lista a seguir mostra as diferenças entre um ponto de extremidade de serviço e um gateway:

• Segurança do navegador: o ponto de extremidade de serviço oferece suporte à configuração CORS (corsSettings) e aos cabeçalhos do provedor de serviços em nuvem (cloud service provider, CSP) para acesso baseado em navegador por meio de integrações de acesso externo. Um gateway atualmente não é compatível com os cabeçalhos CORS ou CSP.

• Direitos do autor da chamada: o ponto de extremidade de serviço é compatível com os direitos do autor da chamada. Um gateway atualmente não é compatível com os direitos do autor da chamada.

• Controle de acesso baseado em funções (role-based access control, RBAC): ao usar um ponto de extremidade de serviço, o acesso é gerenciado por meio de funções de serviço. Quando você usa um gateway, o acesso é gerenciado com a concessão do privilégio USAGE no objeto do gateway. Os usuários que acessam um gateway não precisam de funções de serviço para os pontos de extremidade de serviço subjacentes.

O roteamento do gateway respeita a porcentagem relativa dos pontos de extremidade íntegros especificados. Para mais informações sobre o comportamento de failover de um gateway, consulte Comportamento de failover do gateway.

Depois de revisar as seções a seguir, você poderá criar e alterar um gateway. Para informações sobre como criar uma sessão, consulte CREATE GATEWAY. Para mais informações sobre como alterar um gateway, consulte ALTER GATEWAY.