ALTER GIT REPOSITORY

Ändert die Eigenschaften eines vorhandenen Git-Repository-Stagingbereichs.

Siehe auch:

CREATE GIT REPOSITORY, DESCRIBE GIT REPOSITORY, DROP GIT REPOSITORY, SHOW GIT BRANCHES, SHOW GIT REPOSITORIES, SHOW GIT TAGS

Syntax

ALTER GIT REPOSITORY <name> SET
  [ GIT_CREDENTIALS = <secret_name> ]
  [ API_INTEGRATION = <integration_name> ]
  [ COMMENT = '<string_literal>' ]

ALTER GIT REPOSITORY <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER GIT REPOSITORY <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER GIT REPOSITORY <name> UNSET {
  GIT_CREDENTIALS |
  COMMENT }
  [ , ... ]

ALTER GIT REPOSITORY <name> FETCH
Copy

Parameter

name

Gibt den Bezeichner für den zu ändernden Repository-Stagingbereich 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.

SET ...

Gibt die Eigenschaften an, die für die Integration festgelegt werden sollen:

GIT_CREDENTIALS = secret_name

Gibt das Geheimnisobjekt an, das die Anmeldeinformationen für die Authentifizierung mit dem Git-Repository enthält.

Das Geheimnis, das Sie hier angeben, muss ein Geheimnis sein, das mit dem Parameter ALLOWED_AUTHENTICATION_SECRETS der für dieses Git-Repository festgelegten API-Integration angegeben wurde.

Referenzinformationen zu Geheimnissen finden Sie unter CREATE SECRET.

API_INTEGRATION = integration_name

Gibt die API-Integration an, die Details darüber enthält, wie Snowflake mit der Repository-API interagieren soll.

Referenzinformationen zu API-Integrationen finden Sie unter CREATE API INTEGRATION.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag-Kontingente für Objekte und Spalten.

COMMENT = 'string_literal'

Gibt einen Kommentar an.

Standard: Kein Wert

UNSET ...

Gibt die Eigenschaft an, die für die Integration deaktiviert werden soll, wodurch sie auf den Standardwert zurückgesetzt wird:

  • GIT_CREDENTIALS

  • COMMENT

Um mehrere Eigenschaften oder Parameter mit einer einzigen ALTER-Anweisung zurückzusetzen, trennen Sie jede Eigenschaft oder jeden Parameter durch ein Komma.

Wenn Sie eine Eigenschaft oder einen Parameter zurücksetzen, geben Sie nur den Namen der Eigenschaft oder des Parameters an (es sei denn, die obige Syntax weist darauf hin, dass Sie den Wert angeben sollten). Die Angabe des Wertes gibt einen Fehler zurück.

FETCH

Ruft Inhalte aus dem Git-Repository in den Repository-Stagingbereich ab.

Der abgerufene Inhalt ist ein vollständiger Klon, der alle Zweige, Tags und Commits aus dem externen Repository abruft. Der Befehl löscht auch Zweige und Commits, die früher abgerufen wurden, aber nicht mehr im externen Repository vorhanden sind.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

Anmerkungen

OWNERSHIP oder WRITE

Git-Repository

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

Beispiele

Das folgende Beispiel aktualisiert den Repository-Stagingbereich snowflake_extensions mit Daten aus seinem Git-Ursprung:

ALTER GIT REPOSITORY snowflake_extensions FETCH;
Copy
Sprache: Deutsch