SHOW CONNECTIONS¶

Lista as conexões para as quais você tem privilégios de acesso.

A saída retorna metadados e propriedades da conexão, ordenados pelo nome da conexão (consulte Saída neste tópico para descrições das colunas de saída). É importante observar isso se você pretende filtrar os resultados usando os filtros fornecidos.

Consulte também:: CREATE CONNECTION , ALTER CONNECTION , DROP CONNECTION

Sintaxe¶

SHOW CONNECTIONS [ 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¶

A saída do comando fornece metadados e propriedades de conexão 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).
`created_on`	Data e hora em que a conexão foi criada.
`account_name`	Nome da conta. Um administrador da organização pode alterar o nome da conta.
`name`	Nome da conexão.
`comment`	Comentário para a conexão.
`is_primary`	Indica se a conexão é uma conexão primária.
`primary`	Nome da organização, nome da conta e nome da conexão da conexão primária. Este valor pode ser copiado na cláusula AS REPLICA OF do comando CREATE CONNECTION ao criar conexões secundárias.
`failover_allowed_to_accounts`	Uma lista de todas as contas para as quais a conexão primária pode ser redirecionada.
`connection_url`	URL da conexão que os usuários passam a um cliente para estabelecer uma conexão com o Snowflake.
`organization_name`	Nome de sua organização no Snowflake.
`account_locator`	Localizador de conta em uma região.

Para obter mais informações sobre as propriedades que podem ser especificadas para uma conexão, consulte CREATE CONNECTION.

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 a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada. Você também pode usar o operador de canal para consultar a saída desse comando.

Exemplos¶

Mostrar todas as conexões cujo nome começa com test:

SHOW CONNECTIONS LIKE 'test%';

Copy