SHOW REGIONS

Lista todas as regiões nas quais as contas podem ser criadas. Este comando retorna o nome da Snowflake Region, o provedor da nuvem (AWS, Google Cloud Platform ou Microsoft Azure) que hospeda a conta e o nome do provedor da nuvem para a região.

Consulte também:

CURRENT_REGION

Sintaxe

SHOW REGIONS [ LIKE '<pattern>' ]
Copy

Parâmetros

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

Saída

O comando de saída fornece propriedades da região e metadados nas seguintes colunas. A saída de comando para organizações que abrangem múltiplos grupos de regiões inclui uma coluna adicional region_group.

Coluna

Descrição

region_group

Grupo de regiões onde a conta está localizada. Observação: esta coluna é exibida apenas para organizações que abrangem vários grupos de regiões.

snowflake_region

Snowflake Region onde a conta está localizada. Uma Snowflake Region é um local distinto dentro de uma região de plataforma em nuvem que é isolada de outras Snowflake Regions. Uma Snowflake Region pode ser multilocatária ou unilocatária (para uma conta Virtual Private Snowflake).

cloud

Nome do provedor da nuvem que hospeda a conta.

region

Região onde a conta está localizada; ou seja, o nome do provedor da nuvem para a região.

display_name

Nome da região da nuvem legível pelo homem, por exemplo US West (Oregon)

Notas de uso

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • O comando retorna apenas objetos para os quais a função atual do usuário atual recebeu pelo menos um privilégio de acesso.

  • O privilégio de acesso MANAGE GRANTS permite implicitamente que seu titular consulte todos os objetos da conta. Por padrão, somente o administrador de conta (usuários com a função ACCOUNTADMIN) e o administrador de segurança (usuários com a função SECURITYADMIN) têm o privilégio MANAGE GRANTS.

  • Para pós-processar a saída deste comando, você pode usar o operador de canal (->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.

    Os nomes das colunas de saída para este comando são gerados em minúsculas. Se você consumir um conjunto de resultados deste comando com o operador de canal ou a função RESULT_SCAN, use identificadores entre aspas duplas para os nomes das colunas na consulta para garantir que eles correspondam aos nomes das colunas na saída que foi verificada. Por exemplo, se o nome de uma coluna de saída for type, especifique "type" para o identificador.