SHOW REPLICATION DATABASES¶

列出您账户中的所有主数据库和次要数据库（即所有已启用复制的数据库），并指明每个账户所在的 :doc:` 区域 </user-guide/intro-regions>`。

语法¶

SHOW REPLICATION DATABASES [ LIKE '<pattern>' ]
                           [ WITH PRIMARY <account_identifier>.<primary_db_name> ]

Copy

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用不区分大小写的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回相同的结果：

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

WITH PRIMARY {account_identifier}.{primary_db_name}: 指定命令的作用域，该作用域决定命令是否仅列出指定主数据库的记录。account_identifier 的形式可以是 org_name.account_name 或 snowflake_region.account_locator。有关详细信息，请参阅用于复制和故障转移的账户标识符。

以前缀 is_ 开头的列返回 Y (yes) 或 N (no)。
该命令不需要正在运行的仓库即可执行。
该命令最多返回指定对象类型的 1 万条记录，由用于执行命令的角色的访问权限决定；即使应用了筛选器，也不会返回任何超过 1 万条限制的记录。

要查看存在超过 1 万条记录的结果，请在 Snowflake Information Schema 中查询相应的视图（如果存在）。

在以下列中，命令输出提供主数据库和辅助数据库属性和元数据。覆盖多个区域组的组织的命令输出包括一个附加的 region_group 列。

列	描述
`region_group`	账户所在的:ref:` 区域组 <label-region_groups>`。注意：仅对于覆盖多个区域组的组织，才会显示此列。
`snowflake_region`	存储数据库的账户所在的 Snowflake 区域。Snowflake 区域是云平台区域内与其他 Snowflake 区域隔离的独特位置。Snowflake 区域可以是多租户或单租户（对于 Virtual Private Snowflake 账户）。
`created_on`	创建数据库的日期和时间。
`account_name`	存储数据库的账户的名称。
`name`	数据库的名称。
`comment`	数据库的注释。
`is_primary`	指示此数据库是否为主数据库；如果为否，则为辅助数据库。
`primary`	主数据库的完全限定名称，包括区域、账户和数据库名称。
`replication_allowed_to_accounts`	其中 `IS_PRIMARY` 为 TRUE，显示已为该主数据库启用复制功能的账户的完全限定名称。可以在每个账户中创建辅助数据库。
`failover_allowed_to_accounts`	其中 `IS_PRIMARY` 为 TRUE，显示已为该主数据库启用故障转移的账户的完全限定名称。可以在每个账户中创建辅助数据库，以实现业务连续性和灾难恢复。
`organization_name`	Snowflake 组织的名称。
`account_locator`	区域中的账户定位器。

显示名称以 mydb 开头的所有复制数据库：

SHOW REPLICATION DATABASES LIKE 'mydb%';

Copy

分别显示 myorg.account1.mydb1 org、账户和主数据库的所有辅助数据库：

SHOW REPLICATION DATABASES WITH PRIMARY myorg.account1.mydb1;

Copy