Etapa 5: criar a função externa para a AWS no Snowflake

Este tópico fornece instruções para a criação de um objeto de função externa no Snowflake. Esse objeto armazena informações sobre o serviço remoto, como os parâmetros que o serviço remoto aceita. As instruções são as mesmas independentemente de você estar usando o Console de gerenciamento AWS ou o modelo AWSCloudFormation.

Nota

As funções externas no Snowflake são objetos de banco de dados, o que significa que devem ser criadas em um esquema em um banco de dados. Para criar uma função externa, você deve ter os privilégios apropriados no banco de dados e no esquema onde você está criando a função.

Para obter mais detalhes, consulte Privilégios de controle de acesso.

Neste tópico:

Criar a função externa

Retorne à interface da Web do Snowflake (onde você digitou anteriormente o comando CREATE API INTEGRATION).

  1. Digite o comando CREATE EXTERNAL FUNCTION. Deve ser semelhante ao seguinte:

    CREATE EXTERNAL FUNCTION my_external_function(n INTEGER, v VARCHAR)
        RETURNS VARIANT
        API_INTEGRATION = <api_integration_name>
        AS '<resource_invocation_url>';
    
    Copy

    Personalize o comando:

    • O valor <api_integration_name> deve conter o nome da integração de API que você criou anteriormente.

    • O valor <resource_invocation_url> deve ser a Resource Invocation URL que você registrou na planilha. Certifique-se de que essa URL inclui o nome do recurso do gateway de API, não apenas o nome do estágio.

    • Você também pode personalizar o nome da função.

    Este exemplo passa dois argumentos (um INTEGER e um VARCHAR) porque esses são os argumentos que a função Lambda espera. Quando você cria sua própria função Lambda, você deve passar os argumentos apropriados para sua função Lambda.

  2. Registre o nome da função externa no campo External Function Name da sua planilha de rastreamento.

  3. Se você ainda não executou o comando CREATE EXTERNAL FUNCTION que você digitou acima, execute-o agora.

Testar sua função externa

Agora você pode chamar sua função externa para verificar se ela funciona corretamente.

Para obter mais detalhes, consulte Chamada de uma função externa para AWS.

Próxima etapa

Nenhum. Se você conseguiu chamar a função, então você criou com sucesso uma função externa para a AWS.