Etapa 1: criar o serviço remoto (Azure Function) no Portal¶

Criar a função¶

Para realizar as tarefas descritas nesta seção, você deve estar na tela Function App do Portal do Azure. O nome do seu aplicativo Azure Functions deve estar exibido, normalmente perto do canto superior esquerdo da tela.

Para criar a função acionada por HTTP:

1. Na árvore de menus do lado esquerdo, procure a seção intitulada Functions. Nessa seção, clique no item rotulado Functions para adicionar uma função.

2. Clique no botão + Add.

3. Selecione HTTP trigger da lista de possíveis acionadores à direita.

4. Digite o nome a ser usado para sua função acionada por HTTP.

   Registre esse nome no campo HTTP-Triggered Function name da sua planilha de rastreamento.

5. Digite o Authorization level.

   O Snowflake recomenda escolher Function como nível de autorização.

   Para obter mais informações sobre possíveis níveis de autorização, consulte a documentação da Microsoft: Funções acionadas por HTTP.

6. Clique no botão intitulado Add.

   Isto leva você a uma tela que mostra o nome da função e, abaixo dela, a palavra Function.

7. Na árvore de menus no lado esquerdo, clique em Code + Test.

8. Substitua o código padrão pelo seu próprio código.

   Uma amostra de código para uma função “echo” JavaScript é fornecida abaixo.

   A função lê cada linha, depois copia a linha para a saída (resultados). O número da linha também está incluído na saída. A saída é retornada como parte de um dicionário multinível.

   Essa função aceita e retorna dados no mesmo formato (JSON) que o Snowflake envia e lê. Para obter mais detalhes sobre formatos de dados, consulte Formatos de dados de entrada e saída do serviço remoto .

   Normalmente, a função retorna o código 200 HTTP. Se nenhuma linha for passada para a função (isto é, se o corpo da solicitação estiver vazio), a função retorna o código de erro 400.

   module.exports = async function(context, request) {
       context.log('JavaScript HTTP trigger function processed a request.');
   
       if (request.body) {
           var rows = request.body.data;
           var results = [];
           rows.forEach(row => {
               results.push([row[0], row]);
           });
   
           results = {data: results}
           context.res = {
               status: 200,
               body: JSON.stringify(results)
           };
      }
      else {
          context.res = {
              status: 400,
              body: "Please pass data in the request body."
          };
      }
   };
   

   Copy

9. Clique no botão Save acima do código.

Testar a função¶

Para testar o Azure Function acionada por HTTP que você acabou de criar, cole os seguintes dados de amostra no campo Body e clique no botão Test/Run:

{
    "data": [ [ 0, 43, "page" ], [ 1, 42, "life, the universe, and everything" ] ]
}

Copy

O conteúdo de saída deve ser semelhante ao seguinte:

{ "data":
    [
        [ 0, [ 0, 43, "page" ] ],
        [ 1, [ 1, 42, "life, the universe, and everything" ]  ]
    ]
}

Copy

Observe que a formatação pode ser diferente do que é mostrado acima.

Habilitação da autenticação de serviços de aplicativos para o aplicativo Azure Functions¶

Antes de executar as etapas abaixo, você deve estar na tela Function App para seu aplicativo Azure Functions.

1. No painel de menu à esquerda, procure a seção chamada Settings e clique em Authentication.

   Se a margem esquerda mostrar o menu Developer (com Code + Test, Integration etc.) e se você tiver uma barra de rolagem na parte inferior de sua tela, tente deslizar a barra de rolagem para a esquerda para retornar à seção Function App ou App Service, e depois procure por Settings.

2. Clique no botão Add identity provider.

3. No menu suspenso Identity provider, selecione Microsoft.

4. Para App registration type, selecione Create new app registration.

5. No campo Name, digite o nome do seu aplicativo.

6. Para Supported account types, selecione Current tenant - Single tenant.

7. Para Restrict access, selecione Require authentication.

8. Para Unauthenticated requests, selecione HTTP 401 Unauthorized.

9. Clique em Next: Permissions. Revise as permissões.

10. Clique em Add. É criado um novo aplicativo Azure AD e é exibida a página do aplicativo.

11. Clique no link que mostra o nome do seu aplicativo para acessar a página do seu aplicativo Azure AD.

12. Encontre o campo Application (client) ID.

    Registre essa ID no campo Azure Function App AD Application ID da sua planilha de rastreamento.

    Importante

    Certifique-se de copiar o ID, não o nome do aplicativo Azure AD. O ID deve conter um UUID.