You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@impala.apache.org by ar...@apache.org on 2019/07/23 23:10:12 UTC

[impala] 01/03: IMPALA-8746: [DOCS] Document the DEFAULT_HINTS_INSERT_STATEMENT query option

This is an automated email from the ASF dual-hosted git repository.

arodoni pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/impala.git

commit 55e52287e7d8fb9f3a22a70c26627eabdcaa48d0
Author: Alex Rodoni <ar...@cloudera.com>
AuthorDate: Fri Jul 19 15:06:29 2019 -0700

    IMPALA-8746: [DOCS] Document the DEFAULT_HINTS_INSERT_STATEMENT query option
    
    Change-Id: Ia376721f46eb507901f9f64b5c3341dc0f36475b
    Reviewed-on: http://gerrit.cloudera.org:8080/13885
    Tested-by: Impala Public Jenkins <im...@cloudera.com>
    Reviewed-by: Bharath Vissapragada <bh...@cloudera.com>
---
 docs/impala.ditamap                                |  1 +
 .../impala_default_hints_insert_statement.xml      | 81 ++++++++++++++++++++++
 2 files changed, 82 insertions(+)

diff --git a/docs/impala.ditamap b/docs/impala.ditamap
index 306263f..5e3bae1 100644
--- a/docs/impala.ditamap
+++ b/docs/impala.ditamap
@@ -179,6 +179,7 @@ under the License.
           <topicref href="topics/impala_debug_action.xml"/>
           <topicref rev="2.9.0" href="topics/impala_decimal_v2.xml"/>
           <topicref rev="3.2.0" href="topics/impala_default_file_format.xml"/>
+          <topicref rev="3.3.0" href="topics/impala_default_hints_insert_statement.xml"/>
           <topicref rev="2.9.0 IMPALA-5381" href="topics/impala_default_join_distribution_mode.xml"/>
           <topicref rev="2.10.0 IMPALA-3200" href="topics/impala_default_spillable_buffer_size.xml"/>
           <topicref href="topics/impala_disable_codegen.xml"/>
diff --git a/docs/topics/impala_default_hints_insert_statement.xml b/docs/topics/impala_default_hints_insert_statement.xml
new file mode 100644
index 0000000..ef2584f
--- /dev/null
+++ b/docs/topics/impala_default_hints_insert_statement.xml
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="default_hints_insert_statement">
+
+  <title>DEFAULT_HINTS_INSERT_STATEMENT Query Option</title>
+
+  <titlealts audience="PDF">
+
+    <navtitle>DEFAULT_HINTS_INSERT_STATEMENT</navtitle>
+
+  </titlealts>
+
+  <prolog>
+    <metadata>
+      <data name="Category" value="Impala"/>
+      <data name="Category" value="Impala Query Options"/>
+    </metadata>
+  </prolog>
+
+  <conbody>
+
+    <p>
+      The <codeph>DEFAULT_HINTS_INSERT_STATEMENT</codeph> query option sets the default hints
+      for the <codeph>INSERT</codeph> statements with no optimizer hint specified.
+    </p>
+
+    <p>
+      When there are hints specified in an <codeph>INSERT</codeph> statement, these default
+      hints are ignored.
+    </p>
+
+    <p>
+      You can specify multiple hints separated by '<codeph>:</codeph>'.
+    </p>
+
+    <p>
+      For example:
+    </p>
+
+<codeblock>SET DEFAULT_HINTS_INSERT_STATEMENT=CLUSTERED;
+SET DEFAULT_HINTS_INSERT_STATEMENT=SHUFFLE;
+SET DEFAULT_HINTS_INSERT_STATEMENT=NOCLUSTERED:NOSHUFFLE; </codeblock>
+
+    <p>
+      The default hints apply to the HDFS and Kudu table formats and are ignored for the HBase
+      table format.
+    </p>
+
+    <p>
+      <b>Type:</b> <codeph>STRING</codeph>
+    </p>
+
+    <p>
+      <b>Default:</b> none
+    </p>
+
+    <p>
+      <b>Added in:</b> <keyword keyref="impala33"/>
+    </p>
+
+  </conbody>
+
+</concept>