SHOW FAILOVER GROUPS¶

Lista os grupos de failover primários e secundários em sua conta, assim como os grupos de failover em outras contas que estão associadas à sua conta.

Para as outras contas:

Lista os grupos de failover primários habilitados para replicação e failover para esta conta.
Lista os grupos de failover secundários ligados a grupos nesta conta.

Consulte também:: CREATE FAILOVER GROUP, ALTER FAILOVER GROUP, DROP FAILOVER GROUP

Sintaxe¶

SHOW FAILOVER GROUPS [ IN ACCOUNT <account> ]

Copy

Parâmetros¶

account: Especifica o identificador da conta. O nome da conta é um identificador único dentro de sua organização. Para obter mais detalhes sobre o nome da conta, consulte Formato 1 (preferido): Nome da conta em sua organização.

Notas de uso¶

A execução desse comando requer uma função com qualquer um dos seguintes privilégios sobre um grupo de failover:
- FAILOVER
- MONITOR
- OWNERSHIP
- REPLICATE
A saída de SHOW FAILOVER GROUPS inclui apenas grupos do tipo FAILOVER.

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.

Saída¶

O comando retorna as seguintes colunas:

Coluna	Descrição
`region_group`	Grupo de regiões onde a conta está localizada. Observação: essa coluna somente é visível 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 o grupo de failover foi criado.
`account_name`	Nome da conta.
`name`	Nome do grupo de failover.
`type`	Tipo de grupo. O valor válido é `FAILOVER`.
`comment`	Cadeia de caracteres de comentários.
`is_primary`	Indica se o grupo de failover é o grupo primário.
`primary`	Nome do banco de dados primário.
`object_types`	Lista de tipos de objetos especificados habilitados para replicação e failover.
`allowed_integration_types`	Uma lista de tipos de integração que estão habilitados para replicação. O Snowflake sempre inclui essa coluna na saída, mesmo que as integrações não tenham sido especificadas no comando CREATE FAILOVER GROUP ou ALTER FAILOVER GROUP.
`allowed_accounts`	Lista de contas habilitadas para replicação e failover.
`organization_name`	Nome de sua organização no Snowflake.
`account_locator`	Localizador de conta em uma região.
`replication_schedule`	Intervalo programado para atualização; NULL se nenhum horário de replicação for definido.
`secondary_state`	Estado atual da atualização programada. Os valores válidos são `started` ou `suspended`. NULL se nenhum cronograma de replicação for definido.
`next_scheduled_refresh`	Data e hora da próxima atualização agendada.
`owner`	Nome da função com o privilégio OWNERSHIP sobre o grupo de failover. NULL se o grupo de failover estiver em uma região diferente.
`is_listing_auto_fulfillment_group`	TRUE se o grupo de replicação for utilizado para preenchimento automático entre nuvens. FALSE caso contrário.

Exemplos¶

Listar grupos de failover na conta myaccount1.

SHOW FAILOVER GROUPS IN ACCOUNT myaccount1;

+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+
| snowflake_region | created_on                    | account_name | name | type     | comment | is_primary | primary               | object_types                                | allowed_integration_types |  allowed_accounts                            | organization_name | account_locator   | replication_schedule | secondary_state | next_scheduled_refresh        | owner      | is_listing_auto_fulfillment_group |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+
| AWS_US_EAST_1    | 2021-10-25 19:08:15.209 -0700 | MYACCOUNT1   | MYFG | FAILOVER |         | true       | MYORG.MYACCOUNT1.MYFG | DATABASES, ROLES, USERS, WAREHOUSES, SHARES |                           | MYORG.MYACCOUNT1.MYFG,MYORG.MYACCOUNT2.MYFG  | MYORG             | MYACCOUNT1LOCATOR | 10 MINUTE            | NULL            |                               | MYROLE     | false                             |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+
| AWS_US_WEST_2    | 2021-10-25 19:08:15.209 -0700 | MYACCOUNT2   | MYFG | FAILOVER |         | false      | MYORG.MYACCOUNT1.MYFG |                                             |                           |                                              | MYORG             | MYACCOUNT2LOCATOR | 10 MINUTE            | STARTED         | 2022-03-06 12:10:35.280 -0800 | NULL       | false                             |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+

Copy