Step 4: Create the External Function for GCP in Snowflake

This topic provides instructions for creating an external function object in Snowflake. This object stores information about the remote service, such as the parameters that the remote service accepts.

Note

External functions in Snowflake are database objects, meaning they must be created in a schema in a database. To create an external function, you must have the appropriate privileges on the database and schema where you are creating the function.

For more details, see Access Control Privileges.

In this Topic:

Create the External Function Object

This task assumes you are in the Worksheets Worksheet tab page in the Snowflake web interface:

  1. Enter a CREATE EXTERNAL FUNCTION statement. The statement should look similar to the following:

    create or replace external function <external_function_name>(<parameters>)
        returns variant
        api_integration = <api_integration_name>
        as '<function_url>';
    
  2. Replace <external_function_name> with a unique function name (e.g. echo). This name must follow the rules for Object Identifiers.

    In addition, record the function name in the “External Function Name” field in your tracking worksheet.

  3. Replace <parameters> with the names and SQL data types of the parameters for the function, if any. For example:

    a integer, b varchar
    

    The parameters must correspond to the parameters expected by the remote service. The parameter names do not need to match, but the data types need to be compatible.

    In addition, record the parameter names and data types in the “External Function Name” field in your tracking worksheet.

  4. Replace <api_integration_name> with the value from the “API Integration Name” field in your tracking worksheet.

  5. Replace <function_URL> with the values from the “Gateway Base URL” and “Path Suffix” fields, separated by a forward slash (/).

    The URL should look similar to:

    https://<gateway-base-url>/<path-suffix>
    
  6. If you haven’t already, execute the CREATE EXTERNAL FUNCTION command that you entered.

Test Your External Function

You should now be able to call your external function to verify that it works correctly.

For details, see Calling an External Function for GCP.