Étape 4 : créer la fonction externe pour GCP dans Snowflake

Ces instructions montrent comment créer un objet de base de données de fonction externe dans Snowflake. Cet objet de base de données stocke des informations sur le service distant, comme les paramètres que le service distant accepte.

Dans ce chapitre :

Créer l’objet de base de données de fonction externe

Vous devriez être dans une session d’interface Web Snowflake.

  1. Collez la commande CREATE EXTERNAL FUNCTION. La commande doit être similaire à ce qui suit :

    create or replace external function <external_function_name>(<parameters>)
        returns variant
        api_integration = <api_integration_name>
        as '<function_URL>' ;
    
  2. Remplacez <nom_de_fonction_externe> par un nom de fonction unique (par exemple, echo).

  3. Enregistrez le nom de la fonction dans le champ « Nom de la fonction externe » de la feuille de calcul.

  4. Remplacez les <paramètres> par les noms et les types de données SQL des paramètres, le cas échéant. Par exemple : a integer, b varchar.

    Les paramètres doivent correspondre aux paramètres attendus par le service distant. Les noms des paramètres ne doivent pas nécessairement correspondre, mais les types de données doivent être compatibles.

  5. Enregistrez le nom du paramètre et les types de données dans le champ « Nom de la fonction externe » de la feuille de calcul.

  6. Dans la clause api_integration remplacez <nom_intégration_api> par la valeur du champ « Nom de l’intégration API » dans la feuille de calcul.

  7. Remplacez <URL_fonction> par la valeur du champ « URL de base de la passerelle » de la feuille de calcul, suivie d’une barre oblique (/) et de la valeur du champ « Suffixe du chemin » de la feuille de calcul.

    L’URL devrait ressembler à ceci :

    https://<gateway-base-url>/<path-suffix>
    
  8. Si vous ne l’avez pas encore fait, exécutez la commande CREATE EXTERNAL FUNCTION que vous avez tapée ci-dessus.

  9. Vous devriez maintenant être en mesure d’appeler votre fonction externe pour vérifier qu’elle fonctionne correctement. Pour plus de détails, voir Appel d’une fonction externe pour GCP.

Étape suivante

Snowflake recommande fortement de définir une politique de sécurité sur la Google Cloud API Gateway :

Étape 5 : définir la politique de sécurité pour le service proxy (Google Cloud API Gateway)