This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch gh-pages
in repository https://gitbox.apache.org/repos/asf/iceberg-rust.git
The following commit(s) were added to refs/heads/gh-pages by this push:
new ad59e6205 deploy: de6a2b9cd2d364f11905fc26c2d318bdc03c2d52
ad59e6205 is described below
commit ad59e6205afc48e000e2ec002fa4b7fcc085c1df
Author: liurenjie1024 <[email protected]>
AuthorDate: Tue Dec 30 01:18:05 2025 +0000
deploy: de6a2b9cd2d364f11905fc26c2d318bdc03c2d52
---
api/iceberg/spec/enum.SnapshotRetention.html | 12 +-
api/iceberg/spec/struct.SnapshotReference.html | 14 +-
api/src/iceberg/spec/snapshot.rs.html | 561 ++++++++++++++-----------
3 files changed, 338 insertions(+), 249 deletions(-)
diff --git a/api/iceberg/spec/enum.SnapshotRetention.html
b/api/iceberg/spec/enum.SnapshotRetention.html
index 6c8f0c3d2..d9cf09f21 100644
--- a/api/iceberg/spec/enum.SnapshotRetention.html
+++ b/api/iceberg/spec/enum.SnapshotRetention.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta
name="viewport" content="width=device-width, initial-scale=1.0"><meta
name="generator" content="rustdoc"><meta name="description" content="The
snapshot expiration procedure removes snapshots from table metadata and applies
the table’s retention policy."><title>SnapshotRetention in iceberg::spec -
Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b05
[...]
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta
name="viewport" content="width=device-width, initial-scale=1.0"><meta
name="generator" content="rustdoc"><meta name="description" content="The
snapshot expiration procedure removes snapshots from table metadata and applies
the table’s retention policy."><title>SnapshotRetention in iceberg::spec -
Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b05
[...]
Branch {
min_snapshots_to_keep: <a class="enum"
href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html";
title="enum core::option::Option">Option</a><<a class="primitive"
href="https://doc.rust-lang.org/nightly/std/primitive.i32.html";>i32</a>>,
max_snapshot_age_ms: <a class="enum"
href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html";
title="enum core::option::Option">Option</a><<a class="primitive"
href="https://doc.rust-lang.org/nightly/std/primitive.i64.html";>i64</a>>,
@@ -19,15 +19,15 @@ Defaults to table property history.expire.max-ref-age-ms.
The main branch never
</div></div></div><section id="variant.Tag" class="variant"><a
href="#variant.Tag" class="anchor">§</a><h3
class="code-header">Tag</h3></section><div class="docblock"><p>Tags are labels
for individual snapshots.</p>
</div><div class="sub-variant" id="variant.Tag.fields"><h4>Fields</h4><div
class="sub-variant-field"><span id="variant.Tag.field.max_ref_age_ms"
class="section-header"><a href="#variant.Tag.field.max_ref_age_ms"
class="anchor field">§</a><code>max_ref_age_ms: <a class="enum"
href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html";
title="enum core::option::Option">Option</a><<a class="primitive"
href="https://doc.rust-lang.org/nightly/std/primitive.i64.html";>i64</a>></
[...]
Defaults to table property history.expire.max-ref-age-ms. The main branch
never expires.</p>
-</div></div></div></div><h2 id="implementations"
class="section-header">Implementations<a href="#implementations"
class="anchor">§</a></h2><div id="implementations-list"><details class="toggle
implementors-toggle" open><summary><section id="impl-SnapshotRetention"
class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#499-512">Source</a><a
href="#impl-SnapshotRetention" class="anchor">§</a><h3 class="code-header">impl
<a class="enum" href="enum.SnapshotRetent [...]
+</div></div></div></div><h2 id="implementations"
class="section-header">Implementations<a href="#implementations"
class="anchor">§</a></h2><div id="implementations-list"><details class="toggle
implementors-toggle" open><summary><section id="impl-SnapshotRetention"
class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#509-522">Source</a><a
href="#impl-SnapshotRetention" class="anchor">§</a><h3 class="code-header">impl
<a class="enum" href="enum.SnapshotRetent [...]
min_snapshots_to_keep: <a class="enum"
href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html";
title="enum core::option::Option">Option</a><<a class="primitive"
href="https://doc.rust-lang.org/nightly/std/primitive.i32.html";>i32</a>>,
max_snapshot_age_ms: <a class="enum"
href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html";
title="enum core::option::Option">Option</a><<a class="primitive"
href="https://doc.rust-lang.org/nightly/std/primitive.i64.html";>i64</a>>,
max_ref_age_ms: <a class="enum"
href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html";
title="enum core::option::Option">Option</a><<a class="primitive"
href="https://doc.rust-lang.org/nightly/std/primitive.i64.html";>i64</a>>,
) -> Self</h4></section></summary><div class="docblock"><p>Create a new
branch retention policy</p>
-</div></details></div></details></div><h2 id="trait-implementations"
class="section-header">Trait Implementations<a href="#trait-implementations"
class="anchor">§</a></h2><div id="trait-implementations-list"><details
class="toggle implementors-toggle" open><summary><section
id="impl-Clone-for-SnapshotRetention" class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#468">Source</a><a
href="#impl-Clone-for-SnapshotRetention" class="anchor">§</a><h3 class="code-
[...]
- __D: <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/de/trait.Deserializer.html";
title="trait
serde_core::de::Deserializer">Deserializer</a><'de>,</div></h4></section></summary><div
class='docblock'>Deserialize this value from the given Serde deserializer. <a
href="https://docs.rs/serde_core/1.0.228/serde_core/de/trait.Deserialize.html#tymethod.deserialize";>Read
more</a></div></details></div></details><details class="toggle
implementors-toggle" open><summar [...]
-and should not be overridden without very good
reason.</div></details></div></details><details class="toggle
implementors-toggle" open><summary><section
id="impl-Serialize-for-SnapshotRetention" class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#468">Source</a><a
href="#impl-Serialize-for-SnapshotRetention" class="anchor">§</a><h3
class="code-header">impl <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serialize.html";
title= [...]
- __S: <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serializer.html";
title="trait
serde_core::ser::Serializer">Serializer</a>,</div></h4></section></summary><div
class='docblock'>Serialize this value into the given Serde serializer. <a
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serialize.html#tymethod.serialize";>Read
more</a></div></details></div></details><section
id="impl-Eq-for-SnapshotRetention" class="impl"><a class="src rightsi [...]
+</div></details></div></details></div><h2 id="trait-implementations"
class="section-header">Trait Implementations<a href="#trait-implementations"
class="anchor">§</a></h2><div id="trait-implementations-list"><details
class="toggle implementors-toggle" open><summary><section
id="impl-Clone-for-SnapshotRetention" class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#478">Source</a><a
href="#impl-Clone-for-SnapshotRetention" class="anchor">§</a><h3 class="code-
[...]
+ __D: <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/de/trait.Deserializer.html";
title="trait
serde_core::de::Deserializer">Deserializer</a><'de>,</div></h4></section></summary><div
class='docblock'>Deserialize this value from the given Serde deserializer. <a
href="https://docs.rs/serde_core/1.0.228/serde_core/de/trait.Deserialize.html#tymethod.deserialize";>Read
more</a></div></details></div></details><details class="toggle
implementors-toggle" open><summar [...]
+and should not be overridden without very good
reason.</div></details></div></details><details class="toggle
implementors-toggle" open><summary><section
id="impl-Serialize-for-SnapshotRetention" class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#478">Source</a><a
href="#impl-Serialize-for-SnapshotRetention" class="anchor">§</a><h3
class="code-header">impl <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serialize.html";
title= [...]
+ __S: <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serializer.html";
title="trait
serde_core::ser::Serializer">Serializer</a>,</div></h4></section></summary><div
class='docblock'>Serialize this value into the given Serde serializer. <a
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serialize.html#tymethod.serialize";>Read
more</a></div></details></div></details><section
id="impl-Eq-for-SnapshotRetention" class="impl"><a class="src rightsi [...]
T: 'static + ?<a class="trait"
href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html";
title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div
class="impl-items"><details class="toggle method-toggle" open><summary><section
id="method.type_id" class="method trait-impl"><a class="src rightside"
href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#139";>Source</a><a
href="#method.type_id" class="anchor">§</a><h4 class="code-header">fn <a href
[...]
T: <a class="trait"
href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html"; title="trait
core::any::Any">Any</a>,</div></h3></section></summary><div
class="impl-items"><section id="method.as_any" class="method trait-impl"><a
href="#method.as_any" class="anchor">§</a><h4 class="code-header">fn <a
class="fn">as_any</a>(&self) -> &(dyn <a class="trait"
href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html"; title="trait
core::any::Any">Any</a> + 'static)</h4 [...]
T: ?<a class="trait"
href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html";
title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div
class="impl-items"><details class="toggle method-toggle" open><summary><section
id="method.borrow" class="method trait-impl"><a class="src rightside"
href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#211";>Source</a><a
href="#method.borrow" class="anchor">§</a><h4 class="code-header">fn <a
href="https:/ [...]
diff --git a/api/iceberg/spec/struct.SnapshotReference.html
b/api/iceberg/spec/struct.SnapshotReference.html
index 4bb1ce104..3c7eea75a 100644
--- a/api/iceberg/spec/struct.SnapshotReference.html
+++ b/api/iceberg/spec/struct.SnapshotReference.html
@@ -1,15 +1,15 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta
name="viewport" content="width=device-width, initial-scale=1.0"><meta
name="generator" content="rustdoc"><meta name="description" content="Iceberg
tables keep track of branches and tags using snapshot
references."><title>SnapshotReference in iceberg::spec -
Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.
[...]
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta
name="viewport" content="width=device-width, initial-scale=1.0"><meta
name="generator" content="rustdoc"><meta name="description" content="Iceberg
tables keep track of branches and tags using snapshot
references."><title>SnapshotReference in iceberg::spec -
Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.
[...]
pub snapshot_id: <a class="primitive"
href="https://doc.rust-lang.org/nightly/std/primitive.i64.html";>i64</a>,
pub retention: <a class="enum" href="enum.SnapshotRetention.html"
title="enum iceberg::spec::SnapshotRetention">SnapshotRetention</a>,
}</code></pre><details class="toggle top-doc" open><summary
class="hideme"><span>Expand description</span></summary><div
class="docblock"><p>Iceberg tables keep track of branches and tags using
snapshot references.</p>
</div></details><h2 id="fields" class="fields section-header">Fields<a
href="#fields" class="anchor">§</a></h2><span id="structfield.snapshot_id"
class="structfield section-header"><a href="#structfield.snapshot_id"
class="anchor field">§</a><code>snapshot_id: <a class="primitive"
href="https://doc.rust-lang.org/nightly/std/primitive.i64.html";>i64</a></code></span><div
class="docblock"><p>A reference’s snapshot ID. The tagged snapshot or latest
snapshot of a branch.</p>
</div><span id="structfield.retention" class="structfield section-header"><a
href="#structfield.retention" class="anchor field">§</a><code>retention: <a
class="enum" href="enum.SnapshotRetention.html" title="enum
iceberg::spec::SnapshotRetention">SnapshotRetention</a></code></span><div
class="docblock"><p>Snapshot retention policy</p>
-</div><h2 id="implementations" class="section-header">Implementations<a
href="#implementations" class="anchor">§</a></h2><div
id="implementations-list"><details class="toggle implementors-toggle"
open><summary><section id="impl-SnapshotReference" class="impl"><a class="src
rightside" href="../../src/iceberg/spec/snapshot.rs.html#451-456">Source</a><a
href="#impl-SnapshotReference" class="anchor">§</a><h3 class="code-header">impl
<a class="struct" href="struct.SnapshotReference.html" titl [...]
-</div></details></div></details><details class="toggle implementors-toggle"
open><summary><section id="impl-SnapshotReference-1" class="impl"><a class="src
rightside" href="../../src/iceberg/spec/snapshot.rs.html#458-466">Source</a><a
href="#impl-SnapshotReference-1" class="anchor">§</a><h3
class="code-header">impl <a class="struct" href="struct.SnapshotReference.html"
title="struct
iceberg::spec::SnapshotReference">SnapshotReference</a></h3></section></summary><div
class="impl-items"><d [...]
-</div></details></div></details></div><h2 id="trait-implementations"
class="section-header">Trait Implementations<a href="#trait-implementations"
class="anchor">§</a></h2><div id="trait-implementations-list"><details
class="toggle implementors-toggle" open><summary><section
id="impl-Clone-for-SnapshotReference" class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#440">Source</a><a
href="#impl-Clone-for-SnapshotReference" class="anchor">§</a><h3 class="code-
[...]
- __D: <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/de/trait.Deserializer.html";
title="trait
serde_core::de::Deserializer">Deserializer</a><'de>,</div></h4></section></summary><div
class='docblock'>Deserialize this value from the given Serde deserializer. <a
href="https://docs.rs/serde_core/1.0.228/serde_core/de/trait.Deserialize.html#tymethod.deserialize";>Read
more</a></div></details></div></details><details class="toggle
implementors-toggle" open><summar [...]
-and should not be overridden without very good
reason.</div></details></div></details><details class="toggle
implementors-toggle" open><summary><section
id="impl-Serialize-for-SnapshotReference" class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#440">Source</a><a
href="#impl-Serialize-for-SnapshotReference" class="anchor">§</a><h3
class="code-header">impl <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serialize.html";
title= [...]
- __S: <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serializer.html";
title="trait
serde_core::ser::Serializer">Serializer</a>,</div></h4></section></summary><div
class='docblock'>Serialize this value into the given Serde serializer. <a
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serialize.html#tymethod.serialize";>Read
more</a></div></details></div></details><section
id="impl-Eq-for-SnapshotReference" class="impl"><a class="src rightsi [...]
+</div><h2 id="implementations" class="section-header">Implementations<a
href="#implementations" class="anchor">§</a></h2><div
id="implementations-list"><details class="toggle implementors-toggle"
open><summary><section id="impl-SnapshotReference" class="impl"><a class="src
rightside" href="../../src/iceberg/spec/snapshot.rs.html#461-466">Source</a><a
href="#impl-SnapshotReference" class="anchor">§</a><h3 class="code-header">impl
<a class="struct" href="struct.SnapshotReference.html" titl [...]
+</div></details></div></details><details class="toggle implementors-toggle"
open><summary><section id="impl-SnapshotReference-1" class="impl"><a class="src
rightside" href="../../src/iceberg/spec/snapshot.rs.html#468-476">Source</a><a
href="#impl-SnapshotReference-1" class="anchor">§</a><h3
class="code-header">impl <a class="struct" href="struct.SnapshotReference.html"
title="struct
iceberg::spec::SnapshotReference">SnapshotReference</a></h3></section></summary><div
class="impl-items"><d [...]
+</div></details></div></details></div><h2 id="trait-implementations"
class="section-header">Trait Implementations<a href="#trait-implementations"
class="anchor">§</a></h2><div id="trait-implementations-list"><details
class="toggle implementors-toggle" open><summary><section
id="impl-Clone-for-SnapshotReference" class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#450">Source</a><a
href="#impl-Clone-for-SnapshotReference" class="anchor">§</a><h3 class="code-
[...]
+ __D: <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/de/trait.Deserializer.html";
title="trait
serde_core::de::Deserializer">Deserializer</a><'de>,</div></h4></section></summary><div
class='docblock'>Deserialize this value from the given Serde deserializer. <a
href="https://docs.rs/serde_core/1.0.228/serde_core/de/trait.Deserialize.html#tymethod.deserialize";>Read
more</a></div></details></div></details><details class="toggle
implementors-toggle" open><summar [...]
+and should not be overridden without very good
reason.</div></details></div></details><details class="toggle
implementors-toggle" open><summary><section
id="impl-Serialize-for-SnapshotReference" class="impl"><a class="src rightside"
href="../../src/iceberg/spec/snapshot.rs.html#450">Source</a><a
href="#impl-Serialize-for-SnapshotReference" class="anchor">§</a><h3
class="code-header">impl <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serialize.html";
title= [...]
+ __S: <a class="trait"
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serializer.html";
title="trait
serde_core::ser::Serializer">Serializer</a>,</div></h4></section></summary><div
class='docblock'>Serialize this value into the given Serde serializer. <a
href="https://docs.rs/serde_core/1.0.228/serde_core/ser/trait.Serialize.html#tymethod.serialize";>Read
more</a></div></details></div></details><section
id="impl-Eq-for-SnapshotReference" class="impl"><a class="src rightsi [...]
T: 'static + ?<a class="trait"
href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html";
title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div
class="impl-items"><details class="toggle method-toggle" open><summary><section
id="method.type_id" class="method trait-impl"><a class="src rightside"
href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#139";>Source</a><a
href="#method.type_id" class="anchor">§</a><h4 class="code-header">fn <a href
[...]
T: <a class="trait"
href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html"; title="trait
core::any::Any">Any</a>,</div></h3></section></summary><div
class="impl-items"><section id="method.as_any" class="method trait-impl"><a
href="#method.as_any" class="anchor">§</a><h4 class="code-header">fn <a
class="fn">as_any</a>(&self) -> &(dyn <a class="trait"
href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html"; title="trait
core::any::Any">Any</a> + 'static)</h4 [...]
T: ?<a class="trait"
href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html";
title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div
class="impl-items"><details class="toggle method-toggle" open><summary><section
id="method.borrow" class="method trait-impl"><a class="src rightside"
href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#211";>Source</a><a
href="#method.borrow" class="anchor">§</a><h4 class="code-header">fn <a
href="https:/ [...]
diff --git a/api/src/iceberg/spec/snapshot.rs.html
b/api/src/iceberg/spec/snapshot.rs.html
index d08821e60..5a92a0f59 100644
--- a/api/src/iceberg/spec/snapshot.rs.html
+++ b/api/src/iceberg/spec/snapshot.rs.html
@@ -266,9 +266,9 @@
<a href=#266 id=266 data-nosnippet>266</a> <span class="kw">use
</span>serde::{Deserialize, Serialize};
<a href=#267 id=267 data-nosnippet>267</a>
<a href=#268 id=268 data-nosnippet>268</a> <span class="kw">use
super</span>::{Operation, Snapshot, Summary};
-<a href=#269 id=269 data-nosnippet>269</a> <span class="kw">use
</span><span class="kw">crate</span>::Error;
-<a href=#270 id=270 data-nosnippet>270</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::SchemaId;
-<a href=#271 id=271 data-nosnippet>271</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::SnapshotRowRange;
+<a href=#269 id=269 data-nosnippet>269</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::SchemaId;
+<a href=#270 id=270 data-nosnippet>270</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::SnapshotRowRange;
+<a href=#271 id=271 data-nosnippet>271</a> <span class="kw">use
crate</span>::{Error, ErrorKind};
<a href=#272 id=272 data-nosnippet>272</a>
<a href=#273 id=273 data-nosnippet>273</a> <span
class="attr">#[derive(Debug, Serialize, Deserialize, PartialEq, Eq)]
<a href=#274 id=274 data-nosnippet>274</a> #[serde(rename_all = <span
class="string">"kebab-case"</span>)]
@@ -408,239 +408,328 @@
<a href=#408 id=408 data-nosnippet>408</a> timestamp_ms:
v1.timestamp_ms,
<a href=#409 id=409 data-nosnippet>409</a> manifest_list: <span
class="kw">match </span>(v1.manifest_list, v1.manifests) {
<a href=#410 id=410 data-nosnippet>410</a> (<span
class="prelude-val">Some</span>(file), <span class="prelude-val">None</span>)
=> file,
-<a href=#411 id=411 data-nosnippet>411</a> (<span
class="prelude-val">Some</span>(<span class="kw">_</span>), <span
class="prelude-val">Some</span>(<span class="kw">_</span>)) => <span
class="string">"Invalid v1 snapshot, when manifest list provided, manifest
files should be omitted"</span>.to_string(),
-<a href=#412 id=412 data-nosnippet>412</a> (<span
class="prelude-val">None</span>, <span class="kw">_</span>) => <span
class="string">"Unsupported v1 snapshot, only manifest list is
supported"</span>.to_string()
-<a href=#413 id=413 data-nosnippet>413</a> },
-<a href=#414 id=414 data-nosnippet>414</a> summary:
v1.summary.unwrap_or(Summary {
-<a href=#415 id=415 data-nosnippet>415</a> operation:
Operation::default(),
-<a href=#416 id=416 data-nosnippet>416</a>
additional_properties: HashMap::new(),
-<a href=#417 id=417 data-nosnippet>417</a> }),
-<a href=#418 id=418 data-nosnippet>418</a> schema_id:
v1.schema_id,
-<a href=#419 id=419 data-nosnippet>419</a> encryption_key_id:
<span class="prelude-val">None</span>,
-<a href=#420 id=420 data-nosnippet>420</a> row_range: <span
class="prelude-val">None</span>,
-<a href=#421 id=421 data-nosnippet>421</a> })
-<a href=#422 id=422 data-nosnippet>422</a> }
-<a href=#423 id=423 data-nosnippet>423</a> }
-<a href=#424 id=424 data-nosnippet>424</a>
-<a href=#425 id=425 data-nosnippet>425</a> <span class="kw">impl
</span>From<Snapshot> <span class="kw">for </span>SnapshotV1 {
-<a href=#426 id=426 data-nosnippet>426</a> <span class="kw">fn
</span>from(v2: Snapshot) -> <span class="self">Self </span>{
-<a href=#427 id=427 data-nosnippet>427</a> SnapshotV1 {
-<a href=#428 id=428 data-nosnippet>428</a> snapshot_id:
v2.snapshot_id,
-<a href=#429 id=429 data-nosnippet>429</a> parent_snapshot_id:
v2.parent_snapshot_id,
-<a href=#430 id=430 data-nosnippet>430</a> timestamp_ms:
v2.timestamp_ms,
-<a href=#431 id=431 data-nosnippet>431</a> manifest_list: <span
class="prelude-val">Some</span>(v2.manifest_list),
-<a href=#432 id=432 data-nosnippet>432</a> summary: <span
class="prelude-val">Some</span>(v2.summary),
-<a href=#433 id=433 data-nosnippet>433</a> schema_id:
v2.schema_id,
-<a href=#434 id=434 data-nosnippet>434</a> manifests: <span
class="prelude-val">None</span>,
-<a href=#435 id=435 data-nosnippet>435</a> }
-<a href=#436 id=436 data-nosnippet>436</a> }
-<a href=#437 id=437 data-nosnippet>437</a> }
-<a href=#438 id=438 data-nosnippet>438</a>}
-<a href=#439 id=439 data-nosnippet>439</a>
-<a href=#440 id=440 data-nosnippet>440</a><span class="attr">#[derive(Debug,
Serialize, Deserialize, PartialEq, Eq, Clone)]
-<a href=#441 id=441 data-nosnippet>441</a>#[serde(rename_all = <span
class="string">"kebab-case"</span>)]
-<a href=#442 id=442 data-nosnippet>442</a></span><span class="doccomment">///
Iceberg tables keep track of branches and tags using snapshot references.
-<a href=#443 id=443 data-nosnippet>443</a></span><span class="kw">pub struct
</span>SnapshotReference {
-<a href=#444 id=444 data-nosnippet>444</a> <span class="doccomment">/// A
reference’s snapshot ID. The tagged snapshot or latest snapshot of a branch.
-<a href=#445 id=445 data-nosnippet>445</a> </span><span class="kw">pub
</span>snapshot_id: i64,
-<a href=#446 id=446 data-nosnippet>446</a> <span
class="attr">#[serde(flatten)]
-<a href=#447 id=447 data-nosnippet>447</a> </span><span
class="doccomment">/// Snapshot retention policy
-<a href=#448 id=448 data-nosnippet>448</a> </span><span class="kw">pub
</span>retention: SnapshotRetention,
-<a href=#449 id=449 data-nosnippet>449</a>}
-<a href=#450 id=450 data-nosnippet>450</a>
-<a href=#451 id=451 data-nosnippet>451</a><span class="kw">impl
</span>SnapshotReference {
-<a href=#452 id=452 data-nosnippet>452</a> <span class="doccomment">///
Returns true if the snapshot reference is a branch.
-<a href=#453 id=453 data-nosnippet>453</a> </span><span class="kw">pub fn
</span>is_branch(<span class="kw-2">&</span><span class="self">self</span>)
-> bool {
-<a href=#454 id=454 data-nosnippet>454</a> <span
class="macro">matches!</span>(<span class="self">self</span>.retention,
SnapshotRetention::Branch { .. })
-<a href=#455 id=455 data-nosnippet>455</a> }
-<a href=#456 id=456 data-nosnippet>456</a>}
-<a href=#457 id=457 data-nosnippet>457</a>
-<a href=#458 id=458 data-nosnippet>458</a><span class="kw">impl
</span>SnapshotReference {
-<a href=#459 id=459 data-nosnippet>459</a> <span class="doccomment">///
Create new snapshot reference
-<a href=#460 id=460 data-nosnippet>460</a> </span><span class="kw">pub fn
</span>new(snapshot_id: i64, retention: SnapshotRetention) -> <span
class="self">Self </span>{
-<a href=#461 id=461 data-nosnippet>461</a> SnapshotReference {
-<a href=#462 id=462 data-nosnippet>462</a> snapshot_id,
-<a href=#463 id=463 data-nosnippet>463</a> retention,
-<a href=#464 id=464 data-nosnippet>464</a> }
+<a href=#411 id=411 data-nosnippet>411</a> (<span
class="prelude-val">Some</span>(<span class="kw">_</span>), <span
class="prelude-val">Some</span>(<span class="kw">_</span>)) => {
+<a href=#412 id=412 data-nosnippet>412</a> <span
class="kw">return </span><span class="prelude-val">Err</span>(Error::new(
+<a href=#413 id=413 data-nosnippet>413</a>
ErrorKind::DataInvalid,
+<a href=#414 id=414 data-nosnippet>414</a> <span
class="string">"Invalid v1 snapshot, when manifest list provided, manifest
files should be omitted"</span>,
+<a href=#415 id=415 data-nosnippet>415</a> ));
+<a href=#416 id=416 data-nosnippet>416</a> }
+<a href=#417 id=417 data-nosnippet>417</a> (<span
class="prelude-val">None</span>, <span class="kw">_</span>) => {
+<a href=#418 id=418 data-nosnippet>418</a> <span
class="kw">return </span><span class="prelude-val">Err</span>(Error::new(
+<a href=#419 id=419 data-nosnippet>419</a>
ErrorKind::DataInvalid,
+<a href=#420 id=420 data-nosnippet>420</a> <span
class="string">"Unsupported v1 snapshot, only manifest list is
supported"</span>,
+<a href=#421 id=421 data-nosnippet>421</a> ));
+<a href=#422 id=422 data-nosnippet>422</a> }
+<a href=#423 id=423 data-nosnippet>423</a> },
+<a href=#424 id=424 data-nosnippet>424</a> summary:
v1.summary.unwrap_or(Summary {
+<a href=#425 id=425 data-nosnippet>425</a> operation:
Operation::default(),
+<a href=#426 id=426 data-nosnippet>426</a>
additional_properties: HashMap::new(),
+<a href=#427 id=427 data-nosnippet>427</a> }),
+<a href=#428 id=428 data-nosnippet>428</a> schema_id:
v1.schema_id,
+<a href=#429 id=429 data-nosnippet>429</a> encryption_key_id:
<span class="prelude-val">None</span>,
+<a href=#430 id=430 data-nosnippet>430</a> row_range: <span
class="prelude-val">None</span>,
+<a href=#431 id=431 data-nosnippet>431</a> })
+<a href=#432 id=432 data-nosnippet>432</a> }
+<a href=#433 id=433 data-nosnippet>433</a> }
+<a href=#434 id=434 data-nosnippet>434</a>
+<a href=#435 id=435 data-nosnippet>435</a> <span class="kw">impl
</span>From<Snapshot> <span class="kw">for </span>SnapshotV1 {
+<a href=#436 id=436 data-nosnippet>436</a> <span class="kw">fn
</span>from(v2: Snapshot) -> <span class="self">Self </span>{
+<a href=#437 id=437 data-nosnippet>437</a> SnapshotV1 {
+<a href=#438 id=438 data-nosnippet>438</a> snapshot_id:
v2.snapshot_id,
+<a href=#439 id=439 data-nosnippet>439</a> parent_snapshot_id:
v2.parent_snapshot_id,
+<a href=#440 id=440 data-nosnippet>440</a> timestamp_ms:
v2.timestamp_ms,
+<a href=#441 id=441 data-nosnippet>441</a> manifest_list: <span
class="prelude-val">Some</span>(v2.manifest_list),
+<a href=#442 id=442 data-nosnippet>442</a> summary: <span
class="prelude-val">Some</span>(v2.summary),
+<a href=#443 id=443 data-nosnippet>443</a> schema_id:
v2.schema_id,
+<a href=#444 id=444 data-nosnippet>444</a> manifests: <span
class="prelude-val">None</span>,
+<a href=#445 id=445 data-nosnippet>445</a> }
+<a href=#446 id=446 data-nosnippet>446</a> }
+<a href=#447 id=447 data-nosnippet>447</a> }
+<a href=#448 id=448 data-nosnippet>448</a>}
+<a href=#449 id=449 data-nosnippet>449</a>
+<a href=#450 id=450 data-nosnippet>450</a><span class="attr">#[derive(Debug,
Serialize, Deserialize, PartialEq, Eq, Clone)]
+<a href=#451 id=451 data-nosnippet>451</a>#[serde(rename_all = <span
class="string">"kebab-case"</span>)]
+<a href=#452 id=452 data-nosnippet>452</a></span><span class="doccomment">///
Iceberg tables keep track of branches and tags using snapshot references.
+<a href=#453 id=453 data-nosnippet>453</a></span><span class="kw">pub struct
</span>SnapshotReference {
+<a href=#454 id=454 data-nosnippet>454</a> <span class="doccomment">/// A
reference’s snapshot ID. The tagged snapshot or latest snapshot of a branch.
+<a href=#455 id=455 data-nosnippet>455</a> </span><span class="kw">pub
</span>snapshot_id: i64,
+<a href=#456 id=456 data-nosnippet>456</a> <span
class="attr">#[serde(flatten)]
+<a href=#457 id=457 data-nosnippet>457</a> </span><span
class="doccomment">/// Snapshot retention policy
+<a href=#458 id=458 data-nosnippet>458</a> </span><span class="kw">pub
</span>retention: SnapshotRetention,
+<a href=#459 id=459 data-nosnippet>459</a>}
+<a href=#460 id=460 data-nosnippet>460</a>
+<a href=#461 id=461 data-nosnippet>461</a><span class="kw">impl
</span>SnapshotReference {
+<a href=#462 id=462 data-nosnippet>462</a> <span class="doccomment">///
Returns true if the snapshot reference is a branch.
+<a href=#463 id=463 data-nosnippet>463</a> </span><span class="kw">pub fn
</span>is_branch(<span class="kw-2">&</span><span class="self">self</span>)
-> bool {
+<a href=#464 id=464 data-nosnippet>464</a> <span
class="macro">matches!</span>(<span class="self">self</span>.retention,
SnapshotRetention::Branch { .. })
<a href=#465 id=465 data-nosnippet>465</a> }
<a href=#466 id=466 data-nosnippet>466</a>}
<a href=#467 id=467 data-nosnippet>467</a>
-<a href=#468 id=468 data-nosnippet>468</a><span class="attr">#[derive(Debug,
Serialize, Deserialize, PartialEq, Eq, Clone)]
-<a href=#469 id=469 data-nosnippet>469</a>#[serde(rename_all = <span
class="string">"lowercase"</span>, tag = <span class="string">"type"</span>)]
-<a href=#470 id=470 data-nosnippet>470</a></span><span class="doccomment">///
The snapshot expiration procedure removes snapshots from table metadata and
applies the table’s retention policy.
-<a href=#471 id=471 data-nosnippet>471</a></span><span class="kw">pub enum
</span>SnapshotRetention {
-<a href=#472 id=472 data-nosnippet>472</a> <span
class="attr">#[serde(rename_all = <span class="string">"kebab-case"</span>)]
-<a href=#473 id=473 data-nosnippet>473</a> </span><span
class="doccomment">/// Branches are mutable named references that can be
updated by committing a new snapshot as
-<a href=#474 id=474 data-nosnippet>474</a> /// the branch’s referenced
snapshot using the Commit Conflict Resolution and Retry procedures.
-<a href=#475 id=475 data-nosnippet>475</a> </span>Branch {
-<a href=#476 id=476 data-nosnippet>476</a> <span class="doccomment">///
A positive number for the minimum number of snapshots to keep in a branch while
expiring snapshots.
-<a href=#477 id=477 data-nosnippet>477</a> /// Defaults to table
property history.expire.min-snapshots-to-keep.
-<a href=#478 id=478 data-nosnippet>478</a> </span><span
class="attr">#[serde(skip_serializing_if = <span
class="string">"Option::is_none"</span>)]
-<a href=#479 id=479 data-nosnippet>479</a>
</span>min_snapshots_to_keep: <span class="prelude-ty">Option</span><i32>,
-<a href=#480 id=480 data-nosnippet>480</a> <span class="doccomment">///
A positive number for the max age of snapshots to keep when expiring, including
the latest snapshot.
-<a href=#481 id=481 data-nosnippet>481</a> /// Defaults to table
property history.expire.max-snapshot-age-ms.
-<a href=#482 id=482 data-nosnippet>482</a> </span><span
class="attr">#[serde(skip_serializing_if = <span
class="string">"Option::is_none"</span>)]
-<a href=#483 id=483 data-nosnippet>483</a> </span>max_snapshot_age_ms:
<span class="prelude-ty">Option</span><i64>,
-<a href=#484 id=484 data-nosnippet>484</a> <span class="doccomment">///
For snapshot references except the main branch, a positive number for the max
age of the snapshot reference to keep while expiring snapshots.
-<a href=#485 id=485 data-nosnippet>485</a> /// Defaults to table
property history.expire.max-ref-age-ms. The main branch never expires.
-<a href=#486 id=486 data-nosnippet>486</a> </span><span
class="attr">#[serde(skip_serializing_if = <span
class="string">"Option::is_none"</span>)]
-<a href=#487 id=487 data-nosnippet>487</a> </span>max_ref_age_ms: <span
class="prelude-ty">Option</span><i64>,
-<a href=#488 id=488 data-nosnippet>488</a> },
-<a href=#489 id=489 data-nosnippet>489</a> <span
class="attr">#[serde(rename_all = <span class="string">"kebab-case"</span>)]
-<a href=#490 id=490 data-nosnippet>490</a> </span><span
class="doccomment">/// Tags are labels for individual snapshots.
-<a href=#491 id=491 data-nosnippet>491</a> </span>Tag {
-<a href=#492 id=492 data-nosnippet>492</a> <span class="doccomment">///
For snapshot references except the main branch, a positive number for the max
age of the snapshot reference to keep while expiring snapshots.
-<a href=#493 id=493 data-nosnippet>493</a> /// Defaults to table
property history.expire.max-ref-age-ms. The main branch never expires.
-<a href=#494 id=494 data-nosnippet>494</a> </span><span
class="attr">#[serde(skip_serializing_if = <span
class="string">"Option::is_none"</span>)]
-<a href=#495 id=495 data-nosnippet>495</a> </span>max_ref_age_ms: <span
class="prelude-ty">Option</span><i64>,
-<a href=#496 id=496 data-nosnippet>496</a> },
-<a href=#497 id=497 data-nosnippet>497</a>}
-<a href=#498 id=498 data-nosnippet>498</a>
-<a href=#499 id=499 data-nosnippet>499</a><span class="kw">impl
</span>SnapshotRetention {
-<a href=#500 id=500 data-nosnippet>500</a> <span class="doccomment">///
Create a new branch retention policy
-<a href=#501 id=501 data-nosnippet>501</a> </span><span class="kw">pub fn
</span>branch(
-<a href=#502 id=502 data-nosnippet>502</a> min_snapshots_to_keep: <span
class="prelude-ty">Option</span><i32>,
-<a href=#503 id=503 data-nosnippet>503</a> max_snapshot_age_ms: <span
class="prelude-ty">Option</span><i64>,
-<a href=#504 id=504 data-nosnippet>504</a> max_ref_age_ms: <span
class="prelude-ty">Option</span><i64>,
-<a href=#505 id=505 data-nosnippet>505</a> ) -> <span class="self">Self
</span>{
-<a href=#506 id=506 data-nosnippet>506</a> SnapshotRetention::Branch {
-<a href=#507 id=507 data-nosnippet>507</a> min_snapshots_to_keep,
-<a href=#508 id=508 data-nosnippet>508</a> max_snapshot_age_ms,
-<a href=#509 id=509 data-nosnippet>509</a> max_ref_age_ms,
-<a href=#510 id=510 data-nosnippet>510</a> }
-<a href=#511 id=511 data-nosnippet>511</a> }
-<a href=#512 id=512 data-nosnippet>512</a>}
-<a href=#513 id=513 data-nosnippet>513</a>
-<a href=#514 id=514 data-nosnippet>514</a><span class="attr">#[cfg(test)]
-<a href=#515 id=515 data-nosnippet>515</a></span><span class="kw">mod
</span>tests {
-<a href=#516 id=516 data-nosnippet>516</a> <span class="kw">use
</span>std::collections::HashMap;
-<a href=#517 id=517 data-nosnippet>517</a>
-<a href=#518 id=518 data-nosnippet>518</a> <span class="kw">use
</span>chrono::{TimeZone, Utc};
-<a href=#519 id=519 data-nosnippet>519</a>
-<a href=#520 id=520 data-nosnippet>520</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::_serde::SnapshotV1;
-<a href=#521 id=521 data-nosnippet>521</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::{Operation, Snapshot,
Summary};
-<a href=#522 id=522 data-nosnippet>522</a>
-<a href=#523 id=523 data-nosnippet>523</a> <span class="attr">#[test]
-<a href=#524 id=524 data-nosnippet>524</a> </span><span class="kw">fn
</span>schema() {
-<a href=#525 id=525 data-nosnippet>525</a> <span class="kw">let
</span>record = <span class="string">r#"
-<a href=#526 id=526 data-nosnippet>526</a> {
-<a href=#527 id=527 data-nosnippet>527</a> "snapshot-id":
3051729675574597004,
-<a href=#528 id=528 data-nosnippet>528</a> "timestamp-ms":
1515100955770,
-<a href=#529 id=529 data-nosnippet>529</a> "summary": {
-<a href=#530 id=530 data-nosnippet>530</a> "operation": "append"
-<a href=#531 id=531 data-nosnippet>531</a> },
-<a href=#532 id=532 data-nosnippet>532</a> "manifest-list":
"s3://b/wh/.../s1.avro",
-<a href=#533 id=533 data-nosnippet>533</a> "schema-id": 0
-<a href=#534 id=534 data-nosnippet>534</a> }
-<a href=#535 id=535 data-nosnippet>535</a> "#</span>;
-<a href=#536 id=536 data-nosnippet>536</a>
-<a href=#537 id=537 data-nosnippet>537</a> <span class="kw">let
</span>result: Snapshot = serde_json::from_str::<SnapshotV1>(record)
-<a href=#538 id=538 data-nosnippet>538</a> .unwrap()
-<a href=#539 id=539 data-nosnippet>539</a> .try_into()
-<a href=#540 id=540 data-nosnippet>540</a> .unwrap();
-<a href=#541 id=541 data-nosnippet>541</a> <span
class="macro">assert_eq!</span>(<span
class="number">3051729675574597004</span>, result.snapshot_id());
-<a href=#542 id=542 data-nosnippet>542</a> <span
class="macro">assert_eq!</span>(
-<a href=#543 id=543 data-nosnippet>543</a>
Utc.timestamp_millis_opt(<span class="number">1515100955770</span>).unwrap(),
-<a href=#544 id=544 data-nosnippet>544</a>
result.timestamp().unwrap()
-<a href=#545 id=545 data-nosnippet>545</a> );
-<a href=#546 id=546 data-nosnippet>546</a> <span
class="macro">assert_eq!</span>(<span class="number">1515100955770</span>,
result.timestamp_ms());
-<a href=#547 id=547 data-nosnippet>547</a> <span
class="macro">assert_eq!</span>(
-<a href=#548 id=548 data-nosnippet>548</a> Summary {
-<a href=#549 id=549 data-nosnippet>549</a> operation:
Operation::Append,
-<a href=#550 id=550 data-nosnippet>550</a>
additional_properties: HashMap::new()
-<a href=#551 id=551 data-nosnippet>551</a> },
-<a href=#552 id=552 data-nosnippet>552</a> <span
class="kw-2">*</span>result.summary()
-<a href=#553 id=553 data-nosnippet>553</a> );
-<a href=#554 id=554 data-nosnippet>554</a> <span
class="macro">assert_eq!</span>(<span
class="string">"s3://b/wh/.../s1.avro"</span>.to_string(), <span
class="kw-2">*</span>result.manifest_list());
-<a href=#555 id=555 data-nosnippet>555</a> }
-<a href=#556 id=556 data-nosnippet>556</a>
-<a href=#557 id=557 data-nosnippet>557</a> <span class="attr">#[test]
-<a href=#558 id=558 data-nosnippet>558</a> </span><span class="kw">fn
</span>test_snapshot_v1_to_v2_projection() {
-<a href=#559 id=559 data-nosnippet>559</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::_serde::SnapshotV1;
-<a href=#560 id=560 data-nosnippet>560</a>
-<a href=#561 id=561 data-nosnippet>561</a> <span class="comment">//
Create a V1 snapshot (without sequence-number field)
-<a href=#562 id=562 data-nosnippet>562</a> </span><span class="kw">let
</span>v1_snapshot = SnapshotV1 {
-<a href=#563 id=563 data-nosnippet>563</a> snapshot_id: <span
class="number">1234567890</span>,
-<a href=#564 id=564 data-nosnippet>564</a> parent_snapshot_id:
<span class="prelude-val">Some</span>(<span class="number">987654321</span>),
-<a href=#565 id=565 data-nosnippet>565</a> timestamp_ms: <span
class="number">1515100955770</span>,
-<a href=#566 id=566 data-nosnippet>566</a> manifest_list: <span
class="prelude-val">Some</span>(<span
class="string">"s3://bucket/manifest-list.avro"</span>.to_string()),
-<a href=#567 id=567 data-nosnippet>567</a> manifests: <span
class="prelude-val">None</span>, <span class="comment">// V1 can have either
manifest_list or manifests, but not both
-<a href=#568 id=568 data-nosnippet>568</a> </span>summary: <span
class="prelude-val">Some</span>(Summary {
-<a href=#569 id=569 data-nosnippet>569</a> operation:
Operation::Append,
-<a href=#570 id=570 data-nosnippet>570</a>
additional_properties: HashMap::from([
-<a href=#571 id=571 data-nosnippet>571</a> (<span
class="string">"added-files"</span>.to_string(), <span
class="string">"5"</span>.to_string()),
-<a href=#572 id=572 data-nosnippet>572</a> (<span
class="string">"added-records"</span>.to_string(), <span
class="string">"100"</span>.to_string()),
-<a href=#573 id=573 data-nosnippet>573</a> ]),
-<a href=#574 id=574 data-nosnippet>574</a> }),
-<a href=#575 id=575 data-nosnippet>575</a> schema_id: <span
class="prelude-val">Some</span>(<span class="number">1</span>),
-<a href=#576 id=576 data-nosnippet>576</a> };
-<a href=#577 id=577 data-nosnippet>577</a>
-<a href=#578 id=578 data-nosnippet>578</a> <span class="comment">//
Convert V1 to V2 - this should apply defaults for missing V2 fields
-<a href=#579 id=579 data-nosnippet>579</a> </span><span class="kw">let
</span>v2_snapshot: Snapshot = v1_snapshot.try_into().unwrap();
-<a href=#580 id=580 data-nosnippet>580</a>
-<a href=#581 id=581 data-nosnippet>581</a> <span class="comment">//
Verify V1→V2 projection defaults are applied correctly
-<a href=#582 id=582 data-nosnippet>582</a> </span><span
class="macro">assert_eq!</span>(
-<a href=#583 id=583 data-nosnippet>583</a>
v2_snapshot.sequence_number(),
-<a href=#584 id=584 data-nosnippet>584</a> <span
class="number">0</span>,
-<a href=#585 id=585 data-nosnippet>585</a> <span class="string">"V1
snapshot sequence_number should default to 0"
-<a href=#586 id=586 data-nosnippet>586</a> </span>);
-<a href=#587 id=587 data-nosnippet>587</a>
-<a href=#588 id=588 data-nosnippet>588</a> <span class="comment">//
Verify other fields are preserved correctly during conversion
-<a href=#589 id=589 data-nosnippet>589</a> </span><span
class="macro">assert_eq!</span>(v2_snapshot.snapshot_id(), <span
class="number">1234567890</span>);
-<a href=#590 id=590 data-nosnippet>590</a> <span
class="macro">assert_eq!</span>(v2_snapshot.parent_snapshot_id(), <span
class="prelude-val">Some</span>(<span class="number">987654321</span>));
-<a href=#591 id=591 data-nosnippet>591</a> <span
class="macro">assert_eq!</span>(v2_snapshot.timestamp_ms(), <span
class="number">1515100955770</span>);
-<a href=#592 id=592 data-nosnippet>592</a> <span
class="macro">assert_eq!</span>(
-<a href=#593 id=593 data-nosnippet>593</a>
v2_snapshot.manifest_list(),
-<a href=#594 id=594 data-nosnippet>594</a> <span
class="string">"s3://bucket/manifest-list.avro"
-<a href=#595 id=595 data-nosnippet>595</a> </span>);
-<a href=#596 id=596 data-nosnippet>596</a> <span
class="macro">assert_eq!</span>(v2_snapshot.schema_id(), <span
class="prelude-val">Some</span>(<span class="number">1</span>));
-<a href=#597 id=597 data-nosnippet>597</a> <span
class="macro">assert_eq!</span>(v2_snapshot.summary().operation,
Operation::Append);
-<a href=#598 id=598 data-nosnippet>598</a> <span
class="macro">assert_eq!</span>(
-<a href=#599 id=599 data-nosnippet>599</a> v2_snapshot
-<a href=#600 id=600 data-nosnippet>600</a> .summary()
-<a href=#601 id=601 data-nosnippet>601</a>
.additional_properties
-<a href=#602 id=602 data-nosnippet>602</a> .get(<span
class="string">"added-files"</span>),
-<a href=#603 id=603 data-nosnippet>603</a> <span
class="prelude-val">Some</span>(<span class="kw-2">&</span><span
class="string">"5"</span>.to_string())
-<a href=#604 id=604 data-nosnippet>604</a> );
-<a href=#605 id=605 data-nosnippet>605</a> }
-<a href=#606 id=606 data-nosnippet>606</a>
-<a href=#607 id=607 data-nosnippet>607</a> <span class="attr">#[test]
-<a href=#608 id=608 data-nosnippet>608</a> </span><span class="kw">fn
</span>test_snapshot_v1_to_v2_with_missing_summary() {
-<a href=#609 id=609 data-nosnippet>609</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::_serde::SnapshotV1;
-<a href=#610 id=610 data-nosnippet>610</a>
-<a href=#611 id=611 data-nosnippet>611</a> <span class="comment">//
Create a V1 snapshot without summary (should get default)
-<a href=#612 id=612 data-nosnippet>612</a> </span><span class="kw">let
</span>v1_snapshot = SnapshotV1 {
-<a href=#613 id=613 data-nosnippet>613</a> snapshot_id: <span
class="number">1111111111</span>,
-<a href=#614 id=614 data-nosnippet>614</a> parent_snapshot_id:
<span class="prelude-val">None</span>,
-<a href=#615 id=615 data-nosnippet>615</a> timestamp_ms: <span
class="number">1515100955770</span>,
-<a href=#616 id=616 data-nosnippet>616</a> manifest_list: <span
class="prelude-val">Some</span>(<span
class="string">"s3://bucket/manifest-list.avro"</span>.to_string()),
-<a href=#617 id=617 data-nosnippet>617</a> manifests: <span
class="prelude-val">None</span>,
-<a href=#618 id=618 data-nosnippet>618</a> summary: <span
class="prelude-val">None</span>, <span class="comment">// V1 summary is optional
-<a href=#619 id=619 data-nosnippet>619</a> </span>schema_id: <span
class="prelude-val">None</span>,
-<a href=#620 id=620 data-nosnippet>620</a> };
-<a href=#621 id=621 data-nosnippet>621</a>
-<a href=#622 id=622 data-nosnippet>622</a> <span class="comment">//
Convert V1 to V2 - this should apply default summary
-<a href=#623 id=623 data-nosnippet>623</a> </span><span class="kw">let
</span>v2_snapshot: Snapshot = v1_snapshot.try_into().unwrap();
-<a href=#624 id=624 data-nosnippet>624</a>
-<a href=#625 id=625 data-nosnippet>625</a> <span class="comment">//
Verify defaults are applied correctly
-<a href=#626 id=626 data-nosnippet>626</a> </span><span
class="macro">assert_eq!</span>(
-<a href=#627 id=627 data-nosnippet>627</a>
v2_snapshot.sequence_number(),
-<a href=#628 id=628 data-nosnippet>628</a> <span
class="number">0</span>,
-<a href=#629 id=629 data-nosnippet>629</a> <span class="string">"V1
snapshot sequence_number should default to 0"
-<a href=#630 id=630 data-nosnippet>630</a> </span>);
-<a href=#631 id=631 data-nosnippet>631</a> <span
class="macro">assert_eq!</span>(
-<a href=#632 id=632 data-nosnippet>632</a>
v2_snapshot.summary().operation,
-<a href=#633 id=633 data-nosnippet>633</a> Operation::Append,
-<a href=#634 id=634 data-nosnippet>634</a> <span
class="string">"Missing V1 summary should default to Append operation"
-<a href=#635 id=635 data-nosnippet>635</a> </span>);
-<a href=#636 id=636 data-nosnippet>636</a> <span
class="macro">assert!</span>(
-<a href=#637 id=637 data-nosnippet>637</a>
v2_snapshot.summary().additional_properties.is_empty(),
-<a href=#638 id=638 data-nosnippet>638</a> <span
class="string">"Default summary should have empty additional_properties"
-<a href=#639 id=639 data-nosnippet>639</a> </span>);
-<a href=#640 id=640 data-nosnippet>640</a>
-<a href=#641 id=641 data-nosnippet>641</a> <span class="comment">//
Verify other fields
-<a href=#642 id=642 data-nosnippet>642</a> </span><span
class="macro">assert_eq!</span>(v2_snapshot.snapshot_id(), <span
class="number">1111111111</span>);
-<a href=#643 id=643 data-nosnippet>643</a> <span
class="macro">assert_eq!</span>(v2_snapshot.parent_snapshot_id(), <span
class="prelude-val">None</span>);
-<a href=#644 id=644 data-nosnippet>644</a> <span
class="macro">assert_eq!</span>(v2_snapshot.schema_id(), <span
class="prelude-val">None</span>);
-<a href=#645 id=645 data-nosnippet>645</a> }
-<a href=#646 id=646
data-nosnippet>646</a>}</code></pre></div></section></main></body></html>
\ No newline at end of file
+<a href=#468 id=468 data-nosnippet>468</a><span class="kw">impl
</span>SnapshotReference {
+<a href=#469 id=469 data-nosnippet>469</a> <span class="doccomment">///
Create new snapshot reference
+<a href=#470 id=470 data-nosnippet>470</a> </span><span class="kw">pub fn
</span>new(snapshot_id: i64, retention: SnapshotRetention) -> <span
class="self">Self </span>{
+<a href=#471 id=471 data-nosnippet>471</a> SnapshotReference {
+<a href=#472 id=472 data-nosnippet>472</a> snapshot_id,
+<a href=#473 id=473 data-nosnippet>473</a> retention,
+<a href=#474 id=474 data-nosnippet>474</a> }
+<a href=#475 id=475 data-nosnippet>475</a> }
+<a href=#476 id=476 data-nosnippet>476</a>}
+<a href=#477 id=477 data-nosnippet>477</a>
+<a href=#478 id=478 data-nosnippet>478</a><span class="attr">#[derive(Debug,
Serialize, Deserialize, PartialEq, Eq, Clone)]
+<a href=#479 id=479 data-nosnippet>479</a>#[serde(rename_all = <span
class="string">"lowercase"</span>, tag = <span class="string">"type"</span>)]
+<a href=#480 id=480 data-nosnippet>480</a></span><span class="doccomment">///
The snapshot expiration procedure removes snapshots from table metadata and
applies the table’s retention policy.
+<a href=#481 id=481 data-nosnippet>481</a></span><span class="kw">pub enum
</span>SnapshotRetention {
+<a href=#482 id=482 data-nosnippet>482</a> <span
class="attr">#[serde(rename_all = <span class="string">"kebab-case"</span>)]
+<a href=#483 id=483 data-nosnippet>483</a> </span><span
class="doccomment">/// Branches are mutable named references that can be
updated by committing a new snapshot as
+<a href=#484 id=484 data-nosnippet>484</a> /// the branch’s referenced
snapshot using the Commit Conflict Resolution and Retry procedures.
+<a href=#485 id=485 data-nosnippet>485</a> </span>Branch {
+<a href=#486 id=486 data-nosnippet>486</a> <span class="doccomment">///
A positive number for the minimum number of snapshots to keep in a branch while
expiring snapshots.
+<a href=#487 id=487 data-nosnippet>487</a> /// Defaults to table
property history.expire.min-snapshots-to-keep.
+<a href=#488 id=488 data-nosnippet>488</a> </span><span
class="attr">#[serde(skip_serializing_if = <span
class="string">"Option::is_none"</span>)]
+<a href=#489 id=489 data-nosnippet>489</a>
</span>min_snapshots_to_keep: <span class="prelude-ty">Option</span><i32>,
+<a href=#490 id=490 data-nosnippet>490</a> <span class="doccomment">///
A positive number for the max age of snapshots to keep when expiring, including
the latest snapshot.
+<a href=#491 id=491 data-nosnippet>491</a> /// Defaults to table
property history.expire.max-snapshot-age-ms.
+<a href=#492 id=492 data-nosnippet>492</a> </span><span
class="attr">#[serde(skip_serializing_if = <span
class="string">"Option::is_none"</span>)]
+<a href=#493 id=493 data-nosnippet>493</a> </span>max_snapshot_age_ms:
<span class="prelude-ty">Option</span><i64>,
+<a href=#494 id=494 data-nosnippet>494</a> <span class="doccomment">///
For snapshot references except the main branch, a positive number for the max
age of the snapshot reference to keep while expiring snapshots.
+<a href=#495 id=495 data-nosnippet>495</a> /// Defaults to table
property history.expire.max-ref-age-ms. The main branch never expires.
+<a href=#496 id=496 data-nosnippet>496</a> </span><span
class="attr">#[serde(skip_serializing_if = <span
class="string">"Option::is_none"</span>)]
+<a href=#497 id=497 data-nosnippet>497</a> </span>max_ref_age_ms: <span
class="prelude-ty">Option</span><i64>,
+<a href=#498 id=498 data-nosnippet>498</a> },
+<a href=#499 id=499 data-nosnippet>499</a> <span
class="attr">#[serde(rename_all = <span class="string">"kebab-case"</span>)]
+<a href=#500 id=500 data-nosnippet>500</a> </span><span
class="doccomment">/// Tags are labels for individual snapshots.
+<a href=#501 id=501 data-nosnippet>501</a> </span>Tag {
+<a href=#502 id=502 data-nosnippet>502</a> <span class="doccomment">///
For snapshot references except the main branch, a positive number for the max
age of the snapshot reference to keep while expiring snapshots.
+<a href=#503 id=503 data-nosnippet>503</a> /// Defaults to table
property history.expire.max-ref-age-ms. The main branch never expires.
+<a href=#504 id=504 data-nosnippet>504</a> </span><span
class="attr">#[serde(skip_serializing_if = <span
class="string">"Option::is_none"</span>)]
+<a href=#505 id=505 data-nosnippet>505</a> </span>max_ref_age_ms: <span
class="prelude-ty">Option</span><i64>,
+<a href=#506 id=506 data-nosnippet>506</a> },
+<a href=#507 id=507 data-nosnippet>507</a>}
+<a href=#508 id=508 data-nosnippet>508</a>
+<a href=#509 id=509 data-nosnippet>509</a><span class="kw">impl
</span>SnapshotRetention {
+<a href=#510 id=510 data-nosnippet>510</a> <span class="doccomment">///
Create a new branch retention policy
+<a href=#511 id=511 data-nosnippet>511</a> </span><span class="kw">pub fn
</span>branch(
+<a href=#512 id=512 data-nosnippet>512</a> min_snapshots_to_keep: <span
class="prelude-ty">Option</span><i32>,
+<a href=#513 id=513 data-nosnippet>513</a> max_snapshot_age_ms: <span
class="prelude-ty">Option</span><i64>,
+<a href=#514 id=514 data-nosnippet>514</a> max_ref_age_ms: <span
class="prelude-ty">Option</span><i64>,
+<a href=#515 id=515 data-nosnippet>515</a> ) -> <span class="self">Self
</span>{
+<a href=#516 id=516 data-nosnippet>516</a> SnapshotRetention::Branch {
+<a href=#517 id=517 data-nosnippet>517</a> min_snapshots_to_keep,
+<a href=#518 id=518 data-nosnippet>518</a> max_snapshot_age_ms,
+<a href=#519 id=519 data-nosnippet>519</a> max_ref_age_ms,
+<a href=#520 id=520 data-nosnippet>520</a> }
+<a href=#521 id=521 data-nosnippet>521</a> }
+<a href=#522 id=522 data-nosnippet>522</a>}
+<a href=#523 id=523 data-nosnippet>523</a>
+<a href=#524 id=524 data-nosnippet>524</a><span class="attr">#[cfg(test)]
+<a href=#525 id=525 data-nosnippet>525</a></span><span class="kw">mod
</span>tests {
+<a href=#526 id=526 data-nosnippet>526</a> <span class="kw">use
</span>std::collections::HashMap;
+<a href=#527 id=527 data-nosnippet>527</a>
+<a href=#528 id=528 data-nosnippet>528</a> <span class="kw">use
</span>chrono::{TimeZone, Utc};
+<a href=#529 id=529 data-nosnippet>529</a>
+<a href=#530 id=530 data-nosnippet>530</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::TableMetadata;
+<a href=#531 id=531 data-nosnippet>531</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::_serde::SnapshotV1;
+<a href=#532 id=532 data-nosnippet>532</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::{Operation, Snapshot,
Summary};
+<a href=#533 id=533 data-nosnippet>533</a>
+<a href=#534 id=534 data-nosnippet>534</a> <span class="attr">#[test]
+<a href=#535 id=535 data-nosnippet>535</a> </span><span class="kw">fn
</span>schema() {
+<a href=#536 id=536 data-nosnippet>536</a> <span class="kw">let
</span>record = <span class="string">r#"
+<a href=#537 id=537 data-nosnippet>537</a> {
+<a href=#538 id=538 data-nosnippet>538</a> "snapshot-id":
3051729675574597004,
+<a href=#539 id=539 data-nosnippet>539</a> "timestamp-ms":
1515100955770,
+<a href=#540 id=540 data-nosnippet>540</a> "summary": {
+<a href=#541 id=541 data-nosnippet>541</a> "operation": "append"
+<a href=#542 id=542 data-nosnippet>542</a> },
+<a href=#543 id=543 data-nosnippet>543</a> "manifest-list":
"s3://b/wh/.../s1.avro",
+<a href=#544 id=544 data-nosnippet>544</a> "schema-id": 0
+<a href=#545 id=545 data-nosnippet>545</a> }
+<a href=#546 id=546 data-nosnippet>546</a> "#</span>;
+<a href=#547 id=547 data-nosnippet>547</a>
+<a href=#548 id=548 data-nosnippet>548</a> <span class="kw">let
</span>result: Snapshot = serde_json::from_str::<SnapshotV1>(record)
+<a href=#549 id=549 data-nosnippet>549</a> .unwrap()
+<a href=#550 id=550 data-nosnippet>550</a> .try_into()
+<a href=#551 id=551 data-nosnippet>551</a> .unwrap();
+<a href=#552 id=552 data-nosnippet>552</a> <span
class="macro">assert_eq!</span>(<span
class="number">3051729675574597004</span>, result.snapshot_id());
+<a href=#553 id=553 data-nosnippet>553</a> <span
class="macro">assert_eq!</span>(
+<a href=#554 id=554 data-nosnippet>554</a>
Utc.timestamp_millis_opt(<span class="number">1515100955770</span>).unwrap(),
+<a href=#555 id=555 data-nosnippet>555</a>
result.timestamp().unwrap()
+<a href=#556 id=556 data-nosnippet>556</a> );
+<a href=#557 id=557 data-nosnippet>557</a> <span
class="macro">assert_eq!</span>(<span class="number">1515100955770</span>,
result.timestamp_ms());
+<a href=#558 id=558 data-nosnippet>558</a> <span
class="macro">assert_eq!</span>(
+<a href=#559 id=559 data-nosnippet>559</a> Summary {
+<a href=#560 id=560 data-nosnippet>560</a> operation:
Operation::Append,
+<a href=#561 id=561 data-nosnippet>561</a>
additional_properties: HashMap::new()
+<a href=#562 id=562 data-nosnippet>562</a> },
+<a href=#563 id=563 data-nosnippet>563</a> <span
class="kw-2">*</span>result.summary()
+<a href=#564 id=564 data-nosnippet>564</a> );
+<a href=#565 id=565 data-nosnippet>565</a> <span
class="macro">assert_eq!</span>(<span
class="string">"s3://b/wh/.../s1.avro"</span>.to_string(), <span
class="kw-2">*</span>result.manifest_list());
+<a href=#566 id=566 data-nosnippet>566</a> }
+<a href=#567 id=567 data-nosnippet>567</a>
+<a href=#568 id=568 data-nosnippet>568</a> <span class="attr">#[test]
+<a href=#569 id=569 data-nosnippet>569</a> </span><span class="kw">fn
</span>test_snapshot_v1_to_v2_projection() {
+<a href=#570 id=570 data-nosnippet>570</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::_serde::SnapshotV1;
+<a href=#571 id=571 data-nosnippet>571</a>
+<a href=#572 id=572 data-nosnippet>572</a> <span class="comment">//
Create a V1 snapshot (without sequence-number field)
+<a href=#573 id=573 data-nosnippet>573</a> </span><span class="kw">let
</span>v1_snapshot = SnapshotV1 {
+<a href=#574 id=574 data-nosnippet>574</a> snapshot_id: <span
class="number">1234567890</span>,
+<a href=#575 id=575 data-nosnippet>575</a> parent_snapshot_id:
<span class="prelude-val">Some</span>(<span class="number">987654321</span>),
+<a href=#576 id=576 data-nosnippet>576</a> timestamp_ms: <span
class="number">1515100955770</span>,
+<a href=#577 id=577 data-nosnippet>577</a> manifest_list: <span
class="prelude-val">Some</span>(<span
class="string">"s3://bucket/manifest-list.avro"</span>.to_string()),
+<a href=#578 id=578 data-nosnippet>578</a> manifests: <span
class="prelude-val">None</span>, <span class="comment">// V1 can have either
manifest_list or manifests, but not both
+<a href=#579 id=579 data-nosnippet>579</a> </span>summary: <span
class="prelude-val">Some</span>(Summary {
+<a href=#580 id=580 data-nosnippet>580</a> operation:
Operation::Append,
+<a href=#581 id=581 data-nosnippet>581</a>
additional_properties: HashMap::from([
+<a href=#582 id=582 data-nosnippet>582</a> (<span
class="string">"added-files"</span>.to_string(), <span
class="string">"5"</span>.to_string()),
+<a href=#583 id=583 data-nosnippet>583</a> (<span
class="string">"added-records"</span>.to_string(), <span
class="string">"100"</span>.to_string()),
+<a href=#584 id=584 data-nosnippet>584</a> ]),
+<a href=#585 id=585 data-nosnippet>585</a> }),
+<a href=#586 id=586 data-nosnippet>586</a> schema_id: <span
class="prelude-val">Some</span>(<span class="number">1</span>),
+<a href=#587 id=587 data-nosnippet>587</a> };
+<a href=#588 id=588 data-nosnippet>588</a>
+<a href=#589 id=589 data-nosnippet>589</a> <span class="comment">//
Convert V1 to V2 - this should apply defaults for missing V2 fields
+<a href=#590 id=590 data-nosnippet>590</a> </span><span class="kw">let
</span>v2_snapshot: Snapshot = v1_snapshot.try_into().unwrap();
+<a href=#591 id=591 data-nosnippet>591</a>
+<a href=#592 id=592 data-nosnippet>592</a> <span class="comment">//
Verify V1→V2 projection defaults are applied correctly
+<a href=#593 id=593 data-nosnippet>593</a> </span><span
class="macro">assert_eq!</span>(
+<a href=#594 id=594 data-nosnippet>594</a>
v2_snapshot.sequence_number(),
+<a href=#595 id=595 data-nosnippet>595</a> <span
class="number">0</span>,
+<a href=#596 id=596 data-nosnippet>596</a> <span class="string">"V1
snapshot sequence_number should default to 0"
+<a href=#597 id=597 data-nosnippet>597</a> </span>);
+<a href=#598 id=598 data-nosnippet>598</a>
+<a href=#599 id=599 data-nosnippet>599</a> <span class="comment">//
Verify other fields are preserved correctly during conversion
+<a href=#600 id=600 data-nosnippet>600</a> </span><span
class="macro">assert_eq!</span>(v2_snapshot.snapshot_id(), <span
class="number">1234567890</span>);
+<a href=#601 id=601 data-nosnippet>601</a> <span
class="macro">assert_eq!</span>(v2_snapshot.parent_snapshot_id(), <span
class="prelude-val">Some</span>(<span class="number">987654321</span>));
+<a href=#602 id=602 data-nosnippet>602</a> <span
class="macro">assert_eq!</span>(v2_snapshot.timestamp_ms(), <span
class="number">1515100955770</span>);
+<a href=#603 id=603 data-nosnippet>603</a> <span
class="macro">assert_eq!</span>(
+<a href=#604 id=604 data-nosnippet>604</a>
v2_snapshot.manifest_list(),
+<a href=#605 id=605 data-nosnippet>605</a> <span
class="string">"s3://bucket/manifest-list.avro"
+<a href=#606 id=606 data-nosnippet>606</a> </span>);
+<a href=#607 id=607 data-nosnippet>607</a> <span
class="macro">assert_eq!</span>(v2_snapshot.schema_id(), <span
class="prelude-val">Some</span>(<span class="number">1</span>));
+<a href=#608 id=608 data-nosnippet>608</a> <span
class="macro">assert_eq!</span>(v2_snapshot.summary().operation,
Operation::Append);
+<a href=#609 id=609 data-nosnippet>609</a> <span
class="macro">assert_eq!</span>(
+<a href=#610 id=610 data-nosnippet>610</a> v2_snapshot
+<a href=#611 id=611 data-nosnippet>611</a> .summary()
+<a href=#612 id=612 data-nosnippet>612</a>
.additional_properties
+<a href=#613 id=613 data-nosnippet>613</a> .get(<span
class="string">"added-files"</span>),
+<a href=#614 id=614 data-nosnippet>614</a> <span
class="prelude-val">Some</span>(<span class="kw-2">&</span><span
class="string">"5"</span>.to_string())
+<a href=#615 id=615 data-nosnippet>615</a> );
+<a href=#616 id=616 data-nosnippet>616</a> }
+<a href=#617 id=617 data-nosnippet>617</a>
+<a href=#618 id=618 data-nosnippet>618</a> <span class="attr">#[test]
+<a href=#619 id=619 data-nosnippet>619</a> </span><span class="kw">fn
</span>test_v1_snapshot_with_manifest_list_and_manifests() {
+<a href=#620 id=620 data-nosnippet>620</a> {
+<a href=#621 id=621 data-nosnippet>621</a> <span class="kw">let
</span>metadata = <span class="string">r#"
+<a href=#622 id=622 data-nosnippet>622</a> {
+<a href=#623 id=623 data-nosnippet>623</a> "format-version": 1,
+<a href=#624 id=624 data-nosnippet>624</a> "table-uuid":
"d20125c8-7284-442c-9aea-15fee620737c",
+<a href=#625 id=625 data-nosnippet>625</a> "location":
"s3://bucket/test/location",
+<a href=#626 id=626 data-nosnippet>626</a> "last-updated-ms":
1700000000000,
+<a href=#627 id=627 data-nosnippet>627</a> "last-column-id": 1,
+<a href=#628 id=628 data-nosnippet>628</a> "schema": {
+<a href=#629 id=629 data-nosnippet>629</a> "type": "struct",
+<a href=#630 id=630 data-nosnippet>630</a> "fields": [
+<a href=#631 id=631 data-nosnippet>631</a> {"id": 1, "name":
"x", "required": true, "type": "long"}
+<a href=#632 id=632 data-nosnippet>632</a> ]
+<a href=#633 id=633 data-nosnippet>633</a> },
+<a href=#634 id=634 data-nosnippet>634</a> "partition-spec": [],
+<a href=#635 id=635 data-nosnippet>635</a> "properties": {},
+<a href=#636 id=636 data-nosnippet>636</a> "current-snapshot-id":
111111111,
+<a href=#637 id=637 data-nosnippet>637</a> "snapshots": [
+<a href=#638 id=638 data-nosnippet>638</a> {
+<a href=#639 id=639 data-nosnippet>639</a> "snapshot-id":
111111111,
+<a href=#640 id=640 data-nosnippet>640</a> "timestamp-ms":
1600000000000,
+<a href=#641 id=641 data-nosnippet>641</a> "summary":
{"operation": "append"},
+<a href=#642 id=642 data-nosnippet>642</a> "manifest-list":
"s3://bucket/metadata/snap-123.avro",
+<a href=#643 id=643 data-nosnippet>643</a> "manifests":
["s3://bucket/metadata/manifest-1.avro"]
+<a href=#644 id=644 data-nosnippet>644</a> }
+<a href=#645 id=645 data-nosnippet>645</a> ]
+<a href=#646 id=646 data-nosnippet>646</a> }
+<a href=#647 id=647 data-nosnippet>647</a> "#</span>;
+<a href=#648 id=648 data-nosnippet>648</a>
+<a href=#649 id=649 data-nosnippet>649</a> <span class="kw">let
</span>result_both_manifest_list_and_manifest_set =
+<a href=#650 id=650 data-nosnippet>650</a>
serde_json::from_str::<TableMetadata>(metadata);
+<a href=#651 id=651 data-nosnippet>651</a> <span
class="macro">assert!</span>(result_both_manifest_list_and_manifest_set.is_err());
+<a href=#652 id=652 data-nosnippet>652</a> <span
class="macro">assert_eq!</span>(
+<a href=#653 id=653 data-nosnippet>653</a>
result_both_manifest_list_and_manifest_set
+<a href=#654 id=654 data-nosnippet>654</a> .unwrap_err()
+<a href=#655 id=655 data-nosnippet>655</a> .to_string(),
+<a href=#656 id=656 data-nosnippet>656</a> <span
class="string">"DataInvalid => Invalid v1 snapshot, when manifest list
provided, manifest files should be omitted"
+<a href=#657 id=657 data-nosnippet>657</a> </span>)
+<a href=#658 id=658 data-nosnippet>658</a> }
+<a href=#659 id=659 data-nosnippet>659</a>
+<a href=#660 id=660 data-nosnippet>660</a> {
+<a href=#661 id=661 data-nosnippet>661</a> <span class="kw">let
</span>metadata = <span class="string">r#"
+<a href=#662 id=662 data-nosnippet>662</a> {
+<a href=#663 id=663 data-nosnippet>663</a> "format-version": 1,
+<a href=#664 id=664 data-nosnippet>664</a> "table-uuid":
"d20125c8-7284-442c-9aea-15fee620737c",
+<a href=#665 id=665 data-nosnippet>665</a> "location":
"s3://bucket/test/location",
+<a href=#666 id=666 data-nosnippet>666</a> "last-updated-ms":
1700000000000,
+<a href=#667 id=667 data-nosnippet>667</a> "last-column-id": 1,
+<a href=#668 id=668 data-nosnippet>668</a> "schema": {
+<a href=#669 id=669 data-nosnippet>669</a> "type": "struct",
+<a href=#670 id=670 data-nosnippet>670</a> "fields": [
+<a href=#671 id=671 data-nosnippet>671</a> {"id": 1, "name":
"x", "required": true, "type": "long"}
+<a href=#672 id=672 data-nosnippet>672</a> ]
+<a href=#673 id=673 data-nosnippet>673</a> },
+<a href=#674 id=674 data-nosnippet>674</a> "partition-spec": [],
+<a href=#675 id=675 data-nosnippet>675</a> "properties": {},
+<a href=#676 id=676 data-nosnippet>676</a> "current-snapshot-id":
111111111,
+<a href=#677 id=677 data-nosnippet>677</a> "snapshots": [
+<a href=#678 id=678 data-nosnippet>678</a> {
+<a href=#679 id=679 data-nosnippet>679</a> "snapshot-id":
111111111,
+<a href=#680 id=680 data-nosnippet>680</a> "timestamp-ms":
1600000000000,
+<a href=#681 id=681 data-nosnippet>681</a> "summary":
{"operation": "append"},
+<a href=#682 id=682 data-nosnippet>682</a> "manifests":
["s3://bucket/metadata/manifest-1.avro"]
+<a href=#683 id=683 data-nosnippet>683</a> }
+<a href=#684 id=684 data-nosnippet>684</a> ]
+<a href=#685 id=685 data-nosnippet>685</a> }
+<a href=#686 id=686 data-nosnippet>686</a> "#</span>;
+<a href=#687 id=687 data-nosnippet>687</a> <span class="kw">let
</span>result_missing_manifest_list =
serde_json::from_str::<TableMetadata>(metadata);
+<a href=#688 id=688 data-nosnippet>688</a> <span
class="macro">assert!</span>(result_missing_manifest_list.is_err());
+<a href=#689 id=689 data-nosnippet>689</a> <span
class="macro">assert_eq!</span>(
+<a href=#690 id=690 data-nosnippet>690</a>
result_missing_manifest_list.unwrap_err().to_string(),
+<a href=#691 id=691 data-nosnippet>691</a> <span
class="string">"DataInvalid => Unsupported v1 snapshot, only manifest list
is supported"
+<a href=#692 id=692 data-nosnippet>692</a> </span>)
+<a href=#693 id=693 data-nosnippet>693</a> }
+<a href=#694 id=694 data-nosnippet>694</a> }
+<a href=#695 id=695 data-nosnippet>695</a>
+<a href=#696 id=696 data-nosnippet>696</a> <span class="attr">#[test]
+<a href=#697 id=697 data-nosnippet>697</a> </span><span class="kw">fn
</span>test_snapshot_v1_to_v2_with_missing_summary() {
+<a href=#698 id=698 data-nosnippet>698</a> <span class="kw">use
</span><span class="kw">crate</span>::spec::snapshot::_serde::SnapshotV1;
+<a href=#699 id=699 data-nosnippet>699</a>
+<a href=#700 id=700 data-nosnippet>700</a> <span class="comment">//
Create a V1 snapshot without summary (should get default)
+<a href=#701 id=701 data-nosnippet>701</a> </span><span class="kw">let
</span>v1_snapshot = SnapshotV1 {
+<a href=#702 id=702 data-nosnippet>702</a> snapshot_id: <span
class="number">1111111111</span>,
+<a href=#703 id=703 data-nosnippet>703</a> parent_snapshot_id:
<span class="prelude-val">None</span>,
+<a href=#704 id=704 data-nosnippet>704</a> timestamp_ms: <span
class="number">1515100955770</span>,
+<a href=#705 id=705 data-nosnippet>705</a> manifest_list: <span
class="prelude-val">Some</span>(<span
class="string">"s3://bucket/manifest-list.avro"</span>.to_string()),
+<a href=#706 id=706 data-nosnippet>706</a> manifests: <span
class="prelude-val">None</span>,
+<a href=#707 id=707 data-nosnippet>707</a> summary: <span
class="prelude-val">None</span>, <span class="comment">// V1 summary is optional
+<a href=#708 id=708 data-nosnippet>708</a> </span>schema_id: <span
class="prelude-val">None</span>,
+<a href=#709 id=709 data-nosnippet>709</a> };
+<a href=#710 id=710 data-nosnippet>710</a>
+<a href=#711 id=711 data-nosnippet>711</a> <span class="comment">//
Convert V1 to V2 - this should apply default summary
+<a href=#712 id=712 data-nosnippet>712</a> </span><span class="kw">let
</span>v2_snapshot: Snapshot = v1_snapshot.try_into().unwrap();
+<a href=#713 id=713 data-nosnippet>713</a>
+<a href=#714 id=714 data-nosnippet>714</a> <span class="comment">//
Verify defaults are applied correctly
+<a href=#715 id=715 data-nosnippet>715</a> </span><span
class="macro">assert_eq!</span>(
+<a href=#716 id=716 data-nosnippet>716</a>
v2_snapshot.sequence_number(),
+<a href=#717 id=717 data-nosnippet>717</a> <span
class="number">0</span>,
+<a href=#718 id=718 data-nosnippet>718</a> <span class="string">"V1
snapshot sequence_number should default to 0"
+<a href=#719 id=719 data-nosnippet>719</a> </span>);
+<a href=#720 id=720 data-nosnippet>720</a> <span
class="macro">assert_eq!</span>(
+<a href=#721 id=721 data-nosnippet>721</a>
v2_snapshot.summary().operation,
+<a href=#722 id=722 data-nosnippet>722</a> Operation::Append,
+<a href=#723 id=723 data-nosnippet>723</a> <span
class="string">"Missing V1 summary should default to Append operation"
+<a href=#724 id=724 data-nosnippet>724</a> </span>);
+<a href=#725 id=725 data-nosnippet>725</a> <span
class="macro">assert!</span>(
+<a href=#726 id=726 data-nosnippet>726</a>
v2_snapshot.summary().additional_properties.is_empty(),
+<a href=#727 id=727 data-nosnippet>727</a> <span
class="string">"Default summary should have empty additional_properties"
+<a href=#728 id=728 data-nosnippet>728</a> </span>);
+<a href=#729 id=729 data-nosnippet>729</a>
+<a href=#730 id=730 data-nosnippet>730</a> <span class="comment">//
Verify other fields
+<a href=#731 id=731 data-nosnippet>731</a> </span><span
class="macro">assert_eq!</span>(v2_snapshot.snapshot_id(), <span
class="number">1111111111</span>);
+<a href=#732 id=732 data-nosnippet>732</a> <span
class="macro">assert_eq!</span>(v2_snapshot.parent_snapshot_id(), <span
class="prelude-val">None</span>);
+<a href=#733 id=733 data-nosnippet>733</a> <span
class="macro">assert_eq!</span>(v2_snapshot.schema_id(), <span
class="prelude-val">None</span>);
+<a href=#734 id=734 data-nosnippet>734</a> }
+<a href=#735 id=735
data-nosnippet>735</a>}</code></pre></div></section></main></body></html>
\ No newline at end of file
