SHOW FAILOVER GROUPS¶
Listet die primären und sekundären Failover-Gruppen Ihres Kontos auf, sowie die Failover-Gruppen anderer Konten, die mit Ihrem Konto verbunden sind.
Bei anderen Konten:
Listet die primären Failover-Gruppen auf, die für Replikation und Failover zu diesem Konto aktiviert sind.
Listet die sekundären Failover-Gruppen auf, die mit den Gruppen dieses Kontos verknüpft sind.
- Siehe auch:
CREATE FAILOVER GROUP, ALTER FAILOVER GROUP, DROP FAILOVER GROUP
Syntax¶
SHOW FAILOVER GROUPS [ IN ACCOUNT <account> ]
Parameter¶
accountGibt den Bezeichner des Kontos an. Der Kontoname ist innerhalb Ihrer Organisation ein eindeutiger Bezeichner. Weitere Informationen zum Kontonamen finden Sie unter Format 1 (bevorzugt): Kontoname in Ihrer Organisation.
Nutzungshinweise¶
Zum Ausführen dieses Befehls ist eine Rolle mit einer der folgenden Berechtigungen für die Failover-Gruppe erforderlich:
FAILOVER
MONITOR
OWNERSHIP
REPLICATE
Die Ausgabe von SHOW FAILOVER GROUPS enthält nur Gruppen des Typs
FAILOVER.
Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.
Der Befehl gibt nur Objekte zurück, für die der aktuellen Rolle des aktuellen Benutzers mindestens ein Zugriffsrecht zugewiesen wurde.
Das Zugriffsrecht MANAGE GRANTS gibt seinem Eigentümer implizit die Möglichkeit, jedes Objekt im Konto anzuzeigen. Standardmäßig haben nur der Kontoadministrator (Benutzer mit der Rolle ACCOUNTADMIN) und der Systemadministrator (Benutzer mit der Rolle SECURITYADMIN) die Berechtigung MANAGE GRANTS.
Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie den Befehl Pipe-Operator (
->>) oder die RESULT_SCAN-Funktion verwenden. Beide Konstrukte behandeln die Ausgabe als Resultset, das Sie abfragen können.Sie können zum Beispiel den Pipe-Operator oder die RESULT_SCAN-Funktion verwenden, um bestimmte Spalten aus der SHOW-Befehlsausgabe auszuwählen oder die Zeilen zu filtern.
Wenn Sie sich auf die Ausgabespalten beziehen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen. Um beispielsweise die Ausgabespalte
typeauszuwählen, geben SieSELECT "type"an.Sie müssen Bezeichner in doppelten Anführungszeichen verwenden, da die Ausgabespaltennamen für SHOW-Befehle in Kleinbuchstaben geschrieben sind. Die doppelten Anführungszeichen stellen sicher, dass die Spaltennamen in der SELECT-Liste oder WHERE-Klausel den Spaltennamen in der SHOW-Befehlsausgabe entsprechen, die gescannt wurde.
Ausgabe¶
Der Befehl gibt die folgenden Spalten zurück:
Spalte |
Beschreibung |
|---|---|
|
Regionsgruppe, in der sich das Konto befindet. Hinweis: Diese Spalte wird nur Organisationen angezeigt, die sich über mehrere Regionsgruppen (Regionsgruppen) erstrecken. |
|
Snowflake Region, in der sich das Konto befindet. Eine Snowflake Region ist ein bestimmter Speicherort innerhalb einer Cloudplattform-Region. Eine Snowflake Region ist von jeder anderen Snowflake Region isoliert ist. Eine Snowflake Region kann entweder für Einzelmandanten oder für mehrere Mandanten sein (für ein Virtual Private Snowflake-Konto). |
|
Datum und Uhrzeit der Erstellung der Failover-Gruppe. |
|
Name des Kontos. |
|
Name der Failover-Gruppe. |
|
Typ der Gruppe. Gültiger Wert ist |
|
Kommentarzeichenfolge. |
|
Gibt an, ob die Failover-Gruppe die primäre Gruppe ist. |
|
Name der primären Gruppe. |
|
Liste der angegebenen Objekttypen, die für Replikation und Failover aktiviert sind. |
|
Eine Liste der Integrationstypen, die für die Replikation aktiviert sind. Snowflake fügt diese Spalte immer in die Ausgabe ein, auch wenn im Befehl CREATE FAILOVER GROUP oder ALTER FAILOVER GROUP keine Integrationen angegeben wurden. |
|
Liste der Konten, die für Replikation und Failover aktiviert sind. |
|
Name Ihrer Snowflake-Organisation |
|
Konto-Locator in einer Region. |
|
Geplantes Intervall für die Aktualisierung. NULL, wenn kein Replikationsplan festgelegt ist. |
|
Aktueller Status der geplanten Aktualisierung. Gültige Werte sind |
|
Datum und Uhrzeit der nächsten geplanten Aktualisierung. |
|
Name der Rolle mit OWNERSHIP-Berechtigung für die Failover-Gruppe. NULL wenn sich die Failover-Gruppe in einer anderen Region befindet. |
|
TRUE, wenn die Replikationsgruppe für die Cloud-übergreifende automatische Ausführung verwendet wird. Andernfalls FALSE. |
Beispiele¶
Auflisten der Failover-Gruppen im Konto 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 |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+