You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@orc.apache.org by om...@apache.org on 2016/08/12 21:49:00 UTC

orc git commit: Update site with documentation for -raw on orc-metadata.

Repository: orc
Updated Branches:
  refs/heads/asf-site 65ec6aaf4 -> 431994ed2


Update site with documentation for -raw on orc-metadata.


Project: http://git-wip-us.apache.org/repos/asf/orc/repo
Commit: http://git-wip-us.apache.org/repos/asf/orc/commit/431994ed
Tree: http://git-wip-us.apache.org/repos/asf/orc/tree/431994ed
Diff: http://git-wip-us.apache.org/repos/asf/orc/diff/431994ed

Branch: refs/heads/asf-site
Commit: 431994ed22fb85240f0941f283231539f7940eab
Parents: 65ec6aa
Author: Owen O'Malley <om...@apache.org>
Authored: Fri Aug 12 14:48:27 2016 -0700
Committer: Owen O'Malley <om...@apache.org>
Committed: Fri Aug 12 14:48:27 2016 -0700

----------------------------------------------------------------------
 docs/tools.html | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/orc/blob/431994ed/docs/tools.html
----------------------------------------------------------------------
diff --git a/docs/tools.html b/docs/tools.html
index 3be5efc..d11e938 100644
--- a/docs/tools.html
+++ b/docs/tools.html
@@ -1097,10 +1097,14 @@ the line breaks within each record):</p>
 <h2 id="orc-metadata">orc-metadata</h2>
 
 <p>Displays the metadata of the ORC file as a JSON document. With the
-<code>verbose</code> argument additional information about the layout of the file
+<code>verbose</code> option additional information about the layout of the file
 is also printed.</p>
 
-<pre><code class="language-shell">% orc-metadata [-v] &lt;filename&gt;
+<p>For diagnosing problems, it is useful to use the \u2018\u2013raw\u2019 option that
+prints the protocol buffers from the ORC file directly rather than
+interpreting them.</p>
+
+<pre><code class="language-shell">% orc-metadata [-v] [--raw] &lt;filename&gt;
 </code></pre>
 
 <p>If you run it on the example file TestOrcFile.test1.orc, you\u2019ll see:</p>
@@ -1130,11 +1134,11 @@ string,struct&lt;int1:int,string1:string&gt;&gt;&gt;",
 }
 </code></pre>
 
-<h2 id="file-dump">file-dump</h2>
+<h2 id="java-metadata">Java Metadata</h2>
 
 <p>The org.apache.orc.tools.FileDump Java class, which is available via Hive as:</p>
 
-<pre><code class="language-shell">% hive --orcfiledump [-j] [-p] [-d] [-t] [--rowindex &lt;cols&gt;]
+<pre><code class="language-shell">% java -jar orc-tools-*.jar meta [-j] [-p] [-t] [--rowindex &lt;cols&gt;]
        [--recover] [--skip-dump] [--backup-path &lt;new path&gt;] &lt;file&gt;
 </code></pre>
 
@@ -1143,8 +1147,6 @@ string,struct&lt;int1:int,string1:string&gt;&gt;&gt;",
   <dd>format the output in JSON</dd>
   <dt>-p</dt>
   <dd>pretty print the output</dd>
-  <dt>-d</dt>
-  <dd>print the data instead of the metadata</dd>
   <dt>-t</dt>
   <dd>print the timezone of the writer</dd>
   <dt>\u2013rowindex</dt>
@@ -1159,7 +1161,7 @@ string,struct&lt;int1:int,string1:string&gt;&gt;&gt;",
 
 <p>An example of the output is given below:</p>
 
-<pre><code class="language-shell">% hive --orcfiledump examples/TestOrcFile.test1.orc
+<pre><code class="language-shell">% java -jar orc-tools-*.jar meta examples/TestOrcFile.test1.orc
 Processing data file examples/TestOrcFile.test1.orc [length: 1711]
 Structure for examples/TestOrcFile.test1.orc
 File Version: 0.12 with HIVE_8732