Etapa 1: criar o serviço remoto (função AWS Lambda) no console de gerenciamento¶

Entrada e saída independente da linguagem via JSON¶

As informações desta seção se aplicam a todas as funções Lambda utilizadas como serviços remotos para funções externas do Snowflake. Para obter mais informações específicas de plataforma sobre entrada e saída de funções externas, consulte as subseções abaixo.

Na AWS, a convenção para um serviço compatível com HTTP é retornar o corpo dentro de um objeto JSON que também inclui o código de status HTTP. O JSON para um valor de retorno típico de uma função AWS Lambda é semelhante ao seguinte:

{
"statusCode": <http_status_code>,
"body":
        {
            "data":
                  [
                      [ 0, <value> ],
                      [ 1, <value> ]
                      ...
                  ]
        }
}

Copy

A estrutura da entrada JSON é semelhante à anterior, mas inclui pares chave-valor adicionais que você provavelmente não precisará, e exclui o statusCode.

Entrada da função Lambda específica para Python¶

O material a seguir se aplica às funções Lambda na linguagem Python compatíveis com o Snowflake, incluindo a amostra das funções Lambda neste tutorial. Estas informações são uma adição às regras independentes da linguagem para entrada e saída.

Uma função Lambda na linguagem Python compatível com o Snowflake recebe dois parâmetros, event e context. Funções externas simples normalmente precisam apenas do parâmetro event.

O parâmetro event inclui muitos subcampos, um dos quais é body. O corpo é uma cadeia de caracteres compatível com JSON que contém um dicionário.

O dicionário inclui uma chave chamada data; o valor correspondente para data é uma matriz. Essa matriz contém as linhas passadas pelo Snowflake.

Cada linha é representada por uma matriz que está aninhada dentro da matriz data.

(Como o AWS Lambda processa convenientemente a solicitação HTTP POST enviada pelo Snowflake, extrai o corpo e passa o corpo dentro do parâmetro de evento, as funções de exemplo fornecidas pelo Snowflake não precisam analisar a solicitação HTTP POST inteira).

O Amostra de função Lambda síncrona inclui um código que mostra como ler o parâmetro event.

Amostras de funções do Snowflake¶

O Snowflake fornece duas funções de amostra:

• O exemplo mais curto é síncrono. Se você é iniciante em funções externas ou funções Lambda, o Snowflake recomenda que você use o código para criar sua primeira amostra de função externa.

  Usuários experientes também podem copiá-lo e modificá-lo para usá-lo como ponto de partida para serviços remotos personalizados.

  O código está disponível em amostra de função Lambda síncrona.

• O outro exemplo é assíncrono.

  Esta amostra é destinada principalmente para a construção de serviços remotos assíncronos personalizados.

  O código está disponível em amostra de função Lambda assíncrona.

Função Lambda personalizada¶

Você pode escrever sua própria função Lambda do zero, ou pode usar uma das funções descritas em Amostras de funções do Snowflake (neste tópico) como um ponto de partida.

Se você tem um serviço remoto existente que deseja utilizar, então você pode pular a maioria das instruções nesta etapa do tutorial. Em vez disso, faça o seguinte:

1. Registre sua ID da conta AWS no campo Your AWS Account ID na planilha de rastreamento.

2. Registre o nome da função Lambda do serviço remoto no campo Lambda Function Name na planilha de rastreamento.

3. Vá para Etapa 2: criar o serviço de proxy (Amazon API Gateway) no console de gerenciamento da AWS.