PLAT-1484 Add New Resource For Alter Role

[bmedlock-depop]

This change will add in a new resource to the provider, ALTER_ROLE.

The resource is designed to be used where you need to alter certain attributes on a role globally and not just on a specific database.

Also included are tests for the resource and updating of the docs for the provider.

There are no outputs associated with this resource, but it can certainly be tied into the create role resource that exists already within the provider. postgresql_role TF Doc

Upstream PR: cyrilgdn#211

Example SQL Commands

Here we have examples of the kind of 'ALTER ROLE' commands that it is running in the background. Showing the type of commands that you would use this resource to automate.

YES 👍

ALTER ROLE test_role SET pgaudit.log TO 'ALL';

NO 👎

ALTER ROLE test_role IN DATABASE test SET pgaudit.log TO 'ALL';

ALTER ROLE test_role WITH PASSWORD NULL;

Example syntax

General Syntax

resource "postgresql_alter_role" "set_pgaudit_logging" {
  role            = "test_role"
  parameter_key   = "pgaudit.log"
  parameter_value = "ALL"
}

General syntax with role creation referenced

resource "postgresql_role" "pgaudit_role" {
  name = "test_pgaudit_role"
}

resource "postgresql_alter_role" "set_pgaudit_logging" {
  role                      = postgresql_role.pgaudit_role.name
  parameter_key    = "pgaudit.log"
  parameter_value = "ALL"
}