Skip to content

Commit 79e51a9

Browse files
committed
fix things
1 parent e370453 commit 79e51a9

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

docs/integrations/data-ingestion/clickpipes/postgres/source/publication-management.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -13,18 +13,18 @@ This guide covers best practices and considerations for managing PostgreSQL publ
1313

1414
You have two main approaches for managing publications with ClickPipes:
1515

16-
### Option 1: Automatic Publication Creation (Recommended for Simplicity) {#automatic-publication-creation}
16+
### Option 1: Automatic Publication Creation (Let ClickPipes Manage It) {#automatic-publication-creation}
1717

18-
If you **don't specify a publication** during ClickPipe creation, ClickPipes will automatically create a publication scoped to only the tables you select for replication.
18+
If you want ClickPipes to handle publication management and not worry about the intricacies of PostgreSQL publications, simply **don't specify a publication** during ClickPipe creation. ClickPipes will automatically create a publication scoped to only the tables you select for replication.
1919

2020
**Requirements:**
2121
- The ClickPipes user must have **table owner permissions** for all tables you want to replicate
22-
- This is the easiest approach for getting started
2322

2423
**Advantages:**
2524
- No manual publication management required
2625
- Publication is automatically scoped to only selected tables
27-
- No risk of billing for unwanted table data
26+
- Same cost-effective billing as table-specific publications (only pay for selected tables)
27+
- Easiest approach for getting started
2828

2929
**Disadvantages:**
3030
- Requires higher privileges (table owner permissions)
@@ -46,7 +46,7 @@ CREATE PUBLICATION clickpipes_publication FOR TABLE schema.table1, schema.table2
4646
- Fine-grained control over which tables are included
4747
- Only requires SELECT permissions on tables (not ownership)
4848
- Clear visibility into what data will be replicated
49-
- Optimal billing - only pay for data you actually need
49+
- Same cost-effective billing as automatic creation (only pay for selected tables)
5050

5151
**Disadvantages:**
5252
- Manual management required
@@ -122,21 +122,23 @@ SELECT * FROM pg_publication;
122122

123123
## Best Practices {#best-practices}
124124

125-
1. **Start with table-specific publications** for production workloads to maintain cost control and clarity
125+
1. **Choose either automatic creation or table-specific publications** for production workloads - both provide the same cost control, with automatic being easier and manual providing more control
126126

127-
2. **Use automatic creation for development/testing** when you want to get started quickly and don't mind granting higher privileges
127+
2. **Use automatic creation** when you want ClickPipes to handle publication management and don't mind granting table owner privileges
128128

129129
3. **Plan your table selection carefully** - adding/removing tables later requires publication changes
130130

131-
4. **Monitor your data usage** to ensure you're only paying for data you actually need
131+
4. **Avoid all-tables publications** unless you specifically need all tables - this is the only approach that increases costs
132132

133-
5. **Document your publication strategy** so team members understand the setup
133+
5. **Monitor your data usage** to ensure you're only paying for data you actually need
134+
135+
6. **Document your publication strategy** so team members understand the setup
134136

135137
## Billing Implications {#billing-implications}
136138

137139
- **Table-specific publications**: You pay only for data changes from explicitly listed tables
138-
- **All-tables publications**: You pay for data changes from all tables in the database, even if ClickPipes only processes a subset
139-
- **Automatic creation**: You pay only for data from selected tables (most cost-effective)
140+
- **Automatic creation**: You pay only for data changes from selected tables (same cost as table-specific)
141+
- **All-tables publications**: You pay for data changes from **all tables** in the database, even if ClickPipes only processes a subset - this is the costly approach to avoid
140142

141143
## Additional Resources {#additional-resources}
142144

0 commit comments

Comments
 (0)