Skip to main content

Simplest way to run dbt python models.

Project description

Welcome to dbt-fal 👋

dbt-fal adapter is the ✨easiest✨ way to run your dbt Python models.

Starting with dbt v1.3, you can now build your dbt models in Python. This leads to some cool use cases that was once difficult to build with SQL alone. Some examples are:

  • Using Python stats libraries to calculate stats
  • Building forecasts
  • Building other predictive models such as classification and clustering

This is fantastic! BUT, there is still one issue though! The developer experience with Snowflake and Bigquery is not great, and there is no Python support for Redshift and Postgres.

dbt-fal provides the best environment to run your Python models that works with all other data warehouses! With dbt-fal, you can:

  • Build and test your models locally
  • Isolate each model to run in its own environment with its own dependencies
  • [Coming Soon] Run your Python models in the ☁️ cloud ☁️ with elasticly scaling Python environments.
  • [Coming Soon] Even add GPUs to your models for some heavier workloads such as training ML models.

Getting Started

1. Install dbt-fal

pip install dbt-fal[bigquery, snowflake] Add your current warehouse here

2. Update your profiles.yml and add the fal adapter

jaffle_shop:
  target: dev_with_fal
  outputs:
    dev_with_fal:
      type: fal
      db_profile: dev_bigquery # This points to your main adapter
    dev_bigquery:
      type: bigquery
      ...

Don't forget to point to your main adapter with the db_profile attribute. This is how the fal adapter knows how to connect to your data warehouse.

3. dbt run!

That is it! It is really that simple 😊

4. [🚨 Cool Feature Alert 🚨] Environment management with dbt-fal

If you want some help with environment management (vs sticking to the default env that the dbt process runs in), you can create a fal_project.yml in the same folder as your dbt project and have “named environments”:

In your dbt project folder:

$ touch fal_project.yml

# Paste the config below
environments:
  - name: ml
    type: venv
    requirements:
      - prophet

and then in your dbt model:

$ vi models/orders_forecast.py

def model(dbt, fal):
    dbt.config(fal_environment="ml") # Add this line

    df: pd.DataFrame = dbt.ref("orders_daily")

The dbt.config(fal_environment=“ml”) will give you an isolated clean env to run things in, so you dont pollute your package space.

5. [Coming Soon™️] Move your compute to the Cloud!

Let us know if you are interested in this. We are looking for beta users.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dbt-fal-1.3.10.tar.gz (34.8 kB view details)

Uploaded Source

Built Distribution

dbt_fal-1.3.10-py3-none-any.whl (46.1 kB view details)

Uploaded Python 3

File details

Details for the file dbt-fal-1.3.10.tar.gz.

File metadata

  • Download URL: dbt-fal-1.3.10.tar.gz
  • Upload date:
  • Size: 34.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.8.15 Linux/5.15.0-1024-azure

File hashes

Hashes for dbt-fal-1.3.10.tar.gz
Algorithm Hash digest
SHA256 da301fb05e7c7630551b3a3022058ef073da9ec68c360cca653d3fc85fc637e5
MD5 9195fd709ac73c676629f15ff1fe874b
BLAKE2b-256 910a9d48b3b6dddac79d810cae8e2fbda04313ffd556767eeccf45a5225a31f7

See more details on using hashes here.

File details

Details for the file dbt_fal-1.3.10-py3-none-any.whl.

File metadata

  • Download URL: dbt_fal-1.3.10-py3-none-any.whl
  • Upload date:
  • Size: 46.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.8.15 Linux/5.15.0-1024-azure

File hashes

Hashes for dbt_fal-1.3.10-py3-none-any.whl
Algorithm Hash digest
SHA256 e4a1a949618ae796f33ab64c15107fa3ac09d36976705c46863c9cc4683fe472
MD5 a1a81bd15595a7fc53f60823bdd9b591
BLAKE2b-256 d2dedb7b0f1f6631cefde29f5f65f175ee176d4adfa104f81364fb3859b04053

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page