1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
/*!
 * A Struct for the materialized view metadata   
*/

use serde::{Deserialize, Serialize};

use super::{
    table_metadata::VersionNumber,
    view_metadata::{GeneralViewMetadata, GeneralViewMetadataBuilder, Representation},
};

/// Fields for the version 1 of the view metadata.
pub type MaterializedViewMetadata = GeneralViewMetadata<MaterializedViewRepresentation>;
/// Builder for materialized view metadata
pub type MaterializedViewMetadataBuilder =
    GeneralViewMetadataBuilder<MaterializedViewRepresentation>;

#[derive(Debug, Serialize, Deserialize, PartialEq, Eq, Clone)]
#[serde(rename_all = "kebab-case", tag = "type")]
/// Fields for the version 2 of the view metadata.
pub enum MaterializedViewRepresentation {
    #[serde(rename_all = "kebab-case")]
    /// This type of representation stores the original view definition in SQL and its SQL dialect.
    SqlMaterialized {
        /// A string representing the original view definition in SQL
        sql: String,
        /// A string specifying the dialect of the ‘sql’ field. It can be used by the engines to detect the SQL dialect.
        dialect: String,
        /// An integer version number for the materialized view format. Currently, this must be 1. Implementations must throw an exception if the materialized view's version is higher than the supported version.
        format_version: FormatVersion,
        /// Pointer to the storage table
        storage_table: String,
    },
}

#[derive(Debug, Serialize, Deserialize, PartialEq, Eq, Clone)]
#[serde(from = "FormatVersionSerde", into = "FormatVersionSerde")]
/// Format version of the materialized view
pub enum FormatVersion {
    /// Version 1
    V1,
}

#[derive(Debug, Serialize, Deserialize, PartialEq, Eq, Clone)]
#[serde(untagged)]
/// Format version of the materialized view
pub enum FormatVersionSerde {
    /// Version 1
    V1(VersionNumber<1>),
}

impl From<FormatVersion> for FormatVersionSerde {
    fn from(value: FormatVersion) -> Self {
        match value {
            FormatVersion::V1 => FormatVersionSerde::V1(VersionNumber::<1>),
        }
    }
}

impl From<FormatVersionSerde> for FormatVersion {
    fn from(value: FormatVersionSerde) -> Self {
        match value {
            FormatVersionSerde::V1(_) => FormatVersion::V1,
        }
    }
}

impl Representation for MaterializedViewRepresentation {}

/// Version id of the materialized view when the refresh operation was performed.
pub type VersionId = i64;
/// Map from references in the sql expression to snapshot_ids of the last refresh operation
pub type BaseTables = Vec<BaseTable>;

#[derive(Debug, Serialize, Deserialize, PartialEq, Eq, Clone)]
#[serde(rename_all = "kebab-case")]
/// Freshness information of the materialized view
pub struct BaseTable {
    /// Table reference in the SQL expression.
    pub identifier: String,
    /// Snapshot id of the base table when the refresh operation was performed.
    pub snapshot_id: i64,
}

#[cfg(test)]
mod tests {

    use crate::{error::Error, spec::materialized_view_metadata::MaterializedViewMetadata};

    #[test]
    fn test_deserialize_materialized_view_metadata_v1() -> Result<(), Error> {
        let data = r#"
        {
        "view-uuid": "fa6506c3-7681-40c8-86dc-e36561f83385",
        "format-version" : 1,
        "location" : "s3://bucket/warehouse/default.db/event_agg",
        "current-version-id" : 1,
        "properties" : {
            "comment" : "Daily event counts"
        },
        "versions" : [ {
            "version-id" : 1,
            "timestamp-ms" : 1573518431292,
            "schema-id" : 1,
            "default-catalog" : "prod",
            "default-namespace" : [ "default" ],
            "summary" : {
            "operation" : "create",
            "engine-name" : "Spark",
            "engineVersion" : "3.3.2"
            },
            "representations" : [ {
            "type" : "sql-materialized",
            "sql" : "SELECT\n    COUNT(1), CAST(event_ts AS DATE)\nFROM events\nGROUP BY 2",
            "dialect" : "spark",
            "format-version": 1,
            "storage-table": "s3://bucket/warehouse/default.db/event_agg/computed"
            } ]
        } ],
        "schemas": [ {
            "schema-id": 1,
            "type" : "struct",
            "fields" : [ {
            "id" : 1,
            "name" : "event_count",
            "required" : false,
            "type" : "int",
            "doc" : "Count of events"
            }, {
            "id" : 2,
            "name" : "event_date",
            "required" : false,
            "type" : "date"
            } ]
        } ],
        "version-log" : [ {
            "timestamp-ms" : 1573518431292,
            "version-id" : 1
        } ]
        }
        "#;
        let metadata = serde_json::from_str::<MaterializedViewMetadata>(data)
            .expect("Failed to deserialize json");
        //test serialise deserialise works.
        let metadata_two: MaterializedViewMetadata = serde_json::from_str(
            &serde_json::to_string(&metadata).expect("Failed to serialize metadata"),
        )
        .expect("Failed to serialize json");
        dbg!(&metadata, &metadata_two);
        assert_eq!(metadata, metadata_two);

        Ok(())
    }
}