CREATE GIT REPOSITORY

Erstellt einen Stagingbereich für das Git-Repository im Schema oder ersetzt einen vorhandenen Stagingbereich für das Git-Repository.

Siehe auch:

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

Syntax

CREATE [ OR REPLACE ] GIT REPOSITORY [ IF NOT EXISTS ] <name>
  ORIGIN = '<repository_url>'
  API_INTEGRATION = <integration_name>
  [ GIT_CREDENTIALS = <secret_name> ]
  [ COMMENT = '<string_literal>' ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
Copy

Erforderliche Parameter

name

Gibt den Bezeichner für den zu erstellenden 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.

ORIGIN = 'repository_url'

Gibt den Ursprung URL des Git-Repositorys an, das dieser Stagingbereich repräsentiert.

Die URL muss HTTPS verwenden.

Von der Befehlszeile aus können Sie den Befehl git config aus Ihrem lokalen Repository verwenden, um den Wert für den Parameter ORIGIN zu erhalten, wie im folgenden Beispiel gezeigt:

$ git config --get remote.origin.url
https://github.com/mycompany/My-Repo.git
Copy
API_INTEGRATION = integration_name

Gibt die API INTEGRATION an, die Informationen zum Ziel-Git-Repository enthält, wie z. B. die zulässigen Anmeldeinformationen und Präfixe für Ziel-URLs.

Die API-Integration, die Sie hier angeben, muss einen API_PROVIDER-Parameter haben, dessen Wert auf git_https_api gesetzt ist.

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

Optionale Parameter

GIT_CREDENTIALS = secret_name

Gibt das Snowflake-Geheimnis an, das die für die Authentifizierung mit dem Repository zu verwendenden Anmeldeinformationen enthält. Lassen Sie diesen Parameter weg, um das Standardgeheimnis zu verwenden, das von der API-Integration vorgegeben wird, oder wenn diese Integration keine Authentifizierung erfordert.

Verwenden Sie am besten ein persönliches Zugriffstoken für den PASSWORD-Wert des Geheimnisses. Informationen zum Erstellen eines persönlichen Zugriffstokens in GitHub finden Sie in der GitHub-Dokumentation unter Verwalten der persönlichen Zugangstokens.

Das Geheimnis, das Sie hier angeben, muss ein Geheimnis sein, das mit dem Parameter ALLOWED_AUTHENTICATION_SECRETS der API-Integration angegeben wurde, die Sie mit dem Parameter API_INTEGRATION dieses Befehls angeben.

Standard: Kein Wert

Referenzinformationen zu Geheimnissen finden Sie unter CREATE SECRET.

COMMENT = 'string_literal'

Gibt einen Kommentar für die Integration des externen Zugangs an.

Standard: Kein Wert

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.

Anforderungen an die Zugriffssteuerung

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

Berechtigung

Objekt

Anmerkungen

CREATE GIT REPOSITORY

Schema

USAGE

API-Integration

Die durch den Parameter API INTEGRATION dieses Befehls angegebene Integration

USAGE

Geheimnis

Das durch den Parameter GIT_CREDENTIALS dieses Befehls angegebene Geheimnis

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

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.

Beispiele

Der Code im folgenden Beispiel erstellt einen Git-Repository-Stagingbereich mit dem Namen snowflake_extensions, wobei die Ursprungs-URL des Repositorys https://github.com/my-account/snowflake-extensions.git ist. Das Beispiel verwendet eine API-Integration mit dem Namen git_api_integration sowie ein Geheimnis mit dem Namen git_secret, um Anmeldeinformationen zur Authentifizierung mit dem Repository zu speichern.

Weitere Informationen zum Einrichten der Integration mit einem Repository finden Sie unter Einrichten von Snowflake für Verwendung von Git.

CREATE OR REPLACE GIT REPOSITORY snowflake_extensions
  API_INTEGRATION = git_api_integration
  GIT_CREDENTIALS = git_secret
  ORIGIN = 'https://github.com/my-account/snowflake-extensions.git';
Copy
Sprache: Deutsch