ALTER-GATEWAY¶

Ändert die Konfiguration eines bestehenden -Gateways. Verwenden Sie diesen Befehl, um die Konfiguration der Aufteilung des Datenverkehrs für ein Gateway zu aktualisieren.

Siehe auch:: CREATE-GATEWAY , DESCRIBE-GATEWAY, DROP-GATEWAY , SHOW-GATEWAYS

Syntax¶

ALTER GATEWAY [ IF EXISTS ] <name>
  FROM SPECIFICATION <specification_text>

Parameter¶

name

Gibt den Bezeichner für das zu ändernde Gateway an.

Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

FROM SPECIFICATION

Gibt die aktualisierte Inline-Gateway-Spezifikation an. Die Spezifikation definiert die Konfiguration der Aufteilung des Datenverkehrs.

Die Spezifikation verwendet das folgende Format:

spec:
  type: traffic_split
  split_type: custom
  targets:
  - type: endpoint
    value: <db>.<schema>.<service>!<endpoint>
    weight: <weight>
  - type: endpoint
    value: <db>.<schema>.<service>!<endpoint>
    weight: <weight>

Spezifikationsparameter¶

type

Fester Wert. Muss auf traffic_split gesetzt sein.

split_type

Fester Wert. Muss auf custom gesetzt sein.

targets

Eine Liste der Zielendpunkte, an die der Datenverkehr weitergeleitet werden soll. Jedes Ziel muss Folgendes angeben:

type: Fester Wert. Muss auf endpoint gesetzt sein.
value: Der vollqualifizierte Endpunktname im Format db.schema.service!endpoint. Jeder Zielendpunkt muss vorhanden sein.
weight: Das Gewichtung des Datenverkehrs für diesen Endpunkt, angegeben als Ganzzahl. Alle Gewichtungen müssen in der Summe 100 ergeben.

Bemerkung

Die maximale Anzahl von Endpunkten pro Gateway beträgt standardmäßig 5.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:


Berechtigung	Objekt	Anmerkungen
MODIFY oder OWNERSHIP	Gateway	Erforderlich, um die Gateway-Konfiguration zu ändern.
BIND SERVICE ENDPOINT	Konto	Erforderlich, um Dienstendpunkte an das Gateway zu binden.
USAGE	Datenbank	Erforderlich für die Datenbank, die das Gateway enthält.
USAGE	Schema	Erforderlich für das Schema, das das Gateway enthält.
USAGE	Dienstendpunkte	Erforderlich für die Zieldienstendpunkte.

Um die erforderlichen Berechtigungen zu erteilen, verwenden Sie die folgenden Befehle:

-- Grant MODIFY or OWNERSHIP privilege on the gateway
GRANT MODIFY ON GATEWAY <gateway_name> TO ROLE <role_name>;
-- OR
GRANT OWNERSHIP ON GATEWAY <gateway_name> TO ROLE <role_name>;

-- Grant BIND SERVICE ENDPOINT privilege on the account
GRANT BIND SERVICE ENDPOINT ON ACCOUNT TO ROLE <role_name>;

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

Metadaten:

Achtung

Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „User“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

Beispiele¶

Ändern Sie ein Gateway, um die Konfiguration der Aufteilung des Datenverkehrs zu aktualisieren:

ALTER GATEWAY split_gateway
  FROM SPECIFICATION $$
spec:
  type: traffic_split
  split_type: custom
  targets:
  - type: endpoint
    value: db.schema.s2!ep1
    weight: 60
  - type: endpoint
    value: db.schema.s1!ep1
    weight: 40
$$;