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

Este tópico fornece instruções para a criação de um objeto de integração de API no Snowflake para trabalhar com seu serviço de proxy (ou seja, Serviço de gerenciamento de API do Azure). As instruções são as mesmas independentemente de você estar usando o Portal do Azure ou o modelo ARM.

Neste tópico:

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.