SHOW REPLICATION GROUPS

Exibe informações sobre grupos de replicação e grupos de failover.

  • Lista cada grupo de replicação ou failover primário ou secundário nessa conta.

  • Lista os grupos de replicação e failover primários em outras contas habilitadas para replicação a essa conta.

  • Lista os grupos de replicação e failover secundários em outras contas ligadas a grupos dessa conta.

Consulte também:

CREATE REPLICATION GROUP, ALTER REPLICATION GROUP, DROP REPLICATION GROUP

Sintaxe

SHOW REPLICATION GROUPS [ IN ACCOUNT <account> ]
Copy

Parâmetros

account

Especifica o identificador da conta.

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 replicação ou failover foi criado.

account_name

Nome da conta.

name

Nome do grupo de replicação ou failover.

type

Tipo de grupo. Os valores válidos são REPLICATION ou FAILOVER.

comment

Cadeia de caracteres de comentários.

is_primary

Indica se o grupo de replicação ou 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 no caso de um grupo 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. <object> ou ALTER <object>.

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 replicação ou failover. NULL se o grupo de replicação ou 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.

Notas de uso

  • A execução desse comando requer uma função com qualquer um dos seguintes privilégios sobre um grupo de replicação:

    • MONITOR

    • OWNERSHIP

    • REPLICATE

  • A saída de SHOW REPLICATION GROUPS inclui grupos de tipos FAILOVER e REPLICATION.

  • 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.

Exemplos

Listar grupos de replicação em myaccount1:

SHOW REPLICATION 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            |                 |                               | 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