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.

For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.