Repository: incubator-impala
Updated Branches:
  refs/heads/doc_prototype df2755d76 -> 4303a448a


Updating some outdated introductory wording.


Project: http://git-wip-us.apache.org/repos/asf/incubator-impala/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-impala/commit/4303a448
Tree: http://git-wip-us.apache.org/repos/asf/incubator-impala/tree/4303a448
Diff: http://git-wip-us.apache.org/repos/asf/incubator-impala/diff/4303a448

Branch: refs/heads/doc_prototype
Commit: 4303a448a352cc58cf52eeca6cd7fff817e2b7c5
Parents: df2755d
Author: John Russell <[email protected]>
Authored: Mon Oct 31 15:28:46 2016 -0700
Committer: John Russell <[email protected]>
Committed: Mon Oct 31 15:28:46 2016 -0700

----------------------------------------------------------------------
 docs/shared/impala_common.xml      |  9 +++++----
 docs/topics/impala_development.xml | 10 ++++++----
 2 files changed, 11 insertions(+), 8 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-impala/blob/4303a448/docs/shared/impala_common.xml
----------------------------------------------------------------------
diff --git a/docs/shared/impala_common.xml b/docs/shared/impala_common.xml
index f281318..cdde360 100644
--- a/docs/shared/impala_common.xml
+++ b/docs/shared/impala_common.xml
@@ -2564,15 +2564,16 @@ select * from header_line limit 10;
           <li>
             Most common SQL-92 features of Hive Query Language (HiveQL) 
including
             <xref href="../topics/impala_select.xml#select">SELECT</xref>,
-            <xref href="../topics/impala_joins.xml#joins">joins</xref>, and 
aggregate functions.
+            <xref href="../topics/impala_joins.xml#joins">joins</xref>, and
+            <xref 
href="../topics/impala_aggregate_functions.xml#aggregate_functions">aggregate 
functions</xref>.
           </li>
 
           <li>
             HDFS, HBase, <ph rev="2.2.0">and Amazon Simple Storage System 
(S3)</ph> storage, including:
             <ul>
               <li>
-                <xref 
href="../topics/impala_file_formats.xml#file_formats">HDFS file formats</xref>: 
Text file,
-                SequenceFile, RCFile, Avro file, and Parquet.
+                <xref 
href="../topics/impala_file_formats.xml#file_formats">HDFS file formats</xref>: 
delimited text files, Parquet,
+                Avro, SequenceFile, and RCFile.
               </li>
 
               <li>
@@ -2599,7 +2600,7 @@ select * from header_line limit 10;
           </li>
 
           <li>
-            Impala <xref 
href="../topics/impala_impala_shell.xml#impala_shell">command-line 
interface</xref>.
+            <xref 
href="../topics/impala_impala_shell.xml#impala_shell">impala-shell command-line 
interface</xref>.
           </li>
 
           <li>

http://git-wip-us.apache.org/repos/asf/incubator-impala/blob/4303a448/docs/topics/impala_development.xml
----------------------------------------------------------------------
diff --git a/docs/topics/impala_development.xml 
b/docs/topics/impala_development.xml
index a2eef16..1b35046 100644
--- a/docs/topics/impala_development.xml
+++ b/docs/topics/impala_development.xml
@@ -54,7 +54,7 @@
       <ul>
         <li>
           <p>
-            The <codeph>SELECT</codeph> statement includes familiar clauses 
such as <codeph>WHERE</codeph>,
+            The <xref href="impala_select.xml#select">SELECT statement</xref> 
includes familiar clauses such as <codeph>WHERE</codeph>,
             <codeph>GROUP BY</codeph>, <codeph>ORDER BY</codeph>, and 
<codeph>WITH</codeph>.
             You will find familiar notions such as
             <xref href="impala_joins.xml#joins">joins</xref>, <xref 
href="impala_functions.xml#builtins">built-in
@@ -109,8 +109,10 @@
           All data creation is done by <codeph>INSERT</codeph> statements, 
which typically insert data in bulk by
           querying from other tables. There are two variations, <codeph>INSERT 
INTO</codeph> which appends to the
           existing data, and <codeph>INSERT OVERWRITE</codeph> which replaces 
the entire contents of a table or
-          partition (similar to <codeph>TRUNCATE TABLE</codeph> followed by a 
new <codeph>INSERT</codeph>). There
-          is no <codeph>INSERT ... VALUES</codeph> syntax to insert a single 
row.
+          partition (similar to <codeph>TRUNCATE TABLE</codeph> followed by a 
new <codeph>INSERT</codeph>).
+          Although there is an <codeph>INSERT ... VALUES</codeph> syntax to 
create a small number of values in
+          a single statement, it is far more efficient to use the 
<codeph>INSERT ... SELECT</codeph> to copy
+          and transform large amounts of data from one table to another in a 
single operation.
           </p>
         </li>
 
@@ -137,7 +139,7 @@
         <li>
           <p>
           Because Impala reads large quantities of data that might not be 
perfectly tidy and predictable, it does
-          not impose length constraints on string data types. For example, you 
can define a database column as
+          not require length constraints on string data types. For example, 
you can define a database column as
           <codeph>STRING</codeph> with unlimited length, rather than 
<codeph>CHAR(1)</codeph> or
           <codeph>VARCHAR(64)</codeph>. <ph rev="2.0.0">(Although in Impala 
2.0 and later, you can also use
           length-constrained <codeph>CHAR</codeph> and 
<codeph>VARCHAR</codeph> types.)</ph>

Reply via email to