Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

docs(pipelines): nest destination guides (#50708)

Danny White59e212283315
diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
index 52738309d49..737385a7989 100644
--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
@@ -1240,19 +1240,19 @@ export const database: NavMenuConstant = {
},
{
name: 'BigQuery',
- url: '/guides/database/replication/bigquery' as `/${string}`,
+ url: '/guides/database/replication/pipelines/bigquery' as `/${string}`,
},
{
name: 'ClickHouse',
- url: '/guides/database/replication/clickhouse' as `/${string}`,
+ url: '/guides/database/replication/pipelines/clickhouse' as `/${string}`,
},
{
name: 'DuckLake',
- url: '/guides/database/replication/ducklake' as `/${string}`,
+ url: '/guides/database/replication/pipelines/ducklake' as `/${string}`,
},
{
name: 'Snowflake',
- url: '/guides/database/replication/snowflake' as `/${string}`,
+ url: '/guides/database/replication/pipelines/snowflake' as `/${string}`,
},
{
name: 'Monitoring',
diff --git a/apps/docs/content/guides/database/replication.mdx b/apps/docs/content/guides/database/replication.mdx
index 7fda4e94c80..f4e2feddda2 100644
--- a/apps/docs/content/guides/database/replication.mdx
+++ b/apps/docs/content/guides/database/replication.mdx
@@ -34,12 +34,12 @@ See [Set up manual replication](/docs/guides/database/replication/manual-replica
## Supported destinations
-| Destination | Status |
-| ---------------------------------------------------------- | ------------- |
-| [BigQuery](/docs/guides/database/replication/bigquery) | Public alpha |
-| [ClickHouse](/docs/guides/database/replication/clickhouse) | Private alpha |
-| [DuckLake](/docs/guides/database/replication/ducklake) | Private alpha |
-| [Snowflake](/docs/guides/database/replication/snowflake) | Private alpha |
+| Destination | Status |
+| -------------------------------------------------------------------- | ------------- |
+| [BigQuery](/docs/guides/database/replication/pipelines/bigquery) | Public alpha |
+| [ClickHouse](/docs/guides/database/replication/pipelines/clickhouse) | Private alpha |
+| [DuckLake](/docs/guides/database/replication/pipelines/ducklake) | Private alpha |
+| [Snowflake](/docs/guides/database/replication/pipelines/snowflake) | Private alpha |
[Request access](/go/supabase-pipelines-new-destinations) to destinations in private alpha.
diff --git a/apps/docs/content/guides/database/replication/pipelines-faq.mdx b/apps/docs/content/guides/database/replication/pipelines-faq.mdx
index c723e019561..36db3c1432d 100644
--- a/apps/docs/content/guides/database/replication/pipelines-faq.mdx
+++ b/apps/docs/content/guides/database/replication/pipelines-faq.mdx
@@ -50,7 +50,7 @@ Support differs by destination. Check the [schema-change guides](/docs/guides/da
Yes. Pipelines provides at-least-once processing: recovery can replay acknowledged data, and consumers of append-only histories must tolerate repeated events. Destination deduplication does not provide an exactly-once processing guarantee.
-See the data models for [BigQuery](/docs/guides/database/replication/bigquery#how-it-works), [ClickHouse](/docs/guides/database/replication/clickhouse#choose-a-table-engine), [DuckLake](/docs/guides/database/replication/ducklake#how-replication-works), and [Snowflake](/docs/guides/database/replication/snowflake#append-only-change-history), and the [billing implications](/docs/guides/platform/manage-your-usage/pipelines#how-data-processed-is-measured).
+See the data models for [BigQuery](/docs/guides/database/replication/pipelines/bigquery#how-it-works), [ClickHouse](/docs/guides/database/replication/pipelines/clickhouse#choose-a-table-engine), [DuckLake](/docs/guides/database/replication/pipelines/ducklake#how-replication-works), and [Snowflake](/docs/guides/database/replication/pipelines/snowflake#append-only-change-history), and the [billing implications](/docs/guides/platform/manage-your-usage/pipelines#how-data-processed-is-measured).
## Why is a table not being replicated?
@@ -63,7 +63,7 @@ Check that:
If new changes arrive but existing rows are missing, check the [initial sync selection](/docs/guides/database/replication/pipelines#choosing-which-tables-to-copy). [Changing a row filter](/docs/guides/database/replication/pipelines#other-publication-changes) also does not copy newly included historical rows.
-If inserts work but updates or deletes fail, review the source table requirements for [BigQuery](/docs/guides/database/replication/bigquery#source-table-requirements), [ClickHouse](/docs/guides/database/replication/clickhouse#source-table-requirements), [DuckLake](/docs/guides/database/replication/ducklake#source-table-requirements), or [Snowflake](/docs/guides/database/replication/snowflake#source-table-requirements).
+If inserts work but updates or deletes fail, review the source table requirements for [BigQuery](/docs/guides/database/replication/pipelines/bigquery#source-table-requirements), [ClickHouse](/docs/guides/database/replication/pipelines/clickhouse#source-table-requirements), [DuckLake](/docs/guides/database/replication/pipelines/ducklake#source-table-requirements), or [Snowflake](/docs/guides/database/replication/pipelines/snowflake#source-table-requirements).
## Why is a table in error state?
diff --git a/apps/docs/content/guides/database/replication/pipelines.mdx b/apps/docs/content/guides/database/replication/pipelines.mdx
index 71390159c34..30ad25944b3 100644
--- a/apps/docs/content/guides/database/replication/pipelines.mdx
+++ b/apps/docs/content/guides/database/replication/pipelines.mdx
@@ -34,10 +34,10 @@ Prepare your destination, then enable and configure Pipelines in the Dashboard.
Follow your destination guide to prepare its resources and credentials, and check its source table requirements:
-- [BigQuery](/docs/guides/database/replication/bigquery)
-- [ClickHouse](/docs/guides/database/replication/clickhouse)
-- [DuckLake](/docs/guides/database/replication/ducklake)
-- [Snowflake](/docs/guides/database/replication/snowflake)
+- [BigQuery](/docs/guides/database/replication/pipelines/bigquery)
+- [ClickHouse](/docs/guides/database/replication/pipelines/clickhouse)
+- [DuckLake](/docs/guides/database/replication/pipelines/ducklake)
+- [Snowflake](/docs/guides/database/replication/pipelines/snowflake)
### Step 2: Enable Pipelines
@@ -331,7 +331,7 @@ Wait for initial sync to finish before changing its filter; changing a filter do
## Schema change support
-Pipelines applies supported changes to replicated columns as replication progresses. It does not mirror every Postgres DDL operation. Check the supported changes and destination behavior for [BigQuery](/docs/guides/database/replication/bigquery#schema-change-support), [ClickHouse](/docs/guides/database/replication/clickhouse#schema-change-support), [DuckLake](/docs/guides/database/replication/ducklake#schema-change-support), or [Snowflake](/docs/guides/database/replication/snowflake#schema-change-support) before altering replicated tables.
+Pipelines applies supported changes to replicated columns as replication progresses. It does not mirror every Postgres DDL operation. Check the supported changes and destination behavior for [BigQuery](/docs/guides/database/replication/pipelines/bigquery#schema-change-support), [ClickHouse](/docs/guides/database/replication/pipelines/clickhouse#schema-change-support), [DuckLake](/docs/guides/database/replication/pipelines/ducklake#schema-change-support), or [Snowflake](/docs/guides/database/replication/pipelines/snowflake#schema-change-support) before altering replicated tables.
Unsupported changes have different outcomes:
diff --git a/apps/docs/content/guides/database/replication/bigquery.mdx b/apps/docs/content/guides/database/replication/pipelines/bigquery.mdx
similarity index 100%
rename from apps/docs/content/guides/database/replication/bigquery.mdx
rename to apps/docs/content/guides/database/replication/pipelines/bigquery.mdx
diff --git a/apps/docs/content/guides/database/replication/clickhouse.mdx b/apps/docs/content/guides/database/replication/pipelines/clickhouse.mdx
similarity index 100%
rename from apps/docs/content/guides/database/replication/clickhouse.mdx
rename to apps/docs/content/guides/database/replication/pipelines/clickhouse.mdx
diff --git a/apps/docs/content/guides/database/replication/ducklake.mdx b/apps/docs/content/guides/database/replication/pipelines/ducklake.mdx
similarity index 100%
rename from apps/docs/content/guides/database/replication/ducklake.mdx
rename to apps/docs/content/guides/database/replication/pipelines/ducklake.mdx
diff --git a/apps/docs/content/guides/database/replication/snowflake.mdx b/apps/docs/content/guides/database/replication/pipelines/snowflake.mdx
similarity index 100%
rename from apps/docs/content/guides/database/replication/snowflake.mdx
rename to apps/docs/content/guides/database/replication/pipelines/snowflake.mdx
diff --git a/apps/docs/next.config.mjs b/apps/docs/next.config.mjs
index d416bea5b85..b0bdb647921 100644
--- a/apps/docs/next.config.mjs
+++ b/apps/docs/next.config.mjs
@@ -167,6 +167,26 @@ const nextConfig = {
},
// Redirect old managed pipeline slugs in dev/preview envs
+ {
+ source: '/guides/database/replication/bigquery',
+ destination: '/guides/database/replication/pipelines/bigquery',
+ permanent: true,
+ },
+ {
+ source: '/guides/database/replication/clickhouse',
+ destination: '/guides/database/replication/pipelines/clickhouse',
+ permanent: true,
+ },
+ {
+ source: '/guides/database/replication/ducklake',
+ destination: '/guides/database/replication/pipelines/ducklake',
+ permanent: true,
+ },
+ {
+ source: '/guides/database/replication/snowflake',
+ destination: '/guides/database/replication/pipelines/snowflake',
+ permanent: true,
+ },
{
source: '/guides/database/replication/external-replication-setup',
destination: '/guides/database/replication/pipelines',
diff --git a/apps/www/lib/redirects.js b/apps/www/lib/redirects.js
index 6e5f7ba0b36..c5f112d0bb5 100644
--- a/apps/www/lib/redirects.js
+++ b/apps/www/lib/redirects.js
@@ -2926,6 +2926,26 @@ module.exports = [
source: '/docs/guides/storage/analytics/replication',
destination: '/docs/guides/database/replication/pipelines',
},
+ {
+ permanent: true,
+ source: '/docs/guides/database/replication/bigquery',
+ destination: '/docs/guides/database/replication/pipelines/bigquery',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/database/replication/clickhouse',
+ destination: '/docs/guides/database/replication/pipelines/clickhouse',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/database/replication/ducklake',
+ destination: '/docs/guides/database/replication/pipelines/ducklake',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/database/replication/snowflake',
+ destination: '/docs/guides/database/replication/pipelines/snowflake',
+ },
{
permanent: true,
source: '/docs/guides/database/replication/external-replication-setup',