You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@zeppelin.apache.org by mi...@apache.org on 2017/09/21 20:34:02 UTC
svn commit: r1809223 [20/30] - in /zeppelin/site: ./ contribution/
contribution/zeppelinweb/ docs/0.7.3/ docs/0.7.3/assets/
docs/0.7.3/assets/themes/ docs/0.7.3/assets/themes/zeppelin/
docs/0.7.3/assets/themes/zeppelin/bootstrap/ docs/0.7.3/assets/them...
Added: zeppelin/site/docs/0.7.3/interpreter/spark.html
URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.3/interpreter/spark.html?rev=1809223&view=auto
==============================================================================
--- zeppelin/site/docs/0.7.3/interpreter/spark.html (added)
+++ zeppelin/site/docs/0.7.3/interpreter/spark.html Thu Sep 21 20:33:57 2017
@@ -0,0 +1,657 @@
+
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <title>Apache Zeppelin 0.7.3 Documentation: Apache Spark Interpreter for Apache Zeppelin</title>
+ <meta name="description" content="Apache Spark is a fast and general-purpose cluster computing system. It provides high-level APIs in Java, Scala, Python and R, and an optimized engine that supports general execution engine.">
+ <meta name="author" content="The Apache Software Foundation">
+
+ <!-- Enable responsive viewport -->
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+ <!--[if lt IE 9]>
+ <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+ <![endif]-->
+
+ <link href="//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+
+ <!-- Le styles -->
+ <link href="/docs/0.7.3/assets/themes/zeppelin/bootstrap/css/bootstrap.css" rel="stylesheet">
+ <link href="/docs/0.7.3/assets/themes/zeppelin/css/style.css?body=1" rel="stylesheet" type="text/css">
+ <link href="/docs/0.7.3/assets/themes/zeppelin/css/syntax.css" rel="stylesheet" type="text/css" media="screen" />
+ <!-- Le fav and touch icons -->
+ <!-- Update these with your own images
+ <link rel="shortcut icon" href="images/favicon.ico">
+ <link rel="apple-touch-icon" href="images/apple-touch-icon.png">
+ <link rel="apple-touch-icon" sizes="72x72" href="images/apple-touch-icon-72x72.png">
+ <link rel="apple-touch-icon" sizes="114x114" href="images/apple-touch-icon-114x114.png">
+ -->
+
+ <!-- Js -->
+ <script src="https://code.jquery.com/jquery-1.10.2.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/bootstrap/js/bootstrap.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/docs.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/anchor.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/toc.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/lunr.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/search.js"></script>
+
+ <!-- atom & rss feed -->
+ <link href="/docs/0.7.3/atom.xml" type="application/atom+xml" rel="alternate" title="Sitewide ATOM Feed">
+ <link href="/docs/0.7.3/rss.xml" type="application/rss+xml" rel="alternate" title="Sitewide RSS Feed">
+ </head>
+
+ <body>
+
+ <div id="menu" class="navbar navbar-inverse navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <div class="navbar-brand">
+ <a class="navbar-brand-main" href="http://zeppelin.apache.org">
+ <img src="/assets/themes/zeppelin/img/zeppelin_logo.png" width="50" alt="I'm zeppelin">
+ <span style="vertical-align:middle">Zeppelin</span>
+ </a>
+ <a class="navbar-brand-version" href="/docs/0.7.3">
+ <span><small>0.7.3</small></span>
+ </a>
+ </div>
+ </div>
+ <nav class="navbar-collapse collapse" role="navigation">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Quick Start <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="/docs/0.7.3/index.html">What is Apache Zeppelin ?</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Getting Started</b><span></li>
+ <li><a href="/docs/0.7.3/install/install.html">Install</a></li>
+ <li><a href="/docs/0.7.3/install/configuration.html">Configuration</a></li>
+ <li><a href="/docs/0.7.3/quickstart/explorezeppelinui.html">Explore Zeppelin UI</a></li>
+ <li><a href="/docs/0.7.3/quickstart/tutorial.html">Tutorial</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Basic Feature Guide</b><span></li>
+ <li><a href="/docs/0.7.3/manual/dynamicform.html">Dynamic Form</a></li>
+ <li><a href="/docs/0.7.3/manual/publish.html">Publish your Paragraph</a></li>
+ <li><a href="/docs/0.7.3/manual/notebookashomepage.html">Customize Zeppelin Homepage</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>More</b><span></li>
+ <li><a href="/docs/0.7.3/install/upgrade.html">Upgrade Zeppelin Version</a></li>
+ <li><a href="/docs/0.7.3/install/build.html">Build from source</a></li>
+ <li><a href="/docs/0.7.3/quickstart/install_with_flink_and_spark_cluster.html">Install Zeppelin with Flink and Spark Clusters Tutorial</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Interpreter <b class="caret"></b></a>
+ <ul class="dropdown-menu scrollable-menu">
+ <li><a href="/docs/0.7.3/manual/interpreters.html">Overview</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Usage</b><span></li>
+ <li><a href="/docs/0.7.3/manual/interpreterinstallation.html">Interpreter Installation</a></li>
+ <!--<li><a href="/docs/0.7.3/manual/dynamicinterpreterload.html">Dynamic Interpreter Loading</a></li>-->
+ <li><a href="/docs/0.7.3/manual/dependencymanagement.html">Interpreter Dependency Management</a></li>
+ <li><a href="/docs/0.7.3/manual/userimpersonation.html">Interpreter User Impersonation</a></li>
+ <li><a href="/docs/0.7.3/manual/interpreterexechooks.html">Interpreter Execution Hooks (Experimental)</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Available Interpreters</b><span></li>
+ <li><a href="/docs/0.7.3/interpreter/alluxio.html">Alluxio</a></li>
+ <li><a href="/docs/0.7.3/interpreter/beam.html">Beam</a></li>
+ <li><a href="/docs/0.7.3/interpreter/bigquery.html">BigQuery</a></li>
+ <li><a href="/docs/0.7.3/interpreter/cassandra.html">Cassandra</a></li>
+ <li><a href="/docs/0.7.3/interpreter/elasticsearch.html">Elasticsearch</a></li>
+ <li><a href="/docs/0.7.3/interpreter/flink.html">Flink</a></li>
+ <li><a href="/docs/0.7.3/interpreter/geode.html">Geode</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hbase.html">HBase</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hdfs.html">HDFS</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hive.html">Hive</a></li>
+ <li><a href="/docs/0.7.3/interpreter/ignite.html">Ignite</a></li>
+ <li><a href="/docs/0.7.3/interpreter/jdbc.html">JDBC</a></li>
+ <li><a href="/docs/0.7.3/interpreter/kylin.html">Kylin</a></li>
+ <li><a href="/docs/0.7.3/interpreter/lens.html">Lens</a></li>
+ <li><a href="/docs/0.7.3/interpreter/livy.html">Livy</a></li>
+ <li><a href="/docs/0.7.3/interpreter/markdown.html">Markdown</a></li>
+ <li><a href="/docs/0.7.3/interpreter/pig.html">Pig</a></li>
+ <li><a href="/docs/0.7.3/interpreter/python.html">Python</a></li>
+ <li><a href="/docs/0.7.3/interpreter/postgresql.html">Postgresql, HAWQ</a></li>
+ <li><a href="/docs/0.7.3/interpreter/r.html">R</a></li>
+ <li><a href="/docs/0.7.3/interpreter/scalding.html">Scalding</a></li>
+ <li><a href="/docs/0.7.3/interpreter/scio.html">Scio</a></li>
+ <li><a href="/docs/0.7.3/interpreter/shell.html">Shell</a></li>
+ <li><a href="/docs/0.7.3/interpreter/spark.html">Spark</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Display System <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li class="title"><span><b>Basic Display System</b><span></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#text">Text</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#html">Html</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#table">Table</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Angular API</b><span></li>
+ <li><a href="/docs/0.7.3/displaysystem/back-end-angular.html">Angular (backend API)</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/front-end-angular.html">Angular (frontend API)</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">More<b class="caret"></b></a>
+ <ul class="dropdown-menu scrollable-menu" style="right: 0; left: auto;">
+ <li class="title"><span><b>Notebook Storage</b><span></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-local-git-repository">Git Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-s3">S3 Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-azure">Azure Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#storage-in-zeppelinhub">ZeppelinHub Storage</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>REST API</b><span></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-interpreter.html">Interpreter API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-notebook.html">Notebook API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-notebookRepo.html">Notebook Repository API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-configuration.html">Configuration API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-credential.html">Credential API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-helium.html">Helium API</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Security</b><span></li>
+ <li><a href="/docs/0.7.3/security/shiroauthentication.html">Shiro Authentication</a></li>
+ <li><a href="/docs/0.7.3/security/notebook_authorization.html">Notebook Authorization</a></li>
+ <li><a href="/docs/0.7.3/security/datasource_authorization.html">Data Source Authorization</a></li>
+ <li><a href="/docs/0.7.3/security/http_security_headers.html">HTTP Security Headers</a></li>
+ <li><a href="/docs/0.7.3/security/helium_authorization.html">Helium Authorization</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Advanced</b><span></li>
+ <li><a href="/docs/0.7.3/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li>
+ <li><a href="/docs/0.7.3/install/cdh.html">Zeppelin on CDH</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Contibute</b><span></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelinvisualization.html">Writing Zeppelin Visualization (Experimental)</a></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelinapplication.html">Writing Zeppelin Application (Experimental)</a></li>
+ <li><a href="/docs/0.7.3/development/howtocontribute.html">How to contribute (code)</a></li>
+ <li><a href="/docs/0.7.3/development/howtocontributewebsite.html">How to contribute (website)</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="/docs/0.7.3/search.html" class="nav-search-link">
+ <span class="fa fa-search nav-search-icon"></span>
+ </a>
+ </li>
+ </ul>
+ </nav><!--/.navbar-collapse -->
+ </div>
+ </div>
+
+
+
+ <div class="content">
+
+<!--<div class="hero-unit Apache Spark Interpreter for Apache Zeppelin">
+ <h1></h1>
+</div>
+-->
+
+<div class="row">
+ <div class="col-md-12">
+ <!--
+Licensed 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.
+-->
+
+<h1>Spark Interpreter for Apache Zeppelin</h1>
+
+<div id="toc"></div>
+
+<h2>Overview</h2>
+
+<p><a href="http://spark.apache.org">Apache Spark</a> is a fast and general-purpose cluster computing system.
+It provides high-level APIs in Java, Scala, Python and R, and an optimized engine that supports general execution graphs.
+Apache Spark is supported in Zeppelin with Spark interpreter group which consists of below five interpreters.</p>
+
+<table class="table-configuration">
+ <tr>
+ <th>Name</th>
+ <th>Class</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>%spark</td>
+ <td>SparkInterpreter</td>
+ <td>Creates a SparkContext and provides a Scala environment</td>
+ </tr>
+ <tr>
+ <td>%spark.pyspark</td>
+ <td>PySparkInterpreter</td>
+ <td>Provides a Python environment</td>
+ </tr>
+ <tr>
+ <td>%spark.r</td>
+ <td>SparkRInterpreter</td>
+ <td>Provides an R environment with SparkR support</td>
+ </tr>
+ <tr>
+ <td>%spark.sql</td>
+ <td>SparkSQLInterpreter</td>
+ <td>Provides a SQL environment</td>
+ </tr>
+ <tr>
+ <td>%spark.dep</td>
+ <td>DepInterpreter</td>
+ <td>Dependency loader</td>
+ </tr>
+</table>
+
+<h2>Configuration</h2>
+
+<p>The Spark interpreter can be configured with properties provided by Zeppelin.
+You can also set other Spark properties which are not listed in the table. For a list of additional properties, refer to <a href="http://spark.apache.org/docs/latest/configuration.html#available-properties">Spark Available Properties</a>.
+<table class="table-configuration">
+ <tr>
+ <th>Property</th>
+ <th>Default</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>args</td>
+ <td></td>
+ <td>Spark commandline args</td>
+ </tr>
+ <td>master</td>
+ <td>local[*]</td>
+ <td>Spark master uri. <br/> ex) spark://masterhost:7077</td>
+ <tr>
+ <td>spark.app.name</td>
+ <td>Zeppelin</td>
+ <td>The name of spark application.</td>
+ </tr>
+ <tr>
+ <td>spark.cores.max</td>
+ <td></td>
+ <td>Total number of cores to use. <br/> Empty value uses all available core.</td>
+ </tr>
+ <tr>
+ <td>spark.executor.memory </td>
+ <td>1g</td>
+ <td>Executor memory per worker instance. <br/> ex) 512m, 32g</td>
+ </tr>
+ <tr>
+ <td>zeppelin.dep.additionalRemoteRepository</td>
+ <td>spark-packages, <br/> http://dl.bintray.com/spark-packages/maven, <br/> false;</td>
+ <td>A list of <code>id,remote-repository-URL,is-snapshot;</code> <br/> for each remote repository.</td>
+ </tr>
+ <tr>
+ <td>zeppelin.dep.localrepo</td>
+ <td>local-repo</td>
+ <td>Local repository for dependency loader</td>
+ </tr>
+ <tr>
+ <td>zeppelin.pyspark.python</td>
+ <td>python</td>
+ <td>Python command to run pyspark with</td>
+ </tr>
+ <tr>
+ <td>zeppelin.spark.concurrentSQL</td>
+ <td>false</td>
+ <td>Execute multiple SQL concurrently if set true.</td>
+ </tr>
+ <tr>
+ <td>zeppelin.spark.maxResult</td>
+ <td>1000</td>
+ <td>Max number of Spark SQL result to display.</td>
+ </tr>
+ <tr>
+ <td>zeppelin.spark.printREPLOutput</td>
+ <td>true</td>
+ <td>Print REPL output</td>
+ </tr>
+ <tr>
+ <td>zeppelin.spark.useHiveContext</td>
+ <td>true</td>
+ <td>Use HiveContext instead of SQLContext if it is true.</td>
+ </tr>
+ <tr>
+ <td>zeppelin.spark.importImplicit</td>
+ <td>true</td>
+ <td>Import implicits, UDF collection, and sql if set true.</td>
+ </tr>
+</table></p>
+
+<p>Without any configuration, Spark interpreter works out of box in local mode. But if you want to connect to your Spark cluster, you'll need to follow below two simple steps.</p>
+
+<h3>1. Export SPARK_HOME</h3>
+
+<p>In <code>conf/zeppelin-env.sh</code>, export <code>SPARK_HOME</code> environment variable with your Spark installation path.</p>
+
+<p>For example,</p>
+<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="nb">export </span><span class="nv">SPARK_HOME</span><span class="o">=</span>/usr/lib/spark
+</code></pre></div>
+<p>You can optionally set more environment variables</p>
+<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="c"># set hadoop conf dir</span>
+<span class="nb">export </span><span class="nv">HADOOP_CONF_DIR</span><span class="o">=</span>/usr/lib/hadoop
+
+<span class="c"># set options to pass spark-submit command</span>
+<span class="nb">export </span><span class="nv">SPARK_SUBMIT_OPTIONS</span><span class="o">=</span><span class="s2">"--packages com.databricks:spark-csv_2.10:1.2.0"</span>
+
+<span class="c"># extra classpath. e.g. set classpath for hive-site.xml</span>
+<span class="nb">export </span><span class="nv">ZEPPELIN_INTP_CLASSPATH_OVERRIDES</span><span class="o">=</span>/etc/hive/conf
+</code></pre></div>
+<p>For Windows, ensure you have <code>winutils.exe</code> in <code>%HADOOP_HOME%\bin</code>. Please see <a href="https://wiki.apache.org/hadoop/WindowsProblems">Problems running Hadoop on Windows</a> for the details.</p>
+
+<h3>2. Set master in Interpreter menu</h3>
+
+<p>After start Zeppelin, go to <strong>Interpreter</strong> menu and edit <strong>master</strong> property in your Spark interpreter setting. The value may vary depending on your Spark cluster deployment type.</p>
+
+<p>For example,</p>
+
+<ul>
+<li><strong>local[*]</strong> in local mode</li>
+<li><strong>spark://master:7077</strong> in standalone cluster</li>
+<li><strong>yarn-client</strong> in Yarn client mode</li>
+<li><strong>mesos://host:5050</strong> in Mesos cluster</li>
+</ul>
+
+<p>That's it. Zeppelin will work with any version of Spark and any deployment type without rebuilding Zeppelin in this way.
+For the further information about Spark & Zeppelin version compatibility, please refer to "Available Interpreters" section in <a href="https://zeppelin.apache.org/download.html">Zeppelin download page</a>.</p>
+
+<blockquote>
+<p>Note that without exporting <code>SPARK_HOME</code>, it's running in local mode with included version of Spark. The included version may vary depending on the build profile.</p>
+</blockquote>
+
+<h2>SparkContext, SQLContext, SparkSession, ZeppelinContext</h2>
+
+<p>SparkContext, SQLContext and ZeppelinContext are automatically created and exposed as variable names <code>sc</code>, <code>sqlContext</code> and <code>z</code>, respectively, in Scala, Python and R environments.
+Staring from 0.6.1 SparkSession is available as variable <code>spark</code> when you are using Spark 2.x.</p>
+
+<blockquote>
+<p>Note that Scala/Python/R environment shares the same SparkContext, SQLContext and ZeppelinContext instance.</p>
+</blockquote>
+
+<p><a name="dependencyloading"> </a></p>
+
+<h3>How to pass property to SparkConf</h3>
+
+<p>There're 2 kinds of properties that would be passed to SparkConf</p>
+
+<ul>
+<li>Standard spark property (prefix with <code>spark.</code>). e.g. <code>spark.executor.memory</code> will be passed to <code>SparkConf</code></li>
+<li>Non-standard spark property (prefix with <code>zeppelin.spark.</code>). e.g. <code>zeppelin.spark.property_1</code>, <code>property_1</code> will be passed to <code>SparkConf</code></li>
+</ul>
+
+<h2>Dependency Management</h2>
+
+<p>There are two ways to load external libraries in Spark interpreter. First is using interpreter setting menu and second is loading Spark properties.</p>
+
+<h3>1. Setting Dependencies via Interpreter Setting</h3>
+
+<p>Please see <a href="../manual/dependencymanagement.html">Dependency Management</a> for the details.</p>
+
+<h3>2. Loading Spark Properties</h3>
+
+<p>Once <code>SPARK_HOME</code> is set in <code>conf/zeppelin-env.sh</code>, Zeppelin uses <code>spark-submit</code> as spark interpreter runner. <code>spark-submit</code> supports two ways to load configurations.
+The first is command line options such as --master and Zeppelin can pass these options to <code>spark-submit</code> by exporting <code>SPARK_SUBMIT_OPTIONS</code> in <code>conf/zeppelin-env.sh</code>. Second is reading configuration options from <code>SPARK_HOME/conf/spark-defaults.conf</code>. Spark properties that user can set to distribute libraries are:</p>
+
+<table class="table-configuration">
+ <tr>
+ <th>spark-defaults.conf</th>
+ <th>SPARK_SUBMIT_OPTIONS</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>spark.jars</td>
+ <td>--jars</td>
+ <td>Comma-separated list of local jars to include on the driver and executor classpaths.</td>
+ </tr>
+ <tr>
+ <td>spark.jars.packages</td>
+ <td>--packages</td>
+ <td>Comma-separated list of maven coordinates of jars to include on the driver and executor classpaths. Will search the local maven repo, then maven central and any additional remote repositories given by --repositories. The format for the coordinates should be <code>groupId:artifactId:version</code>.</td>
+ </tr>
+ <tr>
+ <td>spark.files</td>
+ <td>--files</td>
+ <td>Comma-separated list of files to be placed in the working directory of each executor.</td>
+ </tr>
+</table>
+
+<p>Here are few examples:</p>
+
+<ul>
+<li><p><code>SPARK_SUBMIT_OPTIONS</code> in <code>conf/zeppelin-env.sh</code></p>
+<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="nb">export </span><span class="nv">SPARK_SUBMIT_OPTIONS</span><span class="o">=</span><span class="s2">"--packages com.databricks:spark-csv_2.10:1.2.0 --jars /path/mylib1.jar,/path/mylib2.jar --files /path/mylib1.py,/path/mylib2.zip,/path/mylib3.egg"</span>
+</code></pre></div></li>
+<li><p><code>SPARK_HOME/conf/spark-defaults.conf</code></p>
+<div class="highlight"><pre><code class="text language-text" data-lang="text">spark.jars /path/mylib1.jar,/path/mylib2.jar
+spark.jars.packages com.databricks:spark-csv_2.10:1.2.0
+spark.files /path/mylib1.py,/path/mylib2.egg,/path/mylib3.zip
+</code></pre></div></li>
+</ul>
+
+<h3>3. Dynamic Dependency Loading via %spark.dep interpreter</h3>
+
+<blockquote>
+<p>Note: <code>%spark.dep</code> interpreter loads libraries to <code>%spark</code> and <code>%spark.pyspark</code> but not to <code>%spark.sql</code> interpreter. So we recommend you to use the first option instead.</p>
+</blockquote>
+
+<p>When your code requires external library, instead of doing download/copy/restart Zeppelin, you can easily do following jobs using <code>%spark.dep</code> interpreter.</p>
+
+<ul>
+<li>Load libraries recursively from maven repository</li>
+<li>Load libraries from local filesystem</li>
+<li>Add additional maven repository</li>
+<li>Automatically add libraries to SparkCluster (You can turn off)</li>
+</ul>
+
+<p>Dep interpreter leverages Scala environment. So you can write any Scala code here.
+Note that <code>%spark.dep</code> interpreter should be used before <code>%spark</code>, <code>%spark.pyspark</code>, <code>%spark.sql</code>.</p>
+
+<p>Here's usages.</p>
+<div class="highlight"><pre><code class="scala language-scala" data-lang="scala"><span class="o">%</span><span class="n">spark</span><span class="o">.</span><span class="n">dep</span>
+<span class="n">z</span><span class="o">.</span><span class="n">reset</span><span class="o">()</span> <span class="c1">// clean up previously added artifact and repository</span>
+
+<span class="c1">// add maven repository</span>
+<span class="n">z</span><span class="o">.</span><span class="n">addRepo</span><span class="o">(</span><span class="s">"RepoName"</span><span class="o">).</span><span class="n">url</span><span class="o">(</span><span class="s">"RepoURL"</span><span class="o">)</span>
+
+<span class="c1">// add maven snapshot repository</span>
+<span class="n">z</span><span class="o">.</span><span class="n">addRepo</span><span class="o">(</span><span class="s">"RepoName"</span><span class="o">).</span><span class="n">url</span><span class="o">(</span><span class="s">"RepoURL"</span><span class="o">).</span><span class="n">snapshot</span><span class="o">()</span>
+
+<span class="c1">// add credentials for private maven repository</span>
+<span class="n">z</span><span class="o">.</span><span class="n">addRepo</span><span class="o">(</span><span class="s">"RepoName"</span><span class="o">).</span><span class="n">url</span><span class="o">(</span><span class="s">"RepoURL"</span><span class="o">).</span><span class="n">username</span><span class="o">(</span><span class="s">"username"</span><span class="o">).</span><span class="n">password</span><span class="o">(</span><span class="s">"password"</span><span class="o">)</span>
+
+<span class="c1">// add artifact from filesystem</span>
+<span class="n">z</span><span class="o">.</span><span class="n">load</span><span class="o">(</span><span class="s">"/path/to.jar"</span><span class="o">)</span>
+
+<span class="c1">// add artifact from maven repository, with no dependency</span>
+<span class="n">z</span><span class="o">.</span><span class="n">load</span><span class="o">(</span><span class="s">"groupId:artifactId:version"</span><span class="o">).</span><span class="n">excludeAll</span><span class="o">()</span>
+
+<span class="c1">// add artifact recursively</span>
+<span class="n">z</span><span class="o">.</span><span class="n">load</span><span class="o">(</span><span class="s">"groupId:artifactId:version"</span><span class="o">)</span>
+
+<span class="c1">// add artifact recursively except comma separated GroupID:ArtifactId list</span>
+<span class="n">z</span><span class="o">.</span><span class="n">load</span><span class="o">(</span><span class="s">"groupId:artifactId:version"</span><span class="o">).</span><span class="n">exclude</span><span class="o">(</span><span class="s">"groupId:artifactId,groupId:artifactId, ..."</span><span class="o">)</span>
+
+<span class="c1">// exclude with pattern</span>
+<span class="n">z</span><span class="o">.</span><span class="n">load</span><span class="o">(</span><span class="s">"groupId:artifactId:version"</span><span class="o">).</span><span class="n">exclude</span><span class="o">(*)</span>
+<span class="n">z</span><span class="o">.</span><span class="n">load</span><span class="o">(</span><span class="s">"groupId:artifactId:version"</span><span class="o">).</span><span class="n">exclude</span><span class="o">(</span><span class="s">"groupId:artifactId:*"</span><span class="o">)</span>
+<span class="n">z</span><span class="o">.</span><span class="n">load</span><span class="o">(</span><span class="s">"groupId:artifactId:version"</span><span class="o">).</span><span class="n">exclude</span><span class="o">(</span><span class="s">"groupId:*"</span><span class="o">)</span>
+
+<span class="c1">// local() skips adding artifact to spark clusters (skipping sc.addJar())</span>
+<span class="n">z</span><span class="o">.</span><span class="n">load</span><span class="o">(</span><span class="s">"groupId:artifactId:version"</span><span class="o">).</span><span class="n">local</span><span class="o">()</span>
+</code></pre></div>
+<h2>ZeppelinContext</h2>
+
+<p>Zeppelin automatically injects <code>ZeppelinContext</code> as variable <code>z</code> in your Scala/Python environment. <code>ZeppelinContext</code> provides some additional functions and utilities.</p>
+
+<h3>Object Exchange</h3>
+
+<p><code>ZeppelinContext</code> extends map and it's shared between Scala and Python environment.
+So you can put some objects from Scala and read it from Python, vice versa.</p>
+
+<div class="codetabs">
+ <div data-lang="scala" markdown="1">
+
+
+<div class="highlight"><pre><code class="scala"><span class="c1">// Put object from scala</span>
+<span class="o">%</span><span class="n">spark</span>
+<span class="k">val</span> <span class="n">myObject</span> <span class="k">=</span> <span class="o">...</span>
+<span class="n">z</span><span class="o">.</span><span class="n">put</span><span class="o">(</span><span class="s">"objName"</span><span class="o">,</span> <span class="n">myObject</span><span class="o">)</span>
+
+<span class="c1">// Exchanging data frames</span>
+<span class="n">myScalaDataFrame</span> <span class="k">=</span> <span class="o">...</span>
+<span class="n">z</span><span class="o">.</span><span class="n">put</span><span class="o">(</span><span class="s">"myScalaDataFrame"</span><span class="o">,</span> <span class="n">myScalaDataFrame</span><span class="o">)</span>
+
+<span class="k">val</span> <span class="n">myPythonDataFrame</span> <span class="k">=</span> <span class="n">z</span><span class="o">.</span><span class="n">get</span><span class="o">(</span><span class="s">"myPythonDataFrame"</span><span class="o">).</span><span class="n">asInstanceOf</span><span class="o">[</span><span class="kt">DataFrame</span><span class="o">]</span>
+</code></pre></div>
+
+
+ </div>
+ <div data-lang="python" markdown="1">
+
+
+<div class="highlight"><pre><code class="python"><span class="c"># Get object from python</span>
+<span class="o">%</span><span class="n">spark</span><span class="o">.</span><span class="n">pyspark</span>
+<span class="n">myObject</span> <span class="o">=</span> <span class="n">z</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s">"objName"</span><span class="p">)</span>
+
+<span class="c"># Exchanging data frames</span>
+<span class="n">myPythonDataFrame</span> <span class="o">=</span> <span class="o">...</span>
+<span class="n">z</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="s">"myPythonDataFrame"</span><span class="p">,</span> <span class="n">postsDf</span><span class="o">.</span><span class="n">_jdf</span><span class="p">)</span>
+
+<span class="n">myScalaDataFrame</span> <span class="o">=</span> <span class="n">DataFrame</span><span class="p">(</span><span class="n">z</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s">"myScalaDataFrame"</span><span class="p">),</span> <span class="n">sqlContext</span><span class="p">)</span>
+</code></pre></div>
+
+
+ </div>
+</div>
+
+<h3>Form Creation</h3>
+
+<p><code>ZeppelinContext</code> provides functions for creating forms.
+In Scala and Python environments, you can create forms programmatically.
+<div class="codetabs">
+ <div data-lang="scala" markdown="1"></p>
+
+<div class="highlight"><pre><code class="scala"><span class="o">%</span><span class="n">spark</span>
+<span class="cm">/* Create text input form */</span>
+<span class="n">z</span><span class="o">.</span><span class="n">input</span><span class="o">(</span><span class="s">"formName"</span><span class="o">)</span>
+
+<span class="cm">/* Create text input form with default value */</span>
+<span class="n">z</span><span class="o">.</span><span class="n">input</span><span class="o">(</span><span class="s">"formName"</span><span class="o">,</span> <span class="s">"defaultValue"</span><span class="o">)</span>
+
+<span class="cm">/* Create select form */</span>
+<span class="n">z</span><span class="o">.</span><span class="n">select</span><span class="o">(</span><span class="s">"formName"</span><span class="o">,</span> <span class="nc">Seq</span><span class="o">((</span><span class="s">"option1"</span><span class="o">,</span> <span class="s">"option1DisplayName"</span><span class="o">),</span>
+ <span class="o">(</span><span class="s">"option2"</span><span class="o">,</span> <span class="s">"option2DisplayName"</span><span class="o">)))</span>
+
+<span class="cm">/* Create select form with default value*/</span>
+<span class="n">z</span><span class="o">.</span><span class="n">select</span><span class="o">(</span><span class="s">"formName"</span><span class="o">,</span> <span class="s">"option1"</span><span class="o">,</span> <span class="nc">Seq</span><span class="o">((</span><span class="s">"option1"</span><span class="o">,</span> <span class="s">"option1DisplayName"</span><span class="o">),</span>
+ <span class="o">(</span><span class="s">"option2"</span><span class="o">,</span> <span class="s">"option2DisplayName"</span><span class="o">)))</span>
+</code></pre></div>
+
+
+ </div>
+ <div data-lang="python" markdown="1">
+
+
+<div class="highlight"><pre><code class="python"><span class="o">%</span><span class="n">spark</span><span class="o">.</span><span class="n">pyspark</span>
+<span class="c"># Create text input form</span>
+<span class="n">z</span><span class="o">.</span><span class="n">input</span><span class="p">(</span><span class="s">"formName"</span><span class="p">)</span>
+
+<span class="c"># Create text input form with default value</span>
+<span class="n">z</span><span class="o">.</span><span class="n">input</span><span class="p">(</span><span class="s">"formName"</span><span class="p">,</span> <span class="s">"defaultValue"</span><span class="p">)</span>
+
+<span class="c"># Create select form</span>
+<span class="n">z</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="s">"formName"</span><span class="p">,</span> <span class="p">[(</span><span class="s">"option1"</span><span class="p">,</span> <span class="s">"option1DisplayName"</span><span class="p">),</span>
+ <span class="p">(</span><span class="s">"option2"</span><span class="p">,</span> <span class="s">"option2DisplayName"</span><span class="p">)])</span>
+
+<span class="c"># Create select form with default value</span>
+<span class="n">z</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="s">"formName"</span><span class="p">,</span> <span class="p">[(</span><span class="s">"option1"</span><span class="p">,</span> <span class="s">"option1DisplayName"</span><span class="p">),</span>
+ <span class="p">(</span><span class="s">"option2"</span><span class="p">,</span> <span class="s">"option2DisplayName"</span><span class="p">)],</span> <span class="s">"option1"</span><span class="p">)</span>
+</code></pre></div>
+
+
+ </div>
+</div>
+
+<p>In sql environment, you can create form in simple template.</p>
+<div class="highlight"><pre><code class="sql language-sql" data-lang="sql"><span class="o">%</span><span class="n">spark</span><span class="p">.</span><span class="k">sql</span>
+<span class="k">select</span> <span class="o">*</span> <span class="k">from</span> <span class="err">${</span><span class="k">table</span><span class="o">=</span><span class="n">defaultTableName</span><span class="err">}</span> <span class="k">where</span> <span class="nb">text</span> <span class="k">like</span> <span class="s1">'%${search}%'</span>
+</code></pre></div>
+<p>To learn more about dynamic form, checkout <a href="../manual/dynamicform.html">Dynamic Form</a>.</p>
+
+<h2>Matplotlib Integration (pyspark)</h2>
+
+<p>Both the <code>python</code> and <code>pyspark</code> interpreters have built-in support for inline visualization using <code>matplotlib</code>, a popular plotting library for python. More details can be found in the <a href="../interpreter/python.html">python interpreter documentation</a>, since matplotlib support is identical. More advanced interactive plotting can be done with pyspark through utilizing Zeppelin's built-in <a href="../displaysystem/back-end-angular.html">Angular Display System</a>, as shown below:</p>
+
+<p><img class="img-responsive" src="../assets/themes/zeppelin/img/docs-img/matplotlibAngularExample.gif" /></p>
+
+<h2>Interpreter setting option</h2>
+
+<p>You can choose one of <code>shared</code>, <code>scoped</code> and <code>isolated</code> options wheh you configure Spark interpreter. Spark interpreter creates separated Scala compiler per each notebook but share a single SparkContext in <code>scoped</code> mode (experimental). It creates separated SparkContext per each notebook in <code>isolated</code> mode.</p>
+
+<h2>Setting up Zeppelin with Kerberos</h2>
+
+<p>Logical setup with Zeppelin, Kerberos Key Distribution Center (KDC), and Spark on YARN:</p>
+
+<p><img src="../assets/themes/zeppelin/img/docs-img/kdc_zeppelin.png"></p>
+
+<h3>Configuration Setup</h3>
+
+<ol>
+<li><p>On the server that Zeppelin is installed, install Kerberos client modules and configuration, krb5.conf.
+This is to make the server communicate with KDC.</p></li>
+<li><p>Set <code>SPARK_HOME</code> in <code>[ZEPPELIN_HOME]/conf/zeppelin-env.sh</code> to use spark-submit
+(Additionally, you might have to set <code>export HADOOP_CONF_DIR=/etc/hadoop/conf</code>)</p></li>
+<li><p>Add the two properties below to Spark configuration (<code>[SPARK_HOME]/conf/spark-defaults.conf</code>):</p>
+<div class="highlight"><pre><code class="text language-text" data-lang="text">spark.yarn.principal
+spark.yarn.keytab
+</code></pre></div>
+<blockquote>
+<p><strong>NOTE:</strong> If you do not have permission to access for the above spark-defaults.conf file, optionally, you can add the above lines to the Spark Interpreter setting through the Interpreter tab in the Zeppelin UI.</p>
+</blockquote></li>
+<li><p>That's it. Play with Zeppelin!</p></li>
+</ol>
+
+ </div>
+</div>
+
+
+ <hr>
+ <footer>
+ <!-- <p>© 2017 The Apache Software Foundation</p>-->
+ </footer>
+ </div>
+
+
+
+
+ <script type="text/javascript">
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-45176241-5', 'zeppelin.apache.org');
+ ga('require', 'linkid', 'linkid.js');
+ ga('send', 'pageview');
+
+</script>
+
+
+
+ </body>
+</html>
+
Added: zeppelin/site/docs/0.7.3/manual/dependencymanagement.html
URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.3/manual/dependencymanagement.html?rev=1809223&view=auto
==============================================================================
--- zeppelin/site/docs/0.7.3/manual/dependencymanagement.html (added)
+++ zeppelin/site/docs/0.7.3/manual/dependencymanagement.html Thu Sep 21 20:33:57 2017
@@ -0,0 +1,305 @@
+
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <title>Apache Zeppelin 0.7.3 Documentation: Dependency Management for Apache Spark Interpreter</title>
+ <meta name="description" content="Include external libraries to Apache Spark Interpreter by setting dependencies in interpreter menu.">
+ <meta name="author" content="The Apache Software Foundation">
+
+ <!-- Enable responsive viewport -->
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+ <!--[if lt IE 9]>
+ <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+ <![endif]-->
+
+ <link href="//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+
+ <!-- Le styles -->
+ <link href="/docs/0.7.3/assets/themes/zeppelin/bootstrap/css/bootstrap.css" rel="stylesheet">
+ <link href="/docs/0.7.3/assets/themes/zeppelin/css/style.css?body=1" rel="stylesheet" type="text/css">
+ <link href="/docs/0.7.3/assets/themes/zeppelin/css/syntax.css" rel="stylesheet" type="text/css" media="screen" />
+ <!-- Le fav and touch icons -->
+ <!-- Update these with your own images
+ <link rel="shortcut icon" href="images/favicon.ico">
+ <link rel="apple-touch-icon" href="images/apple-touch-icon.png">
+ <link rel="apple-touch-icon" sizes="72x72" href="images/apple-touch-icon-72x72.png">
+ <link rel="apple-touch-icon" sizes="114x114" href="images/apple-touch-icon-114x114.png">
+ -->
+
+ <!-- Js -->
+ <script src="https://code.jquery.com/jquery-1.10.2.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/bootstrap/js/bootstrap.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/docs.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/anchor.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/toc.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/lunr.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/search.js"></script>
+
+ <!-- atom & rss feed -->
+ <link href="/docs/0.7.3/atom.xml" type="application/atom+xml" rel="alternate" title="Sitewide ATOM Feed">
+ <link href="/docs/0.7.3/rss.xml" type="application/rss+xml" rel="alternate" title="Sitewide RSS Feed">
+ </head>
+
+ <body>
+
+ <div id="menu" class="navbar navbar-inverse navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <div class="navbar-brand">
+ <a class="navbar-brand-main" href="http://zeppelin.apache.org">
+ <img src="/assets/themes/zeppelin/img/zeppelin_logo.png" width="50" alt="I'm zeppelin">
+ <span style="vertical-align:middle">Zeppelin</span>
+ </a>
+ <a class="navbar-brand-version" href="/docs/0.7.3">
+ <span><small>0.7.3</small></span>
+ </a>
+ </div>
+ </div>
+ <nav class="navbar-collapse collapse" role="navigation">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Quick Start <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="/docs/0.7.3/index.html">What is Apache Zeppelin ?</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Getting Started</b><span></li>
+ <li><a href="/docs/0.7.3/install/install.html">Install</a></li>
+ <li><a href="/docs/0.7.3/install/configuration.html">Configuration</a></li>
+ <li><a href="/docs/0.7.3/quickstart/explorezeppelinui.html">Explore Zeppelin UI</a></li>
+ <li><a href="/docs/0.7.3/quickstart/tutorial.html">Tutorial</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Basic Feature Guide</b><span></li>
+ <li><a href="/docs/0.7.3/manual/dynamicform.html">Dynamic Form</a></li>
+ <li><a href="/docs/0.7.3/manual/publish.html">Publish your Paragraph</a></li>
+ <li><a href="/docs/0.7.3/manual/notebookashomepage.html">Customize Zeppelin Homepage</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>More</b><span></li>
+ <li><a href="/docs/0.7.3/install/upgrade.html">Upgrade Zeppelin Version</a></li>
+ <li><a href="/docs/0.7.3/install/build.html">Build from source</a></li>
+ <li><a href="/docs/0.7.3/quickstart/install_with_flink_and_spark_cluster.html">Install Zeppelin with Flink and Spark Clusters Tutorial</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Interpreter <b class="caret"></b></a>
+ <ul class="dropdown-menu scrollable-menu">
+ <li><a href="/docs/0.7.3/manual/interpreters.html">Overview</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Usage</b><span></li>
+ <li><a href="/docs/0.7.3/manual/interpreterinstallation.html">Interpreter Installation</a></li>
+ <!--<li><a href="/docs/0.7.3/manual/dynamicinterpreterload.html">Dynamic Interpreter Loading</a></li>-->
+ <li><a href="/docs/0.7.3/manual/dependencymanagement.html">Interpreter Dependency Management</a></li>
+ <li><a href="/docs/0.7.3/manual/userimpersonation.html">Interpreter User Impersonation</a></li>
+ <li><a href="/docs/0.7.3/manual/interpreterexechooks.html">Interpreter Execution Hooks (Experimental)</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Available Interpreters</b><span></li>
+ <li><a href="/docs/0.7.3/interpreter/alluxio.html">Alluxio</a></li>
+ <li><a href="/docs/0.7.3/interpreter/beam.html">Beam</a></li>
+ <li><a href="/docs/0.7.3/interpreter/bigquery.html">BigQuery</a></li>
+ <li><a href="/docs/0.7.3/interpreter/cassandra.html">Cassandra</a></li>
+ <li><a href="/docs/0.7.3/interpreter/elasticsearch.html">Elasticsearch</a></li>
+ <li><a href="/docs/0.7.3/interpreter/flink.html">Flink</a></li>
+ <li><a href="/docs/0.7.3/interpreter/geode.html">Geode</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hbase.html">HBase</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hdfs.html">HDFS</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hive.html">Hive</a></li>
+ <li><a href="/docs/0.7.3/interpreter/ignite.html">Ignite</a></li>
+ <li><a href="/docs/0.7.3/interpreter/jdbc.html">JDBC</a></li>
+ <li><a href="/docs/0.7.3/interpreter/kylin.html">Kylin</a></li>
+ <li><a href="/docs/0.7.3/interpreter/lens.html">Lens</a></li>
+ <li><a href="/docs/0.7.3/interpreter/livy.html">Livy</a></li>
+ <li><a href="/docs/0.7.3/interpreter/markdown.html">Markdown</a></li>
+ <li><a href="/docs/0.7.3/interpreter/pig.html">Pig</a></li>
+ <li><a href="/docs/0.7.3/interpreter/python.html">Python</a></li>
+ <li><a href="/docs/0.7.3/interpreter/postgresql.html">Postgresql, HAWQ</a></li>
+ <li><a href="/docs/0.7.3/interpreter/r.html">R</a></li>
+ <li><a href="/docs/0.7.3/interpreter/scalding.html">Scalding</a></li>
+ <li><a href="/docs/0.7.3/interpreter/scio.html">Scio</a></li>
+ <li><a href="/docs/0.7.3/interpreter/shell.html">Shell</a></li>
+ <li><a href="/docs/0.7.3/interpreter/spark.html">Spark</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Display System <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li class="title"><span><b>Basic Display System</b><span></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#text">Text</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#html">Html</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#table">Table</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Angular API</b><span></li>
+ <li><a href="/docs/0.7.3/displaysystem/back-end-angular.html">Angular (backend API)</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/front-end-angular.html">Angular (frontend API)</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">More<b class="caret"></b></a>
+ <ul class="dropdown-menu scrollable-menu" style="right: 0; left: auto;">
+ <li class="title"><span><b>Notebook Storage</b><span></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-local-git-repository">Git Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-s3">S3 Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-azure">Azure Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#storage-in-zeppelinhub">ZeppelinHub Storage</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>REST API</b><span></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-interpreter.html">Interpreter API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-notebook.html">Notebook API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-notebookRepo.html">Notebook Repository API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-configuration.html">Configuration API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-credential.html">Credential API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-helium.html">Helium API</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Security</b><span></li>
+ <li><a href="/docs/0.7.3/security/shiroauthentication.html">Shiro Authentication</a></li>
+ <li><a href="/docs/0.7.3/security/notebook_authorization.html">Notebook Authorization</a></li>
+ <li><a href="/docs/0.7.3/security/datasource_authorization.html">Data Source Authorization</a></li>
+ <li><a href="/docs/0.7.3/security/http_security_headers.html">HTTP Security Headers</a></li>
+ <li><a href="/docs/0.7.3/security/helium_authorization.html">Helium Authorization</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Advanced</b><span></li>
+ <li><a href="/docs/0.7.3/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li>
+ <li><a href="/docs/0.7.3/install/cdh.html">Zeppelin on CDH</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Contibute</b><span></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelinvisualization.html">Writing Zeppelin Visualization (Experimental)</a></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelinapplication.html">Writing Zeppelin Application (Experimental)</a></li>
+ <li><a href="/docs/0.7.3/development/howtocontribute.html">How to contribute (code)</a></li>
+ <li><a href="/docs/0.7.3/development/howtocontributewebsite.html">How to contribute (website)</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="/docs/0.7.3/search.html" class="nav-search-link">
+ <span class="fa fa-search nav-search-icon"></span>
+ </a>
+ </li>
+ </ul>
+ </nav><!--/.navbar-collapse -->
+ </div>
+ </div>
+
+
+
+ <div class="content">
+
+<!--<div class="hero-unit Dependency Management for Apache Spark Interpreter">
+ <h1></h1>
+</div>
+-->
+
+<div class="row">
+ <div class="col-md-12">
+ <!--
+Licensed 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.
+-->
+
+<h2>Dependency Management for Interpreter</h2>
+
+<p>You can include external libraries to interpreter by setting dependencies in interpreter menu.</p>
+
+<p>When your code requires external library, instead of doing download/copy/restart Zeppelin, you can easily do following jobs in this menu.</p>
+
+<ul>
+<li>Load libraries recursively from Maven repository</li>
+<li>Load libraries from local filesystem</li>
+<li>Add additional maven repository</li>
+<li>Automatically add libraries to SparkCluster</li>
+</ul>
+
+<hr>
+
+<div class="row">
+ <div class="col-md-6">
+ <a data-lightbox="compiler" href="../assets/themes/zeppelin/img/docs-img/interpreter-dependency-loading.png">
+ <img class="img-responsive" src="../assets/themes/zeppelin/img/docs-img/interpreter-dependency-loading.png" />
+ </a>
+ </div>
+ <div class="col-md-6" style="padding-top:30px">
+ <b> Load Dependencies to Interpreter </b>
+ <br /><br />
+ <ol>
+ <li> Click 'Interpreter' menu in navigation bar. </li>
+ <li> Click 'edit' button of the interpreter which you want to load dependencies to. </li>
+ <li> Fill artifact and exclude field to your needs.
+ You can enter not only groupId:artifactId:version but also local file in artifact field. </li>
+ <li> Press 'Save' to restart the interpreter with loaded libraries. </li>
+ </ol>
+ </div>
+</div>
+
+<hr>
+
+<div class="row">
+ <div class="col-md-6">
+ <a data-lightbox="compiler" href="../assets/themes/zeppelin/img/docs-img/interpreter-add-repo1.png">
+ <img class="img-responsive" src="../assets/themes/zeppelin/img/docs-img/interpreter-add-repo1.png" />
+ </a>
+ <a data-lightbox="compiler" href="../assets/themes/zeppelin/img/docs-img/interpreter-add-repo2.png">
+ <img class="img-responsive" src="../assets/themes/zeppelin/img/docs-img/interpreter-add-repo2.png" />
+ </a>
+ </div>
+ <div class="col-md-6" style="padding-top:30px">
+ <b> Add repository for dependency resolving </b>
+ <br /><br />
+ <ol>
+ <li> Press <i class="fa fa-cog"></i> icon in 'Interpreter' menu on the top right side.
+ It will show you available repository lists.</li>
+ <li> If you need to resolve dependencies from other than central maven repository or
+ local ~/.m2 repository, hit <i class="fa fa-plus"></i> icon next to repository lists. </li>
+ <li> Fill out the form and click 'Add' button, then you will be able to see that new repository is added. </li>
+ <li> Optionally, if you are behind a corporate firewall, you can specify also all proxy settings so that Zeppelin can download the dependencies using the given credentials</li>
+ </ol>
+ </div>
+</div>
+
+ </div>
+</div>
+
+
+ <hr>
+ <footer>
+ <!-- <p>© 2017 The Apache Software Foundation</p>-->
+ </footer>
+ </div>
+
+
+
+
+ <script type="text/javascript">
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-45176241-5', 'zeppelin.apache.org');
+ ga('require', 'linkid', 'linkid.js');
+ ga('send', 'pageview');
+
+</script>
+
+
+
+ </body>
+</html>
+
Added: zeppelin/site/docs/0.7.3/manual/dynamicform.html
URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.3/manual/dynamicform.html?rev=1809223&view=auto
==============================================================================
--- zeppelin/site/docs/0.7.3/manual/dynamicform.html (added)
+++ zeppelin/site/docs/0.7.3/manual/dynamicform.html Thu Sep 21 20:33:57 2017
@@ -0,0 +1,425 @@
+
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <title>Apache Zeppelin 0.7.3 Documentation: Dynamic Form in Apache Zeppelin</title>
+ <meta name="description" content="Apache Zeppelin dynamically creates input forms. Depending on language backend, there're two different ways to create dynamic form.">
+ <meta name="author" content="The Apache Software Foundation">
+
+ <!-- Enable responsive viewport -->
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+ <!--[if lt IE 9]>
+ <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+ <![endif]-->
+
+ <link href="//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+
+ <!-- Le styles -->
+ <link href="/docs/0.7.3/assets/themes/zeppelin/bootstrap/css/bootstrap.css" rel="stylesheet">
+ <link href="/docs/0.7.3/assets/themes/zeppelin/css/style.css?body=1" rel="stylesheet" type="text/css">
+ <link href="/docs/0.7.3/assets/themes/zeppelin/css/syntax.css" rel="stylesheet" type="text/css" media="screen" />
+ <!-- Le fav and touch icons -->
+ <!-- Update these with your own images
+ <link rel="shortcut icon" href="images/favicon.ico">
+ <link rel="apple-touch-icon" href="images/apple-touch-icon.png">
+ <link rel="apple-touch-icon" sizes="72x72" href="images/apple-touch-icon-72x72.png">
+ <link rel="apple-touch-icon" sizes="114x114" href="images/apple-touch-icon-114x114.png">
+ -->
+
+ <!-- Js -->
+ <script src="https://code.jquery.com/jquery-1.10.2.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/bootstrap/js/bootstrap.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/docs.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/anchor.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/toc.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/lunr.min.js"></script>
+ <script src="/docs/0.7.3/assets/themes/zeppelin/js/search.js"></script>
+
+ <!-- atom & rss feed -->
+ <link href="/docs/0.7.3/atom.xml" type="application/atom+xml" rel="alternate" title="Sitewide ATOM Feed">
+ <link href="/docs/0.7.3/rss.xml" type="application/rss+xml" rel="alternate" title="Sitewide RSS Feed">
+ </head>
+
+ <body>
+
+ <div id="menu" class="navbar navbar-inverse navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <div class="navbar-brand">
+ <a class="navbar-brand-main" href="http://zeppelin.apache.org">
+ <img src="/assets/themes/zeppelin/img/zeppelin_logo.png" width="50" alt="I'm zeppelin">
+ <span style="vertical-align:middle">Zeppelin</span>
+ </a>
+ <a class="navbar-brand-version" href="/docs/0.7.3">
+ <span><small>0.7.3</small></span>
+ </a>
+ </div>
+ </div>
+ <nav class="navbar-collapse collapse" role="navigation">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Quick Start <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="/docs/0.7.3/index.html">What is Apache Zeppelin ?</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Getting Started</b><span></li>
+ <li><a href="/docs/0.7.3/install/install.html">Install</a></li>
+ <li><a href="/docs/0.7.3/install/configuration.html">Configuration</a></li>
+ <li><a href="/docs/0.7.3/quickstart/explorezeppelinui.html">Explore Zeppelin UI</a></li>
+ <li><a href="/docs/0.7.3/quickstart/tutorial.html">Tutorial</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Basic Feature Guide</b><span></li>
+ <li><a href="/docs/0.7.3/manual/dynamicform.html">Dynamic Form</a></li>
+ <li><a href="/docs/0.7.3/manual/publish.html">Publish your Paragraph</a></li>
+ <li><a href="/docs/0.7.3/manual/notebookashomepage.html">Customize Zeppelin Homepage</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>More</b><span></li>
+ <li><a href="/docs/0.7.3/install/upgrade.html">Upgrade Zeppelin Version</a></li>
+ <li><a href="/docs/0.7.3/install/build.html">Build from source</a></li>
+ <li><a href="/docs/0.7.3/quickstart/install_with_flink_and_spark_cluster.html">Install Zeppelin with Flink and Spark Clusters Tutorial</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Interpreter <b class="caret"></b></a>
+ <ul class="dropdown-menu scrollable-menu">
+ <li><a href="/docs/0.7.3/manual/interpreters.html">Overview</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Usage</b><span></li>
+ <li><a href="/docs/0.7.3/manual/interpreterinstallation.html">Interpreter Installation</a></li>
+ <!--<li><a href="/docs/0.7.3/manual/dynamicinterpreterload.html">Dynamic Interpreter Loading</a></li>-->
+ <li><a href="/docs/0.7.3/manual/dependencymanagement.html">Interpreter Dependency Management</a></li>
+ <li><a href="/docs/0.7.3/manual/userimpersonation.html">Interpreter User Impersonation</a></li>
+ <li><a href="/docs/0.7.3/manual/interpreterexechooks.html">Interpreter Execution Hooks (Experimental)</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Available Interpreters</b><span></li>
+ <li><a href="/docs/0.7.3/interpreter/alluxio.html">Alluxio</a></li>
+ <li><a href="/docs/0.7.3/interpreter/beam.html">Beam</a></li>
+ <li><a href="/docs/0.7.3/interpreter/bigquery.html">BigQuery</a></li>
+ <li><a href="/docs/0.7.3/interpreter/cassandra.html">Cassandra</a></li>
+ <li><a href="/docs/0.7.3/interpreter/elasticsearch.html">Elasticsearch</a></li>
+ <li><a href="/docs/0.7.3/interpreter/flink.html">Flink</a></li>
+ <li><a href="/docs/0.7.3/interpreter/geode.html">Geode</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hbase.html">HBase</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hdfs.html">HDFS</a></li>
+ <li><a href="/docs/0.7.3/interpreter/hive.html">Hive</a></li>
+ <li><a href="/docs/0.7.3/interpreter/ignite.html">Ignite</a></li>
+ <li><a href="/docs/0.7.3/interpreter/jdbc.html">JDBC</a></li>
+ <li><a href="/docs/0.7.3/interpreter/kylin.html">Kylin</a></li>
+ <li><a href="/docs/0.7.3/interpreter/lens.html">Lens</a></li>
+ <li><a href="/docs/0.7.3/interpreter/livy.html">Livy</a></li>
+ <li><a href="/docs/0.7.3/interpreter/markdown.html">Markdown</a></li>
+ <li><a href="/docs/0.7.3/interpreter/pig.html">Pig</a></li>
+ <li><a href="/docs/0.7.3/interpreter/python.html">Python</a></li>
+ <li><a href="/docs/0.7.3/interpreter/postgresql.html">Postgresql, HAWQ</a></li>
+ <li><a href="/docs/0.7.3/interpreter/r.html">R</a></li>
+ <li><a href="/docs/0.7.3/interpreter/scalding.html">Scalding</a></li>
+ <li><a href="/docs/0.7.3/interpreter/scio.html">Scio</a></li>
+ <li><a href="/docs/0.7.3/interpreter/shell.html">Shell</a></li>
+ <li><a href="/docs/0.7.3/interpreter/spark.html">Spark</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">Display System <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li class="title"><span><b>Basic Display System</b><span></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#text">Text</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#html">Html</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/basicdisplaysystem.html#table">Table</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Angular API</b><span></li>
+ <li><a href="/docs/0.7.3/displaysystem/back-end-angular.html">Angular (backend API)</a></li>
+ <li><a href="/docs/0.7.3/displaysystem/front-end-angular.html">Angular (frontend API)</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#" data-toggle="dropdown" class="dropdown-toggle">More<b class="caret"></b></a>
+ <ul class="dropdown-menu scrollable-menu" style="right: 0; left: auto;">
+ <li class="title"><span><b>Notebook Storage</b><span></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-local-git-repository">Git Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-s3">S3 Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#notebook-storage-in-azure">Azure Storage</a></li>
+ <li><a href="/docs/0.7.3/storage/storage.html#storage-in-zeppelinhub">ZeppelinHub Storage</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>REST API</b><span></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-interpreter.html">Interpreter API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-notebook.html">Notebook API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-notebookRepo.html">Notebook Repository API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-configuration.html">Configuration API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-credential.html">Credential API</a></li>
+ <li><a href="/docs/0.7.3/rest-api/rest-helium.html">Helium API</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Security</b><span></li>
+ <li><a href="/docs/0.7.3/security/shiroauthentication.html">Shiro Authentication</a></li>
+ <li><a href="/docs/0.7.3/security/notebook_authorization.html">Notebook Authorization</a></li>
+ <li><a href="/docs/0.7.3/security/datasource_authorization.html">Data Source Authorization</a></li>
+ <li><a href="/docs/0.7.3/security/http_security_headers.html">HTTP Security Headers</a></li>
+ <li><a href="/docs/0.7.3/security/helium_authorization.html">Helium Authorization</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Advanced</b><span></li>
+ <li><a href="/docs/0.7.3/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li>
+ <li><a href="/docs/0.7.3/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li>
+ <li><a href="/docs/0.7.3/install/cdh.html">Zeppelin on CDH</a></li>
+ <li role="separator" class="divider"></li>
+ <li class="title"><span><b>Contibute</b><span></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelinvisualization.html">Writing Zeppelin Visualization (Experimental)</a></li>
+ <li><a href="/docs/0.7.3/development/writingzeppelinapplication.html">Writing Zeppelin Application (Experimental)</a></li>
+ <li><a href="/docs/0.7.3/development/howtocontribute.html">How to contribute (code)</a></li>
+ <li><a href="/docs/0.7.3/development/howtocontributewebsite.html">How to contribute (website)</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="/docs/0.7.3/search.html" class="nav-search-link">
+ <span class="fa fa-search nav-search-icon"></span>
+ </a>
+ </li>
+ </ul>
+ </nav><!--/.navbar-collapse -->
+ </div>
+ </div>
+
+
+
+ <div class="content">
+
+<!--<div class="hero-unit Dynamic Form in Apache Zeppelin">
+ <h1></h1>
+</div>
+-->
+
+<div class="row">
+ <div class="col-md-12">
+ <!--
+Licensed 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.
+-->
+
+<h1>Dynamic Form</h1>
+
+<div id="toc"></div>
+
+<p>Apache Zeppelin dynamically creates input forms. Depending on language backend, there're two different ways to create dynamic form.
+Custom language backend can select which type of form creation it wants to use.</p>
+
+<h2>Using form Templates</h2>
+
+<p>This mode creates form using simple template language. It's simple and easy to use. For example Markdown, Shell, Spark SQL language backend uses it.</p>
+
+<h3>Text input form</h3>
+
+<p>To create text input form, use <code>${formName}</code> templates.</p>
+
+<p>for example</p>
+
+<p><img class="img-responsive" src="/assets/themes/zeppelin/img/screenshots/form_input.png" width="450px" /></p>
+
+<p>Also you can provide default value, using <code>${formName=defaultValue}</code>.</p>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_input_default.png" /></p>
+
+<h3>Select form</h3>
+
+<p>To create select form, use <code>${formName=defaultValue,option1|option2...}</code></p>
+
+<p>for example</p>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_select.png" /></p>
+
+<p>Also you can separate option's display name and value, using <code>${formName=defaultValue,option1(DisplayName)|option2(DisplayName)...}</code></p>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_select_displayname.png" /></p>
+
+<p>The paragraph will be automatically run after you change your selection by default.
+But in case you have multiple types dynamic form in one paragraph, you might want to run the paragraph after changing all the selections.
+You can control this by unchecking the below <strong>Run on selection change</strong> option in the setting menu.
+Even if you uncheck this option, still you can run it by pressing <code>Enter</code>.</p>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/selectForm-checkbox.png" /></p>
+
+<h3>Checkbox form</h3>
+
+<p>For multi-selection, you can create a checkbox form using <code>${checkbox:formName=defaultValue1|defaultValue2...,option1|option2...}</code>. The variable will be substituted by a comma-separated string based on the selected items. For example:</p>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_checkbox.png"></p>
+
+<p>Besides, you can specify the delimiter using <code>${checkbox(delimiter):formName=...}</code>:</p>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_checkbox_delimiter.png"></p>
+
+<p>Like <a href="#select-form">select form</a>, the paragraph will be automatically run after you change your selection by default.
+But in case you have multiple types of dynamic form in one paragraph, you might want to run the paragraph after changing all the selections.
+You can control this by unchecking the below <strong>Run on selection change</strong> option in the setting menu.
+Even if you uncheck this option, still you can run it by pressing <code>Enter</code>.</p>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/selectForm-checkbox.png" /></p>
+
+<h2>Creates Programmatically</h2>
+
+<p>Some language backend uses programmatic way to create form. For example <a href="../interpreter/spark.html#zeppelincontext">ZeppelinContext</a> provides form creation API</p>
+
+<p>Here're some examples.</p>
+
+<h3>Text input form</h3>
+
+<div class="codetabs">
+ <div data-lang="scala" markdown="1">
+
+
+<div class="highlight"><pre><code class="scala"><span class="o">%</span><span class="n">spark</span>
+<span class="n">println</span><span class="o">(</span><span class="s">"Hello "</span><span class="o">+</span><span class="n">z</span><span class="o">.</span><span class="n">input</span><span class="o">(</span><span class="s">"name"</span><span class="o">))</span>
+</code></pre></div>
+
+
+ </div>
+ <div data-lang="python" markdown="1">
+
+
+<div class="highlight"><pre><code class="python"><span class="o">%</span><span class="n">pyspark</span>
+<span class="k">print</span><span class="p">(</span><span class="s">"Hello "</span><span class="o">+</span><span class="n">z</span><span class="o">.</span><span class="n">input</span><span class="p">(</span><span class="s">"name"</span><span class="p">))</span>
+</code></pre></div>
+
+
+ </div>
+</div>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_input_prog.png" /></p>
+
+<h3>Text input form with default value</h3>
+
+<div class="codetabs">
+ <div data-lang="scala" markdown="1">
+
+
+<div class="highlight"><pre><code class="scala"><span class="o">%</span><span class="n">spark</span>
+<span class="n">println</span><span class="o">(</span><span class="s">"Hello "</span><span class="o">+</span><span class="n">z</span><span class="o">.</span><span class="n">input</span><span class="o">(</span><span class="s">"name"</span><span class="o">,</span> <span class="s">"sun"</span><span class="o">))</span>
+</code></pre></div>
+
+
+ </div>
+ <div data-lang="python" markdown="1">
+
+
+<div class="highlight"><pre><code class="python"><span class="o">%</span><span class="n">pyspark</span>
+<span class="k">print</span><span class="p">(</span><span class="s">"Hello "</span><span class="o">+</span><span class="n">z</span><span class="o">.</span><span class="n">input</span><span class="p">(</span><span class="s">"name"</span><span class="p">,</span> <span class="s">"sun"</span><span class="p">))</span>
+</code></pre></div>
+
+
+ </div>
+</div>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_input_default_prog.png" /></p>
+
+<h3>Select form</h3>
+
+<div class="codetabs">
+ <div data-lang="scala" markdown="1">
+
+
+<div class="highlight"><pre><code class="scala"><span class="o">%</span><span class="n">spark</span>
+<span class="n">println</span><span class="o">(</span><span class="s">"Hello "</span><span class="o">+</span><span class="n">z</span><span class="o">.</span><span class="n">select</span><span class="o">(</span><span class="s">"day"</span><span class="o">,</span> <span class="nc">Seq</span><span class="o">((</span><span class="s">"1"</span><span class="o">,</span><span class="s">"mon"</span><span class="o">),</span>
+ <span class="o">(</span><span class="s">"2"</span><span class="o">,</span><span class="s">"tue"</span><span class="o">),</span>
+ <span class="o">(</span><span class="s">"3"</span><span class="o">,</span><span class="s">"wed"</span><span class="o">),</span>
+ <span class="o">(</span><span class="s">"4"</span><span class="o">,</span><span class="s">"thurs"</span><span class="o">),</span>
+ <span class="o">(</span><span class="s">"5"</span><span class="o">,</span><span class="s">"fri"</span><span class="o">),</span>
+ <span class="o">(</span><span class="s">"6"</span><span class="o">,</span><span class="s">"sat"</span><span class="o">),</span>
+ <span class="o">(</span><span class="s">"7"</span><span class="o">,</span><span class="s">"sun"</span><span class="o">))))</span>
+</code></pre></div>
+
+
+ </div>
+ <div data-lang="python" markdown="1">
+
+
+<div class="highlight"><pre><code class="python"><span class="o">%</span><span class="n">pyspark</span>
+<span class="k">print</span><span class="p">(</span><span class="s">"Hello "</span><span class="o">+</span><span class="n">z</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="s">"day"</span><span class="p">,</span> <span class="p">[(</span><span class="s">"1"</span><span class="p">,</span><span class="s">"mon"</span><span class="p">),</span>
+ <span class="p">(</span><span class="s">"2"</span><span class="p">,</span><span class="s">"tue"</span><span class="p">),</span>
+ <span class="p">(</span><span class="s">"3"</span><span class="p">,</span><span class="s">"wed"</span><span class="p">),</span>
+ <span class="p">(</span><span class="s">"4"</span><span class="p">,</span><span class="s">"thurs"</span><span class="p">),</span>
+ <span class="p">(</span><span class="s">"5"</span><span class="p">,</span><span class="s">"fri"</span><span class="p">),</span>
+ <span class="p">(</span><span class="s">"6"</span><span class="p">,</span><span class="s">"sat"</span><span class="p">),</span>
+ <span class="p">(</span><span class="s">"7"</span><span class="p">,</span><span class="s">"sun"</span><span class="p">)]))</span>
+</code></pre></div>
+
+
+ </div>
+</div>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_select_prog.png" /></p>
+
+<h4>Checkbox form</h4>
+
+<div class="codetabs">
+ <div data-lang="scala" markdown="1">
+
+
+<div class="highlight"><pre><code class="scala"><span class="o">%</span><span class="n">spark</span>
+<span class="k">val</span> <span class="n">options</span> <span class="k">=</span> <span class="nc">Seq</span><span class="o">((</span><span class="s">"apple"</span><span class="o">,</span><span class="s">"Apple"</span><span class="o">),</span> <span class="o">(</span><span class="s">"banana"</span><span class="o">,</span><span class="s">"Banana"</span><span class="o">),</span> <span class="o">(</span><span class="s">"orange"</span><span class="o">,</span><span class="s">"Orange"</span><span class="o">))</span>
+<span class="n">println</span><span class="o">(</span><span class="s">"Hello "</span><span class="o">+</span><span class="n">z</span><span class="o">.</span><span class="n">checkbox</span><span class="o">(</span><span class="s">"fruit"</span><span class="o">,</span> <span class="n">options</span><span class="o">).</span><span class="n">mkString</span><span class="o">(</span><span class="s">" and "</span><span class="o">))</span>
+</code></pre></div>
+
+
+ </div>
+ <div data-lang="python" markdown="1">
+
+
+<div class="highlight"><pre><code class="python"><span class="o">%</span><span class="n">pyspark</span>
+<span class="n">options</span> <span class="o">=</span> <span class="p">[(</span><span class="s">"apple"</span><span class="p">,</span><span class="s">"Apple"</span><span class="p">),</span> <span class="p">(</span><span class="s">"banana"</span><span class="p">,</span><span class="s">"Banana"</span><span class="p">),</span> <span class="p">(</span><span class="s">"orange"</span><span class="p">,</span><span class="s">"Orange"</span><span class="p">)]</span>
+<span class="k">print</span><span class="p">(</span><span class="s">"Hello "</span><span class="o">+</span> <span class="s">" and "</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">z</span><span class="o">.</span><span class="n">checkbox</span><span class="p">(</span><span class="s">"fruit"</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="p">[</span><span class="s">"apple"</span><span class="p">])))</span>
+</code></pre></div>
+
+
+ </div>
+</div>
+
+<p><img src="../assets/themes/zeppelin/img/screenshots/form_checkbox_prog.png" /></p>
+
+ </div>
+</div>
+
+
+ <hr>
+ <footer>
+ <!-- <p>© 2017 The Apache Software Foundation</p>-->
+ </footer>
+ </div>
+
+
+
+
+ <script type="text/javascript">
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-45176241-5', 'zeppelin.apache.org');
+ ga('require', 'linkid', 'linkid.js');
+ ga('send', 'pageview');
+
+</script>
+
+
+
+ </body>
+</html>
+