Etapa 4: criar a função externa para o GCP 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.

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:

Etapa anterior

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

Criar o objeto de função externa

Essa tarefa pressupõe que você esteja na página Worksheets Guia Planilha na Classic Console:

  1. Insira uma instrução CREATE EXTERNAL FUNCTION. A instrução deve ser semelhante ao seguinte:

    create or replace external function <external_function_name>(<parameters>)
        returns variant
        api_integration = <api_integration_name>
        as '<function_url>';
    
    Copy
  2. Substitua <external_function_name> por um nome de função único (por exemplo, echo). Esse nome deve seguir as regras de Identificadores de objetos.

    Além disso, registre o nome da função no campo “External Function Name” da sua planilha de rastreamento.

  3. Substitua <parameters> pelos nomes e tipos de dados SQL dos parâmetros da função se houver. Por exemplo:

    a integer, b varchar
    
    Copy

    Os parâmetros devem corresponder aos parâmetros esperados pelo serviço remoto. Os nomes dos parâmetros não precisam corresponder, mas os tipos de dados precisam ser compatíveis.

    Além disso, registre os nomes dos parâmetros e tipos de dados no campo “External Function Name” da sua planilha de rastreamento.

  4. Substitua <api_integration_name> pelo valor do campo “API Integration Name” da sua planilha de rastreamento.

  1. Substitua <function_URL> pelos valores dos campos Gateway Base URL e Path Suffix, separados por uma barra (/).

    A URL deve ser semelhante a:

    https://<gateway-base-url>/<path-suffix>
    
    Copy
  2. Execute o comando CREATE EXTERNAL FUNCTION que você inseriu se ainda não tiver feito isso.

Testar sua função externa

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

Nota

Se você adicionou uma definição de segurança ao arquivo de configuração para proteger seu gateway em Etapa 2: criar o serviço de proxy (Google Cloud API Gateway) no console deste tutorial, não será possível testar sua função externa até que você atualize as definições de segurança no arquivo de configuração em Etapa 5: criar uma política de segurança do GCP para o serviço de proxy no console deste tutorial.

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

Próxima etapa

Etapa 5: criar uma política de segurança do GCP para o serviço de proxy no console