Gibt den neuen Bezeichner der Replikationsgruppe an. Der neue Bezeichner kann nicht verwendet werden, wenn der Bezeichner bereits für ein andere Replikations- oder Failover-Gruppe verwendet wird.
Gibt Eigenschaften an, die für die Replikationsgruppe festgelegt werden sollen (getrennt durch Leerzeichen, Kommas oder Neue-Zeile-Zeichen):
OBJECT_TYPES=object_type[,object_type,...]
Setzt die Liste von Objekttypen zurück, um die Replikation vom Quellkonto zu einem oder mehreren Zielkonten vorzunehmen.
Bemerkung
Datenbank- und Freigabeobjekte:
Wenn DATABASES oder SHARES in der Liste OBJECT_TYPES enthalten sind und in der Liste OBJECT_TYPES verbleiben, nachdem die Liste zurückgesetzt wurde, bleibt die Liste der jeweils zulässigen Objekte (ALLOWED_DATABASES oder ALLOWED_SHARES) unverändert.
Wenn die Liste OBJECT_TYPES zurückgesetzt wird, um DATABASES hinzuzufügen oder zu entfernen, wird die Liste ALLOWED_DATABASES auf NULL gesetzt.
Wenn die Liste OBJECT_TYPES zurückgesetzt wird, um SHARES hinzuzufügen oder zu entfernen, wird die Liste ALLOWED_SHARES auf NULL gesetzt.
Verwenden Sie die Klauseln ADD, MOVE und REMOVE, um die Liste der zulässigen Datenbank- oder Freigabeobjekte zu ändern.
Fügen Sie Datenbankobjekte zur Liste der Objekttypen hinzu. Wenn in der Liste der angegebenen Objekttypen bereits Datenbankobjekte enthalten waren, bleibt die Liste ALLOWED_DATABASES unverändert. Um die Liste der Datenbanken zu ändern, verwenden Sie die ADD-, MOVE- oder REMOVE-Klausel.
INTEGRATIONS:
Erfordert Business Critical Edition (oder höher).
Derzeit werden nur Sicherheitsintegrationen, API-Integrationen, Speicherintegrationen [3], Integrationen für den externen Zugriff [4] sowie bestimmte Typen von Benachrichtigungsintegrationen unterstützt. Weitere Details dazu finden Sie unter Integrationsreplikation.
Wenn Integrationsobjekte in der Liste der angegebenen Objekttypen enthalten sind, muss der Parameter ALLOWED_INTEGRATION_TYPES gesetzt werden.
NETWORK POLICIES:
Erfordert Business Critical Edition (oder höher).
Alle Netzwerkrichtlinien im Quellkonto.
RESOURCE MONITORS:
Erfordert Business Critical Edition (oder höher).
Alle Ressourcenmonitore im Quellkonto.
ROLES:
Erfordert Business Critical Edition (oder höher).
Alle Rollen im Quellkonto. Das Replizieren von Rollen schließt implizit alle Berechtigungen für Objekttypen ein, die in der Replikationsgruppe enthalten sind. Wenn beispielsweise ROLES der einzige Objekttyp ist, der repliziert wird, werden nur Rollenhierarchien (d. h. Rollen, die anderen Rollen zugewiesen werden) in Zielkonten repliziert. Wenn der Objekttyp USERS ebenfalls enthalten ist, werden auch die Rollenzuweisungen an die Benutzer repliziert.
SHARES:
Fügen Sie Freigabeobjekte zur Liste der Objekttypen hinzu. Wenn in der Liste der freigegebenen Objekttypen bereits Freigabeobjekte enthalten waren, bleibt die Liste ALLOWED_SHARES unverändert. Um die Liste der Freigaben zu ändern, verwenden Sie die ADD-, MOVE- oder REMOVE-Klausel.
USERS:
Erfordert Business Critical Edition (oder höher).
Alle Benutzer des Quellkontos.
WAREHOUSES:
Erfordert Business Critical Edition (oder höher).
Alle Warehouses des Quellkontos.
ALLOWED_DATABASES=db_name[,db_name,...]
Gibt die Datenbank oder die Liste der Datenbanken an, für die Sie die Replikation vom Quellkonto in das Zielkonto aktivieren. Damit Sie diesen Parameter einstellen können, muss die OBJECT_TYPES-Liste DATABASES enthalten.
db_name
Gibt den Bezeichner der Datenbank an.
ALLOWED_SHARES=share_name[,share_name,...]
Gibt die Freigabe oder die Liste der Freigaben an, für die Sie die Replikation vom Quellkonto in das Zielkonto aktivieren. Damit Sie diesen Parameter einstellen können, muss die OBJECT_TYPES-Liste SHARES enthalten.
share_name
Gibt den Bezeichner der Freigabe an.
Bemerkung
Wenn die Liste ALLOWED_DATABASES oder ALLOWED_SHARES geändert wurden, werden alle Objekte, die sich zuvor in der Liste befanden und entfernt wurden, bei der nächsten Aktualisierungsoperation in jedem Zielkonto mit einer verknüpften sekundären Replikationsgruppe gelöscht.
Typ(en) von Integrationen, für die Sie die Replikation vom Quellkonto in das Zielkonto aktivieren.
Die Liste OBJECT_TYPES muss INTEGRATIONS enthalten, damit dieser Parameter gesetzt werden kann.
Die folgenden Integrationstypen werden unterstützt:
SECURITY INTEGRATIONS:
Gibt die Sicherheitsintegrationen an.
Die Liste OBJECT_TYPES muss ROLES enthalten, damit dieser Parameter gesetzt werden kann.
API INTEGRATIONS:
Gibt die API-Integrationen an.
Für die Replikation von API-Integrationen sind zusätzliche Einstellungen erforderlich, nachdem die API-Integration in das Zielkonto repliziert wurde. Weitere Informationen dazu finden Sie unter Aktualisieren des Remotedienstes für API-Integrationen.
Der externe Zugriff wird in der Gov-Region nicht unterstützt.
NOTIFICATION INTEGRATIONS:
Gibt die Benachrichtigungsintegrationen an.
Es werden nur bestimmte Typen von Benachrichtigungsintegrationen repliziert. Weitere Details dazu finden Sie unter Integrationsreplikation.
REPLICATION_SCHEDULE...
Gibt den Zeitplan für das Aktualisieren der sekundären Replikationsgruppen an:
USINGCRONexprtime_zone
Gibt einen Cron-Ausdruck und eine Zeitzone für das Aktualisieren der sekundären Gruppe an. Unterstützt eine Teilmenge der Standardsyntax des Cron-Dienstprogramms.
# __________ minute (0-59)# | ________ hour (0-23)# | | ______ day of month (1-31, or L)# | | | ____ month (1-12, JAN-DEC)# | | | | __ day of week (0-6, SUN-SAT, or L)# | | | | |# | | | | | * * * * *
Folgende Sonderzeichen werden unterstützt:
*
Platzhalter. Gibt jedes vorkommende Feld an.
L
Steht für „last“ (letzte). Bei Verwendung im Feld Wochentag können Sie Konstrukte wie „den letzten Freitag“ („5L“) eines bestimmten Monats angeben. Im Feld Tag des Monats wird der letzte Tag des Monats angegeben.
/n
Gibt die n-te Instanz einer bestimmten Zeiteinheit an. Jeder Zeitanteil wird unabhängig berechnet. Wenn beispielsweise im Monatsfeld 4/3 angegeben ist, ist die Aktualisierung für April, Juli und Oktober geplant (d. h. alle 3 Monate, beginnend mit dem 4. Monat des Jahres). In den Folgejahren wird derselbe Zeitplan beibehalten. Das heißt, die Aktualisierung ist nicht für eine Ausführung im Januar (3 Monate nach der Oktober-Ausführung) geplant.
Bemerkung
Der Cron-Ausdruck wird derzeit nur für die angegebene Zeitzone ausgewertet. Durch Ändern des TIMEZONE-Parameterwerts für das Konto (oder Festlegen des Werts auf Benutzer- oder Sitzungsebene) wird die Zeitzone für das Aktualisieren nicht geändert.
Der Cron-Ausdruck definiert alle gültigen Ausführungszeiten für das Aktualisieren. Snowflake versucht, die sekundären Gruppen auf Basis dieses Zeitplans zu aktualisieren. Eine gültige Laufzeit wird jedoch übersprungen, wenn eine vorherige Laufzeit nicht vor dem Start der nächsten gültigen Laufzeit abgeschlossen wurde.
Wenn sowohl ein bestimmter Tag des Monats als auch ein bestimmter Wochentag im Cron-Ausdruck enthalten sind, wird die Aktualisierung an Tagen geplant, die entweder dem Tag des Monats oder dem Wochentag entsprechen. Beispielsweise plant SCHEDULE='USINGCRON0010-20*TUE,THUUTC' eine Aktualisierung um 0:00 Uhr an jedem 10. bis 20. Tag des Monats und auch an jedem Dienstag oder Donnerstag außerhalb dieser Tage.
numMINUTE
Gibt ein Intervall (in Minuten) der Wartezeit zwischen den Aktualisierungen an. Akzeptiert nur positive ganze Zahlen.
Unterstützt auch die Syntax numM.
Um Mehrdeutigkeiten zu vermeiden, wird in folgenden Situationen eine Basisintervallzeit festgelegt:
Das Objekt wird erstellt (mit CREATE <Objekt>) oder
Ein anderes Intervall wird festgelegt (mit ALTER <Objekt> … SET REPLICATION_SCHEDULE)
Die Basisintervallzeit startet den Intervallzähler ab der aktuellen Uhrzeit. Wenn beispielsweise ein INTERVAL-Wert von 10 festgelegt ist und die geplante Aktualisierung um 9:03 Uhr aktiviert wird, wird die Aktualisierung um 9:13 Uhr, 9:23 Uhr usw. ausgeführt. Beachten Sie, dass wir uns nach besten Kräften bemühen, absolute Präzision sicherzustellen, aber nur garantieren, dass Aktualisierungen nicht vor ihrem festgelegten Intervall ausgeführt werden (im aktuellen Beispiel könnte es sein, dass die Aktualisierung erst 9:14 Uhr ausgeführt wird, aber definitiv nicht 9:12 Uhr).
Bemerkung
Der maximal unterstützte Wert ist 11520 (8 Tage). Wenn der Replikationsplan einen größeren Wert numMINUTE hat, wird die Aktualisierungsoperation nie ausgeführt.
ENABLE_ETL_REPLICATION=TRUE|FALSE
Veraltete Funktion
Dieser Parameter ist jetzt veraltet. Um die ETL-Replikation zu aktivieren, müssen Sie das BCR-Bundle 2024_02 aktivieren. Weitere Informationen dazu finden Sie unter Anforderungen für ETL-Replikation.
ADDdb_name[,db_name,...]TOALLOWED_DATABASES
Gibt eine durch Kommas getrennte Liste von Datenbanken an, die zur Liste der für die Replikation aktivierten Datenbanken hinzugefügt werden sollen. Um eine Datenbank hinzuzufügen, muss DATABASES in der Liste der angegebenen Objekttypen enthalten sein. Wenn DATABASES noch nicht in der Liste der Objekttypen enthalten ist, müssen Sie diesen Typ hinzufügen.
Gibt eine durch Kommas getrennte Liste von Datenbanken an, die von einer Replikationsgruppe in eine andere Replikationsgruppe verschoben werden sollen. Bei der Replikationsgruppe, in die die Datenbanken verschoben werden, muss DATABASES in der Liste der angegebenen Objekttypen enthalten sein.
db_name
Gibt den Bezeichner der Datenbank an.
move_to_rg_name
Gibt den Bezeichner für die Replikationsgruppe an, in die die Datenbanken verschoben werden sollen.
REMOVEdb_name[,db_name,...]FROMALLOWED_DATABASES
Gibt eine durch Kommas getrennte Liste von Datenbanken an, die aus der Liste der für die Replikation und aktivierten Datenbanken entfernt werden sollen.
Bemerkung
Wenn Sie eine Datenbank aus einer primären Replikationsgruppe entfernen, wird die Datenbank bei der nächsten Aktualisierungsoperation in jedem Zielkonto mit einer verknüpften sekundären Replikationsgruppe gelöscht.
Um zu vermeiden, dass Datenbanken im Zielkonto gelöscht werden, können Sie die sekundäre Replikationsgruppe löschen, bevor die geänderte primäre Replikationsgruppe das nächste Mal in das Zielkonto repliziert wird. Wenn Sie die sekundäre Replikationsgruppe löschen, werden die schreibgeschützten Sekundärdatenbanken, die in der Gruppe enthalten waren, zu eigenständigen Datenbanken mit Lese-/Schreib-Zugriff im Zielkonto.
ADDshare_name[,share_name,...]TOALLOWED_SHARES
Gibt eine durch Kommas getrennte Liste von Freigaben an, die zur Liste der für die Replikation aktivierten Freigaben hinzugefügt werden sollen. Um eine Freigabe hinzuzufügen, muss SHARES in der Liste der angegebenen Objekttypen enthalten sein. Wenn SHARES noch nicht in der Liste der Objekttypen enthalten ist, müssen Sie diesen Typ hinzufügen.
Gibt eine durch Kommas getrennte Liste von Freigaben an, die von einer Replikationsgruppe in eine andere Replikationsgruppe verschoben werden sollen. Bei der Replikationsgruppe, in die die Freigaben verschoben werden, muss SHARES in der Liste der angegebenen Objekttypen enthalten sein.
share_name
Gibt den Bezeichner der Freigabe an.
move_to_rg_name
Gibt den Bezeichner für die Replikationsgruppe an, in die die Freigaben verschoben werden sollen.
Gibt eine durch Kommas getrennte Liste von Freigaben an, die aus der Liste der für die Replikation aktivierten Freigaben entfernt werden sollen.
Bemerkung
Wenn Sie eine Freigabe aus einer primären Replikationsgruppe entfernen, wird die Freigabe bei der nächsten Aktualisierungsoperation in jedem Zielkonto mit einer verknüpften sekundären Replikationsgruppe gelöscht.
Gibt eine durch Kommas getrennte Liste von Zielkonten an, die der primären Replikationsgruppe hinzugefügt werden sollen, um die Replikation der angegebenen Objekte vom Quellkonto in das Zielkonto zu aktivieren.
org_name
Name Ihrer Snowflake-Organisation.
target_account_name
Zielkonto, für das Sie die Replikation der angegebenen Objekte aktivieren.
Gibt eine durch Kommas getrennte Liste von Zielkonten an, die aus der primären Replikationsgruppe entfernt werden sollen, um die Replikation der angegebenen Objekte vom Quellkonto in das Zielkonto zu deaktivieren.
org_name
Name Ihrer Snowflake-Organisation.
target_account_name
Zielkonto, für das Sie die Replikation der angegebenen Objekte deaktivieren.
IGNOREEDITIONCHECK
Ermöglicht das Replizieren von Objekten in Konten mit niedrigeren Editionen in einem der folgenden Szenarios:
Eine primäre Replikationsgruppe, die nur Datenbank- und/oder Freigabeobjekte enthält, befindet sich in einem Business Critical-Konto (oder höher), aber eines oder mehrere der zur Replikation genehmigten Konten weisen niedrigere Editionen auf. Die Business Critical Edition ist für Snowflake-Konten mit äußerst sensiblen Daten vorgesehen.
Eine primäre Replikationsgruppe mit einem beliebigen Objekttyp befindet sich in einem Business Critical-Konto (oder höher), und es besteht eine unterzeichnete Geschäftspartner-Vereinbarung zur Speicherung von PHI-Daten in dem Konto gemäß HIPAA- und HITRUST-Vorschriften. Allerdings besteht für eines oder mehrere der zur Replikation genehmigten Konten keine solche Vereinbarung, unabhängig davon, ob es sich um Business Critical-Konten (oder höhere) handelt.
Beide Szenarios sind standardmäßig nicht erlaubt, um zu verhindern, dass Kontoadministratoren von Business Critical-Konten (oder höher) versehentlich vertrauliche Daten in Konten mit niedrigeren Editionen replizieren.
Zielkonto
name
Gibt den Bezeichner der Replikationsgruppe an.
REFRESH
Aktualisiert die Objekte im (aktuellen) Zielkonto aus dem Quellkonto.
SUSPEND
Anhalten der geplanten Aktualisierung der sekundären Replikationsgruppe (wenn die primäre Replikationsgruppe automatische Aktualisierungen mit der Eigenschaft REPLICATION_SCHEDULE geplant hat).
Bemerkung
Das Anhalten der geplanten Replikation hat keine Auswirkungen auf eine Aktualisierungsoperation, die gerade ausgeführt wird. Es wird nur der Zeitplan angehalten, sodass nach Abschluss der aktuellen Aktualisierung keine weiteren Aktualisierungen geplant sind.
RESUME
Fortsetzen der geplanten Aktualisierung der sekundären Replikationsgruppe (wenn die primäre Replikationsgruppe automatische Aktualisierungen mit der Eigenschaft REPLICATION_SCHEDULE geplant hat).
Folgende Berechtigungen sind mindestens erforderlich:
Zum Aktualisieren einer sekundären Replikationsgruppe mit ALTER REPLICATION GROUP … REFRESH muss die aktive Primärrolle entweder die OWNERSHIP- oder die REPLICATE-Berechtigung für die Replikationsgruppe haben.
Um weitere Änderungen an der Replikationsgruppe vorzunehmen, kann nur ein Benutzer mit einer Rolle mit OWNERSHIP-Berechtigung für die Gruppe diesen SQL-Befehl ausführen.
Um eine Datenbank zu einer Replikationsgruppe hinzuzufügen, muss die aktive Rolle über die MONITOR-Berechtigung für die Datenbank verfügen.
Um eine Freigabe zu einer Replikationsgruppe hinzuzufügen, muss die aktive Rolle über die OWNERSHIP-Berechtigung für die Freigabe verfügen.
Bezeichner für Failover-Gruppen und Replikationsgruppen in einem Konto müssen eindeutig sein.
Anders als Datenbanken oder Freigaben müssen sich Objekte in der gleichen Replikationsgruppe befinden.
Eine Datenbank kann nur zu einer einzigen Replikations- oder Failover-Gruppe hinzugefügt werden.
So verschieben Sie Datenbanken oder Freigaben von einer Replikationsgruppe (der „Verschieben von“-Gruppe) in eine andere Replikationsgruppe (die „Verschieben nach“-Gruppe):
Beide Gruppen müssen vom gleichen Typ sein: REPLICATION GROUP.
Wenn die letzte Datenbank der „Verschieben von“-Gruppe in eine andere Gruppe verschoben wurde, wird die Eigenschaft allowed_databases für die „Verschieben von“-Gruppe auf NULL gesetzt. Das gleiche Verhalten gilt für Freigaben.
Wenn in der object_types-Liste der „Verschieben nach“-Gruppe nicht der Objekttyp enthalten ist, der verschoben werden soll (databases oder shares), muss dieser Typ vor dem Verschieben von Objekten explizit zur „Verschieben nach“-Gruppe hinzugefügt werden.
Wenn Datenbank- oder Freigabeobjekte aus einer primären Replikationsgruppe entfernt werden (mit dem Parameter REMOVE oder SET, um die ALLOWED_DATABASES- oder ALLOWED_SHARES-Liste zu ändern), werden diese Objekte bei der nächsten Aktualisierungsoperation in jedem Zielkonto mit einer verknüpften sekundären Replikationsgruppe gelöscht.
Um zu vermeiden, dass diese Objekte im Zielkonto gelöscht werden, können Sie die sekundäre Replikationsgruppe löschen, bevor die geänderte primäre Replikationsgruppe das nächste Mal in das Zielkonto repliziert wird.
Eingehende Freigaben (Freigaben von Anbietern) können nicht zu einer Replikations- oder Failover-Gruppe hinzugefügt werden.
Um die Liste der Konten in Ihrer Organisation abzurufen, die für die Replikation aktiviert sind, verwenden Sie den Befehl SHOW REPLICATION ACCOUNTS.
Um die Liste der Replikationsgruppe in Ihrer Organisation abzurufen, verwenden Sie den Befehl SHOW REPLICATION GROUPS. In der Spalte allowed_accounts werden alle Zielkonten aufgelistet, die für die Replikation von einem Quellkonto aktiviert sind.
Metadaten:
Achtung
Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.