Etapa 1: usar o modelo para criar o serviço remoto (função AWS Lambda) e o serviço de proxy (gateway de API)

Este tópico fornece instruções detalhadas para usar o modelo AWS CloudFormation fornecido pelo Snowflake. O modelo simplifica as tarefas para criar a função AWS Lambda (para usar como serviço remoto) e o Amazon API Gateway (para usar como serviço de proxy) para sua função externa.

Este documento mostra como criar uma função externa de amostra na AWS, usando um modelo CloudFormation.

O Snowflake fornece um modelo com o qual você pode começar. Esse modelo oculta alguns detalhes do processo de criação e codifica alguns nomes (por exemplo, o nome do estágio) e funcionalidade. Quando você estiver pronto para criar sua própria função externa personalizada, você pode personalizar uma cópia do modelo ou seguir as instruções mais flexíveis em Criação de funções externas em AWS.

Se você quiser personalizar o modelo, pode ler mais sobre AWS CloudFormation .

Nota

Essas instruções consideram que você tem familiaridade com a administração da AWS. Estas instruções descrevem as etapas gerais que você precisa executar, mas não descrevem a interface do usuário em detalhes porque a interface pode mudar.

Neste tópico:

Etapa anterior

Planejamento de uma função externa para AWS

Carregar o modelo

  1. Acesse o Console de gerenciamento AWS.

  2. Na barra de busca superior, procure CloudFormation.

  3. Em Services, clique em CloudFormation.

  4. Clique em Create stack.

    Se você puder optar entre With new resources (standard) ou With existing resources (import resources), escolha With new resources (standard).

  5. Na página Create stack, em Prepare template, selecione Template is ready.

  6. Selecione Upload a template file.

  7. Selecione Choose file.

  8. Navegue até o diretório que contém sua cópia do modelo e, em seguida, selecione esse modelo.

  9. Clique em Next para chegar à página na qual você digita os nomes das funções etc.

    Nota

    O modelo usa nomes padrão para alguns recursos. Você pode mudar os nomes.

Configurar suas opções

O modelo contém valores padrão para a maioria dos campos. Entretanto, é necessário inserir alguns valores, por exemplo, se você quer um ponto de extremidade regional ou um ponto de extremidade privado.

  1. Digite um nome para a pilha.

  2. Digite o tipo de ponto de extremidade que você deseja usar: “REGIONAL” ou “PRIVATE”.

    Se você não tiver certeza de qual tipo usar, escolha “REGIONAL”.

    Se você escolher “PRIVATE”, atualize a ID de VPC (rotulada “sourceVpcId” no modelo). (Para instruções sobre como encontrar sua ID de VPC, consulte Planejamento de uma função externa para AWS).

    Para obter mais informações sobre pontos de extremidade, incluindo uma descrição dos diferentes tipos de ponto de extremidade, consulte pontos de extremidade AWS e Como escolher seu tipo de ponto de extremidade: ponto de extremidade regional vs. ponto de extremidade privado.

  3. Digite um nome para a função IAM do gateway de API (parâmetro apiGatewayIAMRoleName). Esta é a função assumida pelo Snowflake para autorizar com o gateway de API. Verifique se esta função já existe, pois o modelo tentará atualizar a função se ela existir.

    Registre o nome da função no campo da planilha de rastreamento intitulado New IAM Role Name.

  4. Digite um nome para a função Lambda Execution (parâmetro lambdaExecutionRoleName). Esta função é utilizada pelo serviço Lambda para adicionar registros CloudWatch. Verifique se esta função já existe, pois o modelo tentará atualizar a função se ela existir.

  5. Clique em Next.

    Esta página tem algumas opções avançadas para a implantação de modelos.

    1. Opcionalmente, defina opções avançadas, como a política de pilha. (Isso não é necessário ao criar a função de amostra usando o modelo fornecido pelo Snowflake. No entanto, se você usar a implementação baseada em modelos para funções que você personalizou, então você pode precisar personalizar as opções avançadas nesse momento).

    2. Clique em Next.

  6. Na página de revisão, desça até o final e aceite que o modelo CloudFormation pode criar recursos IAM com nomes personalizados. Isso é necessário porque o modelo cria duas funções IAM como parte da implantação.

  7. Clique em Create stack.

A implantação levará alguns segundos. Após a conclusão da implantação, você deve estar na guia Events para a pilha recém-criada. Os recursos criados serão listados na guia Resources.

Próxima etapa

Etapa 2: registrar a URL do Amazon API Gateway e o ARN da nova função IAM