Etapa 3: criar a integração de API para o Azure no Snowflake¶

Etapa anterior¶

Portal do Azure:

Etapa 2: criar o serviço de proxy (serviço de gerenciamento de API do Azure) no Portal

Modelo ARM:

Etapa 2: usar o modelo para criar o serviço remoto (Azure Function) e o serviço de proxy (Serviço de gerenciamento de API)

Informações requeridas¶

Você precisa das seguintes informações para criar a integração de API do Azure no Snowflake:

• Azure Function App AD Application ID (da sua planilha de rastreamento)

• ID de locatário do Azure AD (conforme descrito na seção Pré-requisitos para planejamento de uma função externa)

Criar o objeto de integração de API¶

Use o comando CREATE API INTEGRATION para criar o objeto de integração de API:

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

2. Execute o comando USE ROLE para usar a função ACCOUNTADMIN ou uma função com o privilégio CREATE INTEGRATION. Por exemplo:

   use role has_accountadmin_privileges;
   

   Copy

3. Insira uma instrução CREATE API INTEGRATION. A instrução deve ser semelhante ao seguinte:

   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

   Na instrução:

   1. Substitua <integration_name> por um nome de integração único (por exemplo, my_api_integration_name). O nome deve seguir as regras de Identificadores de objetos.

      Além disso, registre o nome da integração no campo API Integration Name da sua planilha de rastreamento. Você precisará do nome quando executar o comando CREATE EXTERNAL FUNCTION posteriormente no processo de criação.

   2. Substitua <tenant_id> por seu ID de locatário do Azure AD.

      Como alternativa, você pode usar seu domínio (por exemplo, my_company.onmicrosoft.com).

   3. Substitua <azure_application_id> pelo valor do campo Azure Function App AD Application ID da planilha de rastreamento.

   4. Para api_allowed_prefixes, substitua <url> pela URL apropriada.

      Normalmente, é a URL do serviço de proxy (ou seja, Serviço de gerenciamento de API do Azure), no seguinte formato:

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

      Copy

      Entretanto, você pode restringir as URLs às quais essa integração de API pode ser aplicada, anexando um sufixo apropriado, caso em que a URL tem o seguinte formato:

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

      Copy

      A URL que você insere depende de você estar usando o Portal do Azure ou o modelo ARM para criar sua função externa:

      Portal do Azure:

      Use os valores dos campos API Management service name e API Management API URL suffix da sua planilha de rastreamento. Por exemplo, sua URL deve ser parecida com:

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

      Copy

      Isso deve corresponder à URL base e ao sufixo da guia Settings do Serviço de gerenciamento de API para sua API importada. Se for conveniente, você pode copiar o valor da guia.

      Modelo ARM:

      Use o valor do campo API Management URL da sua planilha de rastreamento.

4. Execute a instrução CREATE API INTEGRATION que você inseriu se ainda não tiver feito isso.

Próxima etapa¶

Etapa 4: vincular a integração de API do Azure ao serviço de proxy no Portal