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 usado para Preenchimento automático entre nuvens. Caso contrário, FALSE.

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