Étape 3 : créer l’intégration API pour Azure dans Snowflake¶

Étape précédente¶

Portail Azure:

Étape 2 : Créer le service proxy (service de gestion des API Azure) dans le portail

Modèle ARM:

Étape 2 : Utiliser le modèle pour créer le service distant (Azure Function) et le service proxy (service de gestion des API)

Informations requises¶

Vous avez besoin des informations suivantes pour créer l’intégration API pour Azure dans Snowflake :

• Azure Function App AD Application ID (de votre feuille de suivi)

• ID de client Azure AD (comme décrit dans la section Conditions préalables pour la planification d’une fonction externe)

Créer l’intégration d’objet API¶

Utilisez la commande CREATE API INTEGRATION pour créer l’objet d’intégration API :

1. Open a Snowflake session, typically a Snowflake web interface session.

2. Exécutez la commande USE ROLE pour utiliser le rôle ACCOUNTADMIN ou un rôle avec le privilège CREATE INTEGRATION. Par exemple :

   use role has_accountadmin_privileges;
   

   Copy

3. Entrez une instruction CREATE API INTEGRATION. L’instruction devrait ressembler à ce qui suit :

   create or replace api integration <integration_name>
       api_provider = azure_api_management
       azure_tenant_id = '<tenant_id>'
       azure_ad_application_id = '<azure_application_id>'
       api_allowed_prefixes = ('<url>')
       enabled = true;
   

   Copy

   Dans l’instruction :

   1. Remplacez <nom_intégration> par un nom d’intégration unique (par ex. my_api_integration_name). Le nom doit suivre les règles pour Identificateurs d’objet.

      En outre, enregistrez le nom de l’intégration dans le champ API Integration Name dans votre feuille de calcul de suivi. Vous aurez besoin de ce nom lorsque vous exécuterez la commande CREATE EXTERNAL FUNCTION plus tard dans le processus de création.

   2. Remplacez <id_client> par votre ID de client Azure AD.

      Vous pouvez également utiliser votre domaine (par exemple my_company.onmicrosoft.com).

   3. Remplacez <id_application_azure> par la valeur du champ Azure Function App AD Application ID de votre feuille de calcul de suivi.

   4. Pour api_allowed_prefixes, remplacez <url> par l’URL appropriée.

      En général, il s’agit de l’URL du service proxy (c’est-à-dire le service de gestion des API Azure), au format suivant :

      https://<api_management_service_name>.azure-api.net
      

      Copy

      Cependant, vous pouvez restreindre les URLs auxquelles cette intégration API peut être appliquée en ajoutant un suffixe approprié, auquel cas l’URL a le format suivant :

      https://<api_management_service_name>.azure-api.net/<api_url_suffix>
      

      Copy

      L’URL que vous saisissez dépend de l’utilisation du portail Azure ou du modèle ARM pour créer votre fonction externe :

      Portail Azure:

      Utilisez les valeurs des champs API Management API URL suffix et API Management service name de votre feuille de calcul de suivi. Par exemple, votre URL devrait ressembler à :

      https://my-api-management-svc.azure-api.net/my-api-url-suffix
      

      Copy

      Elle doit correspondre à l’URL de base et au suffixe de l’onglet Settings du service Gestion des API pour votre API importée. Si cela vous convient, vous pouvez copier la valeur de l’onglet à la place.

      Modèle ARM:

      Utilisez la valeur du champ API Management URL de votre feuille de calcul de suivi.

4. Si vous ne l’avez pas encore fait, exécutez l’instruction CREATE API INTEGRATION que vous avez saisie.

Étape suivante¶

Étape 4 : Lier l’intégration API pour Azure au service proxy dans le portail