Skip to content

Documentation to Revert RTR back to MasterETL - #141

Draft
ericnagel wants to merge 6 commits into
mainfrom
en/rtr-revert-etl
Draft

Documentation to Revert RTR back to MasterETL#141
ericnagel wants to merge 6 commits into
mainfrom
en/rtr-revert-etl

Conversation

@ericnagel

Copy link
Copy Markdown

Instructions on rolling back to MasterETL after installing RTR.

Related: BRDG-7

@ericnagel
ericnagel marked this pull request as draft September 8, 2026 20:42
@ericnagel
ericnagel marked this pull request as ready for review September 8, 2026 20:45
@ericnagel
ericnagel marked this pull request as draft September 10, 2026 15:00
Comment on lines +18 to +19
Reverting does **not** require undeploying [[nbs-7]]. If you want to remove RTR and keep NBS 7 running,
this page is the whole procedure.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

undeploying -> uninstalling?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

docs/undeploy-nbs7.md is titled "Undeploy NBS 7" so I think this should remain "undeploying"

Comment on lines +419 to +435
### 2d. Disable CDC on NBS_SRTE

`NBS_SRTE` is reference data and RTR is its only known CDC consumer. Confirm that for your environment,
then disable the capture instances and the database-level flag:

```sql
USE NBS_SRTE;

-- Generate the per-table statements
SELECT 'EXEC sys.sp_cdc_disable_table @source_schema = N''' + s.name +
''', @source_name = N''' + t.name +
''', @capture_instance = N''' + ct.capture_instance + ''';' AS statement_to_run
FROM cdc.change_tables ct
JOIN sys.tables t ON t.object_id = ct.source_object_id
JOIN sys.schemas s ON s.schema_id = t.schema_id
ORDER BY t.name;
```

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could also provide a script that checks if CDC was enabled for any table other than what RTR requires. If so, that would indicate CDC was enabled for some other purpose on SRTE.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added a script that looks for CDC-enabled tables that are outside of the scope of RTR

Although what if:

  • Table already had CDC enabled
  • Bootstrap script specifies to enable it
  • We turn it off

That's bad. There's another method using timestamps, let me expand on this...

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Step 2 is ready to be reviewed again

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants