refactor!: final pass at adding pg commands from pg-extras plugin to cli PR 3 of 3

[jdodson]

Summary

We need to move the commands from the pg-extras plugin to the core CLI, which will require us to update the commands to use oclif/core v4 and heroku-cli-command v12.

This is PR 3 of 3 and final to accomplish this task and we will be merging these PRs in feature/migrate_pg_extras_to_cli

Commands migrated:

• pg:table-size
• pg:total-index-size
• pg:total-table-size
• pg:unused-indexes
• pg:user-connections
• pg:vacuum-stats

Type of Change

Breaking Changes (major semver update)

• Add a ! after your change type to denote a change that breaks current behavior

Feature Additions (minor semver update)

• feat: Introduces a new feature to the codebase

Patch Updates (patch semver update)

• fix: Bug fix
• deps: Dependency upgrade
• revert: Revert a previous commit
• chore: Change that does not affect production code
• refactor: Refactoring existing code without changing behavior
• test: Add/update/remove tests

Testing

The --help changes (should be limited to --prompt and GLOBAL FLAGS additions that came with cli upgrades) ALSO examples as the cli requires:

diff <(./bin/run pg:table-size --help) <(heroku pg:table-size --help)
diff <(./bin/run pg:total-index-size --help) <(heroku pg:total-index-size --help)
diff <(./bin/run pg:total-table-size --help) <(heroku pg:total-table-size --help)
diff <(./bin/run pg:unused-indexes --help) <(heroku pg:unused-indexes --help)
diff <(./bin/run pg:user-connections --help) <(heroku pg:user-connections --help)
diff <(./bin/run pg:vacuum-stats --help) <(heroku pg:vacuum-stats --help)

New Command Testing Steps:

1. Show the size of the tables excluding indexes (name | size for each table, descending by size, e.g. 50 MB)

./bin/run pg:table-size -a $APP

2. Confirm the underscore alias (visible) produces identical output to step 1

./bin/run pg:table_size -a $APP

3. Show the total size of all indexes in the database (single size row, e.g. 15 MB)

./bin/run pg:total-index-size -a $APP

4. Confirm the hidden underscore alias produces identical output to step 3

./bin/run pg:total_index_size -a $APP

5. Show the size of the tables including indexes (name | size for each table, descending by size, e.g. 75 MB; values should be >= the matching row from step 1)

./bin/run pg:total-table-size -a $APP

6. Confirm the underscore alias (visible) produces identical output to step 5

./bin/run pg:total_table_size -a $APP

7. Show unused and almost unused indexes (table | index | index_size | index_scans, ordered by size-to-scan ratio descending; excludes unique indexes and tables under ~40 kB; a small or well-used database may return no rows)

./bin/run pg:unused-indexes -a $APP

8. Confirm the underscore alias (visible) produces identical output to step 7

./bin/run pg:unused_indexes -a $APP

9. Show the number of active connections per credential (credential | connections, ordered by connections descending)

./bin/run pg:user-connections -a $APP

10. Confirm the hidden underscore alias produces identical output to step 9

./bin/run pg:user_connections -a $APP

11. Show dead rows and whether an automatic vacuum is expected (schema | table | last_vacuum | last_autovacuum | rowcount | dead_rowcount | autovacuum_threshold | expect_autovacuum; expect_autovacuum shows yes only when dead rows exceed the threshold. Note: this command has no underscore alias)

./bin/run pg:vacuum-stats -a $APP

Screenshots (if applicable)

Related Issues

GUS work item: https://gus.lightning.force.com/lightning/r/ADM_Work__c/a07EE00002YzlNjYAJ/view

[michaelmalave]

LGTM!