This is an automated email from the ASF dual-hosted git repository.
tarmstrong pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/impala.git
commit d7a0690142c5d965389a5a62b64a649d2619ffa2
Author: Alex Rodoni <arod...@cloudera.com>
AuthorDate: Tue Feb 5 16:50:29 2019 -0800
IMPALA-8044: [DOCS] Document REFRESH AUTHORIZATION statement
Change-Id: Ibbb1661affc01c72db8f76bd97d356c802ed9680
Reviewed-on: http://gerrit.cloudera.org:8080/12378
Tested-by: Impala Public Jenkins <impala-public-jenk...@cloudera.com>
Reviewed-by: Fredy Wijaya <fwij...@cloudera.com>
---
docs/impala.ditamap | 1 +
docs/shared/impala_common.xml | 5 ++
docs/topics/impala_refresh_authorization.xml | 75 ++++++++++++++++++++++++++++
3 files changed, 81 insertions(+)
diff --git a/docs/impala.ditamap b/docs/impala.ditamap
index bf14702..ad6b89f 100644
--- a/docs/impala.ditamap
+++ b/docs/impala.ditamap
@@ -152,6 +152,7 @@ under the License.
<topicref href="topics/impala_invalidate_metadata.xml"/>
<topicref href="topics/impala_load_data.xml"/>
<topicref href="topics/impala_refresh.xml"/>
+ <topicref href="topics/impala_refresh_authorization.xml"/>
<topicref href="topics/impala_refresh_functions.xml"/>
<topicref href="topics/impala_revoke.xml"/>
<topicref href="topics/impala_select.xml">
diff --git a/docs/shared/impala_common.xml b/docs/shared/impala_common.xml
index bfe8a24..3c11f68 100644
--- a/docs/shared/impala_common.xml
+++ b/docs/shared/impala_common.xml
@@ -383,6 +383,11 @@ under the License.
<entry>TABLE</entry>
</row>
<row>
+ <entry>REFRESH AUTHORIZATION</entry>
+ <entry>REFRESH</entry>
+ <entry>SERVER</entry>
+ </row>
+ <row>
<entry>REFRESH FUNCTIONS</entry>
<entry>REFRESH</entry>
<entry>DATABASE</entry>
diff --git a/docs/topics/impala_refresh_authorization.xml
b/docs/topics/impala_refresh_authorization.xml
new file mode 100644
index 0000000..cac4cd3
--- /dev/null
+++ b/docs/topics/impala_refresh_authorization.xml
@@ -0,0 +1,75 @@
+<?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="refresh_authorization">
+
+ <title>REFRESH AUTHORIZATION Statement</title>
+
+ <titlealts audience="PDF">
+
+ <navtitle>REFRESH AUTHORIZATION</navtitle>
+
+ </titlealts>
+
+ <prolog>
+ <metadata>
+ <data name="Category" value="Impala"/>
+ <data name="Category" value="SQL"/>
+ <data name="Category" value="DDL"/>
+ <data name="Category" value="Security"/>
+ </metadata>
+ </prolog>
+
+ <conbody>
+
+ <p>
+ The <codeph>REFRESH AUTHORIZATION</codeph> statement explicitly
refreshes authorization
+ data, including privileges and principals. When there is an external
update to
+ authorization metadata, use this statement to force Impala to refresh
its authorization
+ data without having to wait for the Sentry polling or run
<codeph>INVALIDATE
+ METADATA</codeph>.
+ </p>
+
+ <p>
+ Once issued, the <codeph>REFRESH AUTHORIZATION</codeph> statement cannot
be cancelled.
+ </p>
+
+ <p>
+ See <xref href="impala_authorization.xml#authorization">Impala
Authorization</xref> for
+ information on enabling and using authorization in Impala.
+ </p>
+
+ <p>
+ <b>Syntax:</b>
+ </p>
+
+<codeblock>REFRESH AUTHORIZATION</codeblock>
+
+ <p>
+ <b>Usage notes:</b> If authorization is not enabled, Impala returns an
error.
+ </p>
+
+ <p>
+ <b>Added in:</b> Impala 3.2
+ </p>
+
+ </conbody>
+
+</concept>
