Kategorien:

Systemfunktionen (Systemsteuerung)

SYSTEM$START_OAUTH_FLOW

Initiiert den OAUTH-Client-Ablauf und gibt eine URL zurück, die Sie in einem Browser verwenden, um den OAuth-Zustimmungsprozess abzuschließen.

Syntax

SYSTEM$START_OAUTH_FLOW( '<database_name.schema_name.secret_name>' )
Copy

Argumente

'database_name.schema_name.secret_name'

Der Name des OAuth2-Geheimnisses, das die Authentifizierungsinformationen für die API für den Zugriff mit OAuth angibt.

Nutzungshinweise

Verwenden Sie diese Funktion, um einen Ablauf zu starten, der dazu führt, dass ein OAuth-Aktualisierungstoken zu dem Geheimnis hinzugefügt wird, das Sie dieser Funktion als Argument übergeben.

Als Zwischenschritt liefert diese Funktion eine Autorisierungs-URL, die Sie in einem Browser eingeben können, um den OAuth-Zustimmungsprozess abzuschließen.

Nachdem Sie diese Funktion ausgeführt und die zurückgegebene URL verwendet haben, führen Sie sofort SYSTEM$FINISH_OAUTH_FLOW in derselben Sitzung aus, damit Snowflake ein Aktualisierungstoken zu dem von Ihnen angegebenen Geheimnis hinzufügt.

Das Geheimnis im Argument dieser Funktion muss Folgendes enthalten:

  • Einen TYPE-Parameter, der als Wert oauth2 angibt

  • Einen API_AUTHENTICATION-Parameter, der eine Sicherheitsintegration angibt, die Details (wie OAuth-Client-ID, Geheimnis, Autorisierungsendpunkt und Token-Endpunkt) zu dem Dienstanbieter enthält, für den der Zugang gewährt wird.