Turbopuffer

Getting Started

In this guide, we will show you how to connect to Census and create your first sync.

1. Collect your turbopuffer credentials

Census needs the following information to create a turbopuffer connection:

• API Key - instructions to create one can be found here

2. Connect turbopuffer in Census

1. In Census, navigate to Destinations

2. Click the New Destination button

3. Select turbopuffer in the dropdown list

4. Enter your credentials including the region where you'd like us to find and store your Namespaces and click Connect

You're all set!

Supported Objects and Behaviors

turbopuffer stores data within Namespaces. Your existing Namespaces in turbopuffer can be used as objects to sync to from Census, and you can also create new Namespaces using Census.

Advanced Configuration

Update Mode

By default, Census will update existing records in turbopuffer using patch mode, meaning only the fields being synced by Census will be updated on existing records. However, turbopuffer does not accept updates to the Vector Values field in patch mode.

Alternatively, you can use replace mode to replace the entire existing record in turbopuffer. This will result in nullifying any fields on the record which are not synced to from Census.

You can read more about the different write options in the turbopuffer docs.

Distance Metric

The distance metric to create the new Namespace with, or the distance metric of the existing Namespace.

Syncing Vector Values

turbopuffer requires bringing your own vector embeddings via external embedding models. Census supports enriching your dataset with vector embeddings via Embedding Columns. Use OpenAI to generate vector embeddings for your dataset, then sync your Embedding Column to the turbopuffer Namespace Vector Values field.

Need help connecting to turbopuffer?

Contact us via [email protected] or start a conversation with us via the in-app chat.