Sign inTry Free

Cloud Functions

On this page

Note

This is a Preview feature.

SingleStore Cloud Functions is a serverless, cloud-based service that allows users to run code without managing compute resources. It enables the execution of code such as SQL queries, Python scripts, and API calls in response to trigger actions. As a fully managed service, it eliminates the need to provision or manage servers. It allows users to run complex queries and perform ETL (Extract, Transform and Load) tasks without the need to manage dedicated compute resources.

Create and manage cloud functions using the Cloud Portal.

Publish Cloud Functions using the Cloud Portal

Create a Cloud Function

Cloud Functions can be created for shared notebooks only.Create a cloud function:

  1. Using Cloud Functions in the left navigation

    Publish a cloud function by navigating to Container Services > Cloud Functions, and select a shared notebook.

  2. Using Shared Notebooks

    1. Navigate to Editor > Shared.

    2. Select a shared notebook.

    3. Select Publish (on the top right).

      Select Publish on your shared notebook to publish a cloud function.

New Cloud Function

After selecting Publish, a new dialog box appears.

Select Cloud Function in Publish Settings dialog.

Publish Settings

Publish as

Select Cloud Function.

Name

Enter a name for the cloud function.

Description

Enter the cloud function description.

Notebook

Select a shared notebook to publish as a cloud function. The shared notebook is pre-selected when the cloud function is published through notebooks.

Deployment

Select the SingleStore deployment (workspace) the notebook will connect to.

Selecting a workspace allows connecting to the SingleStore databases referenced in the notebook natively. A cloud function can be published without a deployment attached to it.

Runtime

Select a runtime from the following:

  • Small

  • Medium

  • GPU-T4

Note

This field is in preview.

Region

Select a region.

Idle Timeout

Select an idle timeout.

Note

This field is in preview.

Select Next.

View the summary of the cloud function.

Select Publish to publish the notebook as a cloud function.

Manage an Existing Cloud Function

To view an existing cloud function, select Cloud Functions in the left navigation. Existing cloud functions can be managed by performing the following actions:

  • View

  • Update

  • Share

  • Delete

View an Existing Cloud Function

To view an existing cloud function, select the cloud function name under the Name column.

View the cloud function under the Name column

View the following details for each cloud function:

View the details of a cloud function

View the details of a cloud function on the right navigation pane. Following actions can be performed for a cloud function from this page:

  • Copy URL

  • View API Keys

  • View Live Logs

  • Share

  • Update

  • Delete

View API Keys

Refer to Aura App API Keys for related information.

View Live Logs

To view live logs of the selected cloud function, select View Live Logs from the ellipsis on the right side. A new window appears, where the Timestamp and the message in the Body column can be viewed. View the Log JSON by selecting the eye icon.

Update an Existing Cloud Function

To update an existing cloud function, select the ellipsis in the Actions column of the cloud function, and select Update.

Update the cloud function

A cloud function can also be updated from a shared notebook.

Select Update Cloud Function in the notebook in order to update the cloud function.

Select Update Cloud Function and select Update.

Share an Existing Cloud Function

To share an existing cloud function, select the ellipsis in the Actions column of the cloud function, and select Share.

Delete an Existing Cloud Function

To delete an existing cloud function, select the ellipsis in the Actions column of the cloud function, and select Delete.

Status of Cloud Functions

Status

Description

Initializing

The notebook is creating or updating the cloud function.

Active

The notebook is successfully published as a cloud function.

Failed

The cloud function is not configured correctly. View the notebook snapshot to debug the failure.

Error

An error unrelated to the notebook code prevented the cloud function from initializing. Refer to Troubleshoot Cloud Functions.

Troubleshoot Cloud Functions

automatically saves a snapshot of the notebook for each execution that fails. Navigate to Cloud Functions in the left navigation, select the cloud function, and download the snapshot associated with the failed cloud function to diagnose the error. The following table lists some common errors and their resolutions:

Error

Solution

Workspace Deleted

Update the cloud function and select a deployment.

Workspace Suspended

Resume the workspace, or create a new cloud function with a different deployment.

Database Detached

Reattach the database with the right permissions or create a new cloud function with a different database.

Notebook Deleted/Not Present

Create a new cloud function with a different notebook.

Internal Errors/Misc

Reach out to SingleStore Support or use the chat feature in the Cloud Portal.

Last modified: November 27, 2025

Was this article helpful?

On this page

Was this article helpful?

Verification instructions

Note: You must install cosign to verify the authenticity of the SingleStore file.

Use the following steps to verify the authenticity of singlestoredb-server, singlestoredb-toolbox, singlestoredb-studio, and singlestore-client SingleStore files that have been downloaded.

You may perform the following steps on any computer that can run cosign, such as the main deployment host of the cluster.

  1. (Optional) Run the following command to view the associated signature files.

    curl undefined

  2. Download the signature file from the SingleStore release server.

    • Option 1: Click the Download Signature button next to the SingleStore file.

    • Option 2: Copy and paste the following URL into the address bar of your browser and save the signature file.

    • Option 3: Run the following command to download the signature file.

      curl -O undefined

  3. After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

    echo -n undefined |
        cosign verify-blob --certificate-oidc-issuer https://oidc.eks.us-east-1.amazonaws.com/id/CCDCDBA1379A5596AB5B2E46DCA385BC \
          --certificate-identity https://kubernetes.io/namespaces/freya-production/serviceaccounts/job-worker \
          --bundle undefined \
          --new-bundle-format -
    Verified OK

Try Out This Notebook to See What’s Possible in SingleStore

Get access to other groundbreaking datasets and engage with our community for expert advice.

Sign UpLog In