Schritt 4: Externe Funktion für GCP in Snowflake erstellen

Unter diesem Thema finden Sie eine Anleitung zum Erstellen eines externen Funktionsobjekts in Snowflake. Dieses Objekt speichert Informationen über den Remotedienst, z. B. die Parameter, die der Remotedienst akzeptiert.

Bemerkung

Externe Funktionen in Snowflake sind Datenbankobjekte, d. h. sie müssen im Schema einer Datenbank erstellt werden. Um eine externe Funktion zu erstellen, müssen Sie über die entsprechenden Berechtigungen für die Datenbank und das Schema verfügen, in dem Sie die Funktion erstellen.

Weitere Details dazu finden Sie unter Zugriffssteuerungsrechte.

Unter diesem Thema:

Externes Funktionsobjekt erstellen

Für diese Aufgabe müssen Sie sich auf der Seite Worksheets Worksheet tab der Snowflake-Weboberfläche befinden:

  1. Geben Sie eine CREATE EXTERNAL FUNCTION-Anweisung ein. Diese Anweisung sollte ungefähr wir folgt aussehen:

    create or replace external function <external_function_name>(<parameters>)
        returns variant
        api_integration = <api_integration_name>
        as '<function_url>';
    
  2. Ersetzen Sie den <external_function_name> durch einen eindeutigen Funktionsnamen (z. B. echo). Dieser Name muss den Regeln für Objektbezeichner folgen.

    Notieren Sie sich den Funktionsnamen im Feld „External Function Name“ des Arbeitsblatts.

  3. Ersetzen Sie die <parameters> durch die Namen und SQL-Datentypen der Parameter, falls vorhanden. Beispiel:

    a integer, b varchar
    

    Die Parameter müssen mit den Parametern übereinstimmen, die der Remotedienst erwartet. Die Parameternamen müssen nicht übereinstimmen, aber die Datentypen müssen kompatibel sein.

    Notieren Sie sich außerdem die Namen und Datentypen der Parameter im Feld „External Function Name“ des Arbeitsblatts.

  4. Ersetzen Sie <api_integration_name> durch den Wert aus dem Feld „API Integration Name“ Ihres Arbeitsblatts.

  5. Ersetzen Sie <function_URL> durch die Werte aus den Feldern „Gateway Base URL“ und „Path Suffix“, getrennt durch einen Schrägstrich (/).

    Die URL sollte ähnlich aussehen wie:

    https://<gateway-base-url>/<path-suffix>
    
  6. Falls noch nicht geschehen, führen Sie den eingegebenen Befehl CREATE EXTERNAL FUNCTION aus.

Externe Funktion testen

Sie sollten nun in der Lage sein, Ihre externe Funktion aufzurufen, um zu überprüfen, ob sie korrekt funktioniert.

Bemerkung

Wenn Sie der Konfigurationsdatei eine Sicherheitsdefinition hinzugefügt haben, um Ihr Gateway in Schritt 2: Proxydienst (Google Cloud API Gateway) über die Konsole erstellen des Tutorials zu sichern, können Sie Ihre externe Funktion erst testen, wenn Sie die Sicherheitsdefinitionen in der Konfigurationsdatei in Schritt 5: GCP-Sicherheitsrichtlinie für Proxydienst über die Konsole erstellen des Tutorials aktualisiert haben.

Weitere Details dazu finden Sie unter Aufrufen einer externen Funktion für GCP.