You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@impala.apache.org by ta...@apache.org on 2018/06/07 17:12:31 UTC

[08/10] impala git commit: IMPALA-5380: [DOCS] Added additional filesystems supported in URI

IMPALA-5380: [DOCS] Added additional filesystems supported in URI

Change-Id: I11d57efd564fb5779539a88d7b209cee93d313c6
Reviewed-on: http://gerrit.cloudera.org:8080/10551
Reviewed-by: Lars Volker <lv...@cloudera.com>
Tested-by: Impala Public Jenkins <im...@cloudera.com>


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

Branch: refs/heads/2.x
Commit: 9ce35cf1b41213158767b3692a6452122eefd512
Parents: 66a3685
Author: Alex Rodoni <ar...@cloudera.com>
Authored: Wed May 30 17:02:20 2018 -0700
Committer: Impala Public Jenkins <im...@gerrit.cloudera.org>
Committed: Thu Jun 7 11:10:16 2018 +0000

----------------------------------------------------------------------
 docs/topics/impala_authorization.xml | 45 ++++++++++++++++++++++---------
 1 file changed, 33 insertions(+), 12 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/impala/blob/9ce35cf1/docs/topics/impala_authorization.xml
----------------------------------------------------------------------
diff --git a/docs/topics/impala_authorization.xml b/docs/topics/impala_authorization.xml
index fe5faa9..4e4a243 100644
--- a/docs/topics/impala_authorization.xml
+++ b/docs/topics/impala_authorization.xml
@@ -899,11 +899,13 @@ Database
       </p>
 
       <p>
-        URIs represent the HDFS paths you specify as part of statements such as <codeph>CREATE EXTERNAL
-        TABLE</codeph> and <codeph>LOAD DATA</codeph>. Typically, you specify what look like UNIX paths, but these
-        locations can also be prefixed with <codeph>hdfs://</codeph> to make clear that they are really URIs. To
-        set privileges for a URI, specify the name of a directory, and the privilege applies to all the files in
-        that directory and any directories underneath it.
+        URIs represent the file paths you specify as part of statements such
+        as <codeph>CREATE EXTERNAL TABLE</codeph> and <codeph>LOAD
+        DATA</codeph>. Typically, you specify what look like UNIX paths, but
+        these locations can also be prefixed with <codeph>hdfs://</codeph> to
+        make clear that they are really URIs. To set privileges for a URI,
+        specify the name of a directory, and the privilege applies to all the
+        files in that directory and any directories underneath it.
       </p>
 
       <p rev="2.3.0 collevelauth">
@@ -916,18 +918,37 @@ Database
       </p>
 
       <p>
-        URIs must start with either <codeph>hdfs://</codeph> or <codeph>file://</codeph>. If a URI starts with
-        anything else, it will cause an exception and the policy file will be invalid. When defining URIs for HDFS,
-        you must also specify the NameNode. For example:
-<codeblock>data_read = server=server1-&gt;uri=file:///path/to/dir, \
+        URIs must start with <codeph>hdfs://</codeph>,
+        <codeph>s3a://</codeph>, <codeph>adl://</codeph>, or
+          <codeph>file://</codeph>. If a URI starts with an absolute path, the
+        path will be appended to the default filesystem prefix. For example, if
+        you specify:
+<codeblock>
+GRANT ALL ON URI '/tmp';
+</codeblock> The above
+        statement effectively becomes the following where the default filesystem
+        is HDFS.
+<codeblock>
+GRANT ALL ON URI 'hdfs://localhost:20500/tmp';
+</codeblock>
+      </p>
+
+      <p>
+        When defining URIs for HDFS, you must also specify the NameNode. For
+        example:
+<codeblock>
+data_read = server=server1-&gt;uri=file:///path/to/dir, \
 server=server1-&gt;uri=hdfs://namenode:port/path/to/dir
 </codeblock>
         <note type="warning">
           <p>
-            Because the NameNode host and port must be specified, enable High Availability (HA) to ensure
-            that the URI will remain constant even if the NameNode changes.
+            Because the NameNode host and port must be specified, enable High
+            Availability (HA) to ensure that the URI will remain constant even
+            if the NameNode changes.
           </p>
-<codeblock>data_read = server=server1-&gt;uri=file:///path/to/dir,\ server=server1-&gt;uri=hdfs://ha-nn-uri/path/to/dir
+<codeblock>
+data_read = server=server1-&gt;uri=file:///path/to/dir, \
+server=server1-&gt;uri=hdfs://ha-nn-uri/path/to/dir
 </codeblock>
         </note>
       </p>