From 44324b20162f93eb0c8be4218c740ac4d8658f67 Mon Sep 17 00:00:00 2001 From: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> Date: Mon, 1 Apr 2024 16:21:50 -0600 Subject: [PATCH 1/6] Fix heading and links for `loaded_at_field` --- .../docs/reference/resource-properties/freshness.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/website/docs/reference/resource-properties/freshness.md b/website/docs/reference/resource-properties/freshness.md index 4db726e5581..0fd97e29ccf 100644 --- a/website/docs/reference/resource-properties/freshness.md +++ b/website/docs/reference/resource-properties/freshness.md @@ -62,8 +62,6 @@ To exclude a source from freshness calculations, you have two options: - Don't add a `freshness:` block. - Explicitly set `freshness: null`. -## loaded_at_field -(Optional on adapters that support pulling freshness from warehouse metadata tables, required otherwise.) @@ -75,10 +73,18 @@ Freshness blocks are applied hierarchically: - A `freshness` and `loaded_at_field` property added to a source _table_ will override any properties applied to the source. This is useful when all of the tables in a source have the same `loaded_at_field`, as is often the case. + ## loaded_at_field + + +(Optional on adapters that support pulling freshness from warehouse metadata tables, required otherwise.) + + + (Required) + A column name (or expression) that returns a timestamp indicating freshness. If using a date field, you may have to cast it to a timestamp: From 4700945b7ffd394d68f75bfbd74272b5f02a7e05 Mon Sep 17 00:00:00 2001 From: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> Date: Mon, 1 Apr 2024 16:48:08 -0600 Subject: [PATCH 2/6] Try to remove newline --- website/docs/reference/resource-properties/freshness.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/reference/resource-properties/freshness.md b/website/docs/reference/resource-properties/freshness.md index 0fd97e29ccf..9d92b7b9608 100644 --- a/website/docs/reference/resource-properties/freshness.md +++ b/website/docs/reference/resource-properties/freshness.md @@ -86,7 +86,6 @@ This is useful when all of the tables in a source have the same `loaded_at_field A column name (or expression) that returns a timestamp indicating freshness. - If using a date field, you may have to cast it to a timestamp: ```yml loaded_at_field: "completed_date::timestamp" From 4afea6672076f4ad3956bb49326e336ef147901d Mon Sep 17 00:00:00 2001 From: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> Date: Mon, 1 Apr 2024 17:20:05 -0600 Subject: [PATCH 3/6] Try to restore previous spacing between lines --- website/docs/reference/resource-properties/freshness.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/resource-properties/freshness.md b/website/docs/reference/resource-properties/freshness.md index 9d92b7b9608..e4b021955d6 100644 --- a/website/docs/reference/resource-properties/freshness.md +++ b/website/docs/reference/resource-properties/freshness.md @@ -85,7 +85,7 @@ This is useful when all of the tables in a source have the same `loaded_at_field (Required) -A column name (or expression) that returns a timestamp indicating freshness. +
A column name (or expression) that returns a timestamp indicating freshness.
If using a date field, you may have to cast it to a timestamp: ```yml loaded_at_field: "completed_date::timestamp" From 93b89d77a7ba9354dacdba8f920b804c56f93449 Mon Sep 17 00:00:00 2001 From: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> Date: Mon, 1 Apr 2024 17:35:15 -0600 Subject: [PATCH 4/6] Try adding one more line break --- website/docs/reference/resource-properties/freshness.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/resource-properties/freshness.md b/website/docs/reference/resource-properties/freshness.md index e4b021955d6..eac15618b2c 100644 --- a/website/docs/reference/resource-properties/freshness.md +++ b/website/docs/reference/resource-properties/freshness.md @@ -85,7 +85,7 @@ This is useful when all of the tables in a source have the same `loaded_at_field (Required) -
A column name (or expression) that returns a timestamp indicating freshness.
+

A column name (or expression) that returns a timestamp indicating freshness.
If using a date field, you may have to cast it to a timestamp: ```yml loaded_at_field: "completed_date::timestamp" From 92162f21bcd74c232f04f5e82b21df7f85e04b21 Mon Sep 17 00:00:00 2001 From: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> Date: Mon, 1 Apr 2024 19:19:47 -0600 Subject: [PATCH 5/6] Try to fix formatting --- website/docs/reference/resource-properties/freshness.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/resource-properties/freshness.md b/website/docs/reference/resource-properties/freshness.md index eac15618b2c..b31897cf54c 100644 --- a/website/docs/reference/resource-properties/freshness.md +++ b/website/docs/reference/resource-properties/freshness.md @@ -85,7 +85,7 @@ This is useful when all of the tables in a source have the same `loaded_at_field (Required) -

A column name (or expression) that returns a timestamp indicating freshness.
+

A column name (or expression) that returns a timestamp indicating freshness. If using a date field, you may have to cast it to a timestamp: ```yml loaded_at_field: "completed_date::timestamp" From a805ef8cbd485cbf3d42ba4afa20ad49775ad675 Mon Sep 17 00:00:00 2001 From: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> Date: Mon, 1 Apr 2024 19:41:18 -0600 Subject: [PATCH 6/6] Try to fix formatting --- website/docs/reference/resource-properties/freshness.md | 1 + 1 file changed, 1 insertion(+) diff --git a/website/docs/reference/resource-properties/freshness.md b/website/docs/reference/resource-properties/freshness.md index b31897cf54c..03037e7b681 100644 --- a/website/docs/reference/resource-properties/freshness.md +++ b/website/docs/reference/resource-properties/freshness.md @@ -86,6 +86,7 @@ This is useful when all of the tables in a source have the same `loaded_at_field

A column name (or expression) that returns a timestamp indicating freshness. + If using a date field, you may have to cast it to a timestamp: ```yml loaded_at_field: "completed_date::timestamp"