Skip to content

Commit

Permalink
Use the full configuration name (loaded_at_field) (#5186)
Browse files Browse the repository at this point in the history
[Preview](https://docs-getdbt-com-git-dbeatty10-patch-1-dbt-labs.vercel.app/docs/core/connect-data-platform/about-core-connections)

## What are you changing in this pull request and why?

The property is named
[`loaded_at_field`](https://docs.getdbt.com/reference/resource-properties/freshness#complete-example)
rather than `loaded_at`.

## Checklist
- [x] Review the [Content style
guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md)
so my content adheres to these guidelines.
- [x] I have confirmed the code example works by trying it out

---------

Co-authored-by: Mirna Wong <[email protected]>
  • Loading branch information
dbeatty10 and mirnawong1 authored Apr 1, 2024
1 parent ddca320 commit 82827af
Showing 1 changed file with 9 additions and 9 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -39,20 +39,20 @@ The following table lists the features available for adapters:

| Adapter | Catalog | Source freshness |
|---------|---------|------------------|
| dbt default configuration | full | `loaded_at` field |
| `dbt-bigquery` | partial and full | metadata-based and `loaded_at` field |
| `dbt-databricks` | full | metadata-based and `loaded_at` field |
| `dbt-postgres` | partial and full | `loaded_at` field |
| `dbt-redshift` | partial and full | metadata-based and `loaded_at` field |
| `dbt-snowflake` | partial and full | metadata-based and `loaded_at` field |
| `dbt-spark` | full | `loaded_at` field |
| dbt default configuration | full | `loaded_at_field` |
| `dbt-bigquery` | partial and full | metadata-based and `loaded_at_field` |
| `dbt-databricks` | full | metadata-based and `loaded_at_field` |
| `dbt-postgres` | partial and full | `loaded_at_field` |
| `dbt-redshift` | partial and full | metadata-based and `loaded_at_field` |
| `dbt-snowflake` | partial and full | metadata-based and `loaded_at_field` |
| `dbt-spark` | full | `loaded_at_field` |


### Catalog

For adapters that support it, you can partially build the catalog. This allows the catalog to be built for only a select number of models via `dbt docs generate --select ...`. For adapters that don't support partial catalog generation, you must run `dbt docs generate` to build the full catalog.

### Source freshness
You can measure source freshness using the warehouse metadata tables on supported adapters. This allows for calculating source freshness without using the `loaded_at` field and without querying the table directly. This is faster and more flexible (though it might sometimes be inaccurate, depending on how the warehouse tracks altered tables). You can override this with the `loaded_at` field in the model config. If the adapter doesn't support this, you can still use the `loaded_at` field.
You can measure source freshness using the warehouse metadata tables on supported adapters. This allows for calculating source freshness without using the [`loaded_at_field`](/reference/resource-properties/freshness#loaded_at_field) and without querying the table directly. This is faster and more flexible (though it might sometimes be inaccurate, depending on how the warehouse tracks altered tables). You can override this with the `loaded_at_field` in the model config. If the adapter doesn't support this, you can still use the `loaded_at_field`.

</VersionBlock>
</VersionBlock>

0 comments on commit 82827af

Please sign in to comment.