This is an automated email from the ASF dual-hosted git repository.
blue pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/iceberg.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 839f01a Deployed 349e8e304 with MkDocs version: 1.0.4
839f01a is described below
commit 839f01ab5909876a1006ed84b2bfd8c380350837
Author: Ryan Blue <[email protected]>
AuthorDate: Tue Jul 14 16:21:05 2020 -0800
Deployed 349e8e304 with MkDocs version: 1.0.4
---
index.html | 2 +-
sitemap.xml.gz | Bin 225 -> 225 bytes
spark/index.html | 10 ++++++++++
3 files changed, 11 insertions(+), 1 deletion(-)
diff --git a/index.html b/index.html
index 0802de4..9afbb06 100644
--- a/index.html
+++ b/index.html
@@ -460,5 +460,5 @@
<!--
MkDocs version : 1.0.4
-Build Date UTC : 2020-07-15 00:15:47
+Build Date UTC : 2020-07-15 00:21:05
-->
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index b3daa55..c42c7b2 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ
diff --git a/spark/index.html b/spark/index.html
index d582668..c91f4c9 100644
--- a/spark/index.html
+++ b/spark/index.html
@@ -678,6 +678,11 @@ ALTER TABLE prod.db.sample DROP COLUMN point.z
.table("prod.db.table")
</code></pre>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>When reading with DataFrames in Spark 3, use <code>table</code> to load a
table by name from a catalog.
+Using <code>format("iceberg")</code> loads an isolated table reference that is
not refreshed when other queries update the table.</p>
+</div>
<h3 id="time-travel">Time travel<a class="headerlink" href="#time-travel"
title="Permanent link">¶</a></h3>
<p>To select a specific table snapshot or the snapshot at some time, Iceberg
supports two Spark read options:</p>
<ul>
@@ -790,6 +795,11 @@ WHERE ts >= '2020-05-01 00:00:00' and ts <
'2020-06-01 00:00:00'
</ul>
</li>
</ul>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>When writing with the v1 DataFrame API in Spark 3, use
<code>saveAsTable</code> or <code>insertInto</code> to load tables with a
catalog.
+Using <code>format("iceberg")</code> loads an isolated table reference that
will not refresh tables used by queries.</p>
+</div>
<h3 id="appending-data">Appending data<a class="headerlink"
href="#appending-data" title="Permanent link">¶</a></h3>
<p>To append a dataframe to an Iceberg table, use <code>append</code>:</p>
<pre><code class="scala">val data: DataFrame = ...