sql,eventpb: log structured event for REFRESH MATERIALIZED VIEW

Release note (ops change): A structured event is now logged in the
SQL_SCHEMA channgel when the REFRESH MATERIALIZED VIEW statement is
executed.

Author: rafiss

docs/generated/eventlog.md

@@ -1871,6 +1871,29 @@ initiated schema change rollback has completed.
 | `DescriptorID` |  | no |
 
 
+#### Common fields
+
+| Field | Description | Sensitive |
+|--|--|--|
+| `Timestamp` | The timestamp of the event. Expressed as nanoseconds since the Unix epoch. | no |
+| `EventType` | The type of the event. | no |
+| `Statement` | A normalized copy of the SQL statement that triggered the event. The statement string contains a mix of sensitive and non-sensitive details (it is redactable). | partially |
+| `Tag` | The statement tag. This is separate from the statement string, since the statement string can contain sensitive information. The tag is guaranteed not to. | no |
+| `User` | The user account that triggered the event. The special usernames `root` and `node` are not considered sensitive. | depends |
+| `DescriptorID` | The primary object descriptor affected by the operation. Set to zero for operations that don't affect descriptors. | no |
+| `ApplicationName` | The application name for the session where the event was emitted. This is included in the event to ease filtering of logging output by application. | no |
+| `PlaceholderValues` | The mapping of SQL placeholders to their values, for prepared statements. | yes |
+
+### `refresh_materialized_view`
+
+An event of type `refresh_materialized_view` is recorded when a materialized view is refreshed.
+
+
+| Field | Description | Sensitive |
+|--|--|--|
+| `ViewName` | The name of the materialized view being refreshed. | no |
+
+
 #### Common fields
 
 | Field | Description | Sensitive |

pkg/sql/refresh_materialized_view.go

@@ -15,6 +15,7 @@ import (
 	"github.com/cockroachdb/cockroach/pkg/sql/pgwire/pgnotice"
 	"github.com/cockroachdb/cockroach/pkg/sql/sem/tree"
 	"github.com/cockroachdb/cockroach/pkg/sql/sqltelemetry"
+	"github.com/cockroachdb/cockroach/pkg/util/log/eventpb"
 )
 
 type refreshMaterializedViewNode struct {
@@ -120,6 +121,15 @@ func (n *refreshMaterializedViewNode) startExec(params runParams) error {
 	}
 	desc.AddMaterializedViewRefreshMutation(refreshProto)
 
+	// Log the refresh materialized view event.
+	if err := params.p.logEvent(params.ctx,
+		desc.ID,
+		&eventpb.RefreshMaterializedView{
+			ViewName: params.p.ResolvedName(n.n.Name).FQString(),
+		}); err != nil {
+		return err
+	}
+
 	return params.p.writeSchemaChange(
 		params.ctx,
 		desc,

pkg/util/log/eventpb/ddl_events.proto

@@ -643,3 +643,11 @@ message DropPolicy {
   string policy_name = 4  [(gogoproto.jsontag) = ",omitempty", (gogoproto.moretags) = "redact:\"nonsensitive\""];
 }
 
+// RefreshMaterializedView is recorded when a materialized view is refreshed.
+message RefreshMaterializedView {
+  CommonEventDetails common = 1 [(gogoproto.nullable) = false, (gogoproto.jsontag) = "", (gogoproto.embed) = true];
+  CommonSQLEventDetails sql = 2 [(gogoproto.nullable) = false, (gogoproto.jsontag) = "", (gogoproto.embed) = true];
+  // The name of the materialized view being refreshed.
+  string view_name = 3 [(gogoproto.jsontag) = ",omitempty", (gogoproto.moretags) = "redact:\"nonsensitive\""];
+}
+