feat: Add materialized view to the SDK (#2403)

Add materialized view to the SDK

Differences with the docs (I will add them on doc-discuss):
- set secure / comment cannot be used simultaneously
- the same with unset
- there are missing options compared to views, I did not check them yet,
will ask about them after checking (row access policy, masking column
policy, tags in alter; terse, start with, limit in show)
- comment on column possible (it is in regular view doc, but it is not
added in materialized view one; there is a test proving it works:
https://github.com/Snowflake-Labs/terraform-provider-snowflake/pull/2403/files#diff-7a8a3cc00d490b622d152a5bdf42e0915fff497c2eb4554f491dfaaaa3d51025R124)?

pkg/sdk/client.go

@@ -55,6 +55,7 @@ type Client struct {
 	Grants              Grants
 	ManagedAccounts     ManagedAccounts
 	MaskingPolicies     MaskingPolicies
+	MaterializedViews   MaterializedViews
 	NetworkPolicies     NetworkPolicies
 	Parameters          Parameters
 	PasswordPolicies    PasswordPolicies
@@ -202,6 +203,7 @@ func (c *Client) initialize() {
 	c.Grants = &grants{client: c}
 	c.ManagedAccounts = &managedAccounts{client: c}
 	c.MaskingPolicies = &maskingPolicies{client: c}
+	c.MaterializedViews = &materializedViews{client: c}
 	c.NetworkPolicies = &networkPolicies{client: c}
 	c.Parameters = &parameters{client: c}
 	c.PasswordPolicies = &passwordPolicies{client: c}

pkg/sdk/materialized_views_def.go

@@ -0,0 +1,189 @@
+package sdk
+
+import g "github.com/Snowflake-Labs/terraform-provider-snowflake/pkg/sdk/poc/generator"
+
+//go:generate go run ./poc/main.go
+
+var materializedViewColumn = g.NewQueryStruct("MaterializedViewColumn").
+	Text("Name", g.KeywordOptions().DoubleQuotes().Required()).
+	OptionalTextAssignment("COMMENT", g.ParameterOptions().SingleQuotes().NoEquals())
+
+var materializedViewColumnMaskingPolicy = g.NewQueryStruct("MaterializedViewColumnMaskingPolicy").
+	Text("Name", g.KeywordOptions().Required()).
+	Identifier("MaskingPolicy", g.KindOfT[SchemaObjectIdentifier](), g.IdentifierOptions().SQL("MASKING POLICY").Required()).
+	NamedListWithParens("USING", g.KindOfT[string](), nil). // TODO: double quotes here?
+	OptionalTags()
+
+var materializedViewRowAccessPolicy = g.NewQueryStruct("MaterializedViewRowAccessPolicy").
+	Identifier("RowAccessPolicy", g.KindOfT[SchemaObjectIdentifier](), g.IdentifierOptions().SQL("ROW ACCESS POLICY").Required()).
+	NamedListWithParens("ON", g.KindOfT[string](), g.KeywordOptions().Required()). // TODO: double quotes here?
+	WithValidation(g.ValidIdentifier, "RowAccessPolicy").
+	WithValidation(g.ValidateValueSet, "On")
+
+var materializedViewClusterByExpression = g.NewQueryStruct("MaterializedViewClusterByExpression").
+	Text("Name", g.KeywordOptions().DoubleQuotes().Required())
+
+var materializedViewClusterBy = g.NewQueryStruct("MaterializedViewClusterBy").
+	SQL("CLUSTER BY").
+	ListQueryStructField("Expressions", materializedViewClusterByExpression, g.ListOptions().Parentheses()).
+	WithValidation(g.ValidateValueSet, "Expressions")
+
+var materializedViewSet = g.NewQueryStruct("MaterializedViewSet").
+	OptionalSQL("SECURE").
+	OptionalComment().
+	WithValidation(g.ExactlyOneValueSet, "Secure", "Comment")
+
+var materializedViewUnset = g.NewQueryStruct("MaterializedViewUnset").
+	OptionalSQL("SECURE").
+	OptionalSQL("COMMENT").
+	WithValidation(g.ExactlyOneValueSet, "Secure", "Comment")
+
+var materializedViewDbRow = g.DbStruct("materializedViewDBRow").
+	Text("created_on").
+	Text("name").
+	OptionalText("reserved").
+	Text("database_name").
+	Text("schema_name").
+	OptionalText("cluster_by").
+	Number("rows").
+	Number("bytes").
+	Text("source_database_name").
+	Text("source_schema_name").
+	Text("source_table_name").
+	Time("refreshed_on").
+	Time("compacted_on").
+	Text("owner").
+	Bool("invalid").
+	OptionalText("invalid_reason").
+	Text("behind_by").
+	OptionalText("comment").
+	Text("text").
+	Bool("is_secure").
+	Text("automatic_clustering").
+	OptionalText("owner_role_type").
+	OptionalText("budget")
+
+var materializedView = g.PlainStruct("MaterializedView").
+	Text("CreatedOn").
+	Text("Name").
+	OptionalText("Reserved").
+	Text("DatabaseName").
+	Text("SchemaName").
+	Text("ClusterBy").
+	Number("Rows").
+	Number("Bytes").
+	Text("SourceDatabaseName").
+	Text("SourceSchemaName").
+	Text("SourceTableName").
+	Time("RefreshedOn").
+	Time("CompactedOn").
+	Text("Owner").
+	Bool("Invalid").
+	Text("InvalidReason").
+	Text("BehindBy").
+	Text("Comment").
+	Text("Text").
+	Bool("IsSecure").
+	Bool("AutomaticClustering").
+	Text("OwnerRoleType").
+	Text("Budget")
+
+var materializedViewDetailsDbRow = g.DbStruct("materializedViewDetailsRow").
+	Text("name").
+	Field("type", "DataType").
+	Text("kind").
+	Text("null").
+	OptionalText("default").
+	Text("primary key").
+	Text("unique key").
+	OptionalText("check").
+	OptionalText("expression").
+	OptionalText("comment")
+
+var materializedViewDetails = g.PlainStruct("MaterializedViewDetails").
+	Text("Name").
+	Field("Type", "DataType").
+	Text("Kind").
+	Bool("IsNullable").
+	OptionalText("Default").
+	Bool("IsPrimary").
+	Bool("IsUnique").
+	OptionalBool("Check").
+	OptionalText("Expression").
+	OptionalText("Comment")
+
+var MaterializedViewsDef = g.NewInterface(
+	"MaterializedViews",
+	"MaterializedView",
+	g.KindOfT[SchemaObjectIdentifier](),
+).
+	CreateOperation(
+		"https://docs.snowflake.com/en/sql-reference/sql/create-materialized-view",
+		g.NewQueryStruct("CreateMaterializedView").
+			Create().
+			OrReplace().
+			OptionalSQL("SECURE").
+			SQL("MATERIALIZED VIEW").
+			IfNotExists().
+			Name().
+			OptionalCopyGrants().
+			ListQueryStructField("Columns", materializedViewColumn, g.ListOptions().Parentheses()).
+			ListQueryStructField("ColumnsMaskingPolicies", materializedViewColumnMaskingPolicy, g.ListOptions().NoParentheses().NoEquals()).
+			OptionalTextAssignment("COMMENT", g.ParameterOptions().SingleQuotes()).
+			OptionalQueryStructField("RowAccessPolicy", materializedViewRowAccessPolicy, g.KeywordOptions()).
+			OptionalTags().
+			OptionalQueryStructField("ClusterBy", materializedViewClusterBy, g.KeywordOptions()).
+			SQL("AS").
+			Text("sql", g.KeywordOptions().NoQuotes().Required()).
+			WithValidation(g.ValidIdentifier, "name").
+			WithValidation(g.ConflictingFields, "OrReplace", "IfNotExists"),
+	).
+	AlterOperation(
+		"https://docs.snowflake.com/en/sql-reference/sql/alter-materialized-view",
+		g.NewQueryStruct("AlterMaterializedView").
+			Alter().
+			SQL("MATERIALIZED VIEW").
+			Name().
+			OptionalIdentifier("RenameTo", g.KindOfT[SchemaObjectIdentifier](), g.IdentifierOptions().SQL("RENAME TO")).
+			OptionalQueryStructField("ClusterBy", materializedViewClusterBy, g.KeywordOptions()).
+			OptionalSQL("DROP CLUSTERING KEY").
+			OptionalSQL("SUSPEND RECLUSTER").
+			OptionalSQL("RESUME RECLUSTER").
+			OptionalSQL("SUSPEND").
+			OptionalSQL("RESUME").
+			OptionalQueryStructField("Set", materializedViewSet, g.KeywordOptions().SQL("SET")).
+			OptionalQueryStructField("Unset", materializedViewUnset, g.KeywordOptions().SQL("UNSET")).
+			WithValidation(g.ValidIdentifier, "name").
+			WithValidation(g.ExactlyOneValueSet, "RenameTo", "ClusterBy", "DropClusteringKey", "SuspendRecluster", "ResumeRecluster", "Suspend", "Resume", "Set", "Unset"),
+	).
+	DropOperation(
+		"https://docs.snowflake.com/en/sql-reference/sql/drop-materialized-view",
+		g.NewQueryStruct("DropMaterializedView").
+			Drop().
+			SQL("MATERIALIZED VIEW").
+			IfExists().
+			Name().
+			WithValidation(g.ValidIdentifier, "name"),
+	).
+	ShowOperation(
+		"https://docs.snowflake.com/en/sql-reference/sql/show-materialized-views",
+		materializedViewDbRow,
+		materializedView,
+		g.NewQueryStruct("ShowMaterializedViews").
+			Show().
+			SQL("MATERIALIZED VIEWS").
+			OptionalLike().
+			OptionalIn(),
+	).
+	ShowByIdOperation().
+	DescribeOperation(
+		g.DescriptionMappingKindSlice,
+		"https://docs.snowflake.com/en/sql-reference/sql/desc-materialized-view",
+		materializedViewDetailsDbRow,
+		materializedViewDetails,
+		g.NewQueryStruct("DescribeMaterializedView").
+			Describe().
+			SQL("MATERIALIZED VIEW").
+			Name().
+			WithValidation(g.ValidIdentifier, "name"),
+	)