|
@@ -1,24 +1,24 @@
|
|
|
<h1><a name="Beeswax-IntroducingBeeswax"></a>Introducing Beeswax</h1>
|
|
<h1><a name="Beeswax-IntroducingBeeswax"></a>Introducing Beeswax</h1>
|
|
|
|
|
|
|
|
-<p>The Beeswax application enables you to perform queries on Apache Hive, a data warehousing system designed to work with Hadoop. You can create Hive tables, load data, run and manage Hive queries, and download the results in a Microsoft Office Excel worksheet file or a comma-separated values file.</p>
|
|
|
|
|
|
|
+<p>The Beeswax application enables you to perform queries on Apache Hive, a data warehousing system designed to work with Hadoop. For information about Hive, see <a href="http://archive.cloudera.com/cdh4/cdh/4/hive/">Hive Documentation</a>. You can create Hive tables, load data, create, run, and manage queries, and download the results in a Microsoft Office Excel worksheet file or a comma-separated values file.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2><a name="Beeswax-Contents"></a>Contents</h2>
|
|
<h2><a name="Beeswax-Contents"></a>Contents</h2>
|
|
|
|
|
|
|
|
<style type='text/css'>/*<![CDATA[*/
|
|
<style type='text/css'>/*<![CDATA[*/
|
|
|
-div.rbtoc1348176344574 {margin-left: 1.5em;padding: 0px;}
|
|
|
|
|
-div.rbtoc1348176344574 ul {margin-left: 0px;padding-left: 20px;}
|
|
|
|
|
-div.rbtoc1348176344574 li {margin-left: 0px;padding-left: 0px;}
|
|
|
|
|
|
|
+div.rbtoc1359395567394 {margin-left: 1.5em;padding: 0px;}
|
|
|
|
|
+div.rbtoc1359395567394 ul {margin-left: 0px;padding-left: 20px;}
|
|
|
|
|
+div.rbtoc1359395567394 li {margin-left: 0px;padding-left: 0px;}
|
|
|
|
|
|
|
|
-/*]]>*/</style><div class='rbtoc1348176344574'>
|
|
|
|
|
|
|
+/*]]>*/</style><div class='rbtoc1359395567394'>
|
|
|
<ul>
|
|
<ul>
|
|
|
<li><a href='#Beeswax-IntroducingBeeswax'>Introducing Beeswax</a></li>
|
|
<li><a href='#Beeswax-IntroducingBeeswax'>Introducing Beeswax</a></li>
|
|
|
<li><a href='#Beeswax-BeeswaxandHiveInstallationandConfiguration'>Beeswax and Hive Installation and Configuration</a></li>
|
|
<li><a href='#Beeswax-BeeswaxandHiveInstallationandConfiguration'>Beeswax and Hive Installation and Configuration</a></li>
|
|
|
<li><a href='#Beeswax-StartingBeeswax'>Starting Beeswax</a></li>
|
|
<li><a href='#Beeswax-StartingBeeswax'>Starting Beeswax</a></li>
|
|
|
<ul>
|
|
<ul>
|
|
|
<ul>
|
|
<ul>
|
|
|
- <li><a href='#Beeswax-InstallingtheBeeswaxSamples'>Installing the Beeswax Samples</a></li>
|
|
|
|
|
- <li><a href='#Beeswax-ImportingyourownData'>Importing your own Data</a></li>
|
|
|
|
|
|
|
+ <li><a href='#Beeswax-InstallingtheSampleTables'>Installing the Sample Tables</a></li>
|
|
|
|
|
+ <li><a href='#Beeswax-ImportingYourOwnData'>Importing Your Own Data</a></li>
|
|
|
</ul>
|
|
</ul>
|
|
|
</ul>
|
|
</ul>
|
|
|
<li><a href='#Beeswax-WorkingwithQueries'>Working with Queries</a></li>
|
|
<li><a href='#Beeswax-WorkingwithQueries'>Working with Queries</a></li>
|
|
@@ -33,6 +33,7 @@ div.rbtoc1348176344574 li {margin-left: 0px;padding-left: 0px;}
|
|
|
<li><a href='#Beeswax-WorkingwithTables'>Working with Tables</a></li>
|
|
<li><a href='#Beeswax-WorkingwithTables'>Working with Tables</a></li>
|
|
|
<ul>
|
|
<ul>
|
|
|
<ul>
|
|
<ul>
|
|
|
|
|
+ <li><a href='#Beeswax-SelectingtheDatabase'>Selecting the Database</a></li>
|
|
|
<li><a href='#Beeswax-CreatingTables'>Creating Tables</a></li>
|
|
<li><a href='#Beeswax-CreatingTables'>Creating Tables</a></li>
|
|
|
<li><a href='#Beeswax-BrowsingTables'>Browsing Tables</a></li>
|
|
<li><a href='#Beeswax-BrowsingTables'>Browsing Tables</a></li>
|
|
|
<li><a href='#Beeswax-ImportingDataintoTables'>Importing Data into Tables</a></li>
|
|
<li><a href='#Beeswax-ImportingDataintoTables'>Importing Data into Tables</a></li>
|
|
@@ -45,77 +46,51 @@ div.rbtoc1348176344574 li {margin-left: 0px;padding-left: 0px;}
|
|
|
|
|
|
|
|
<h1><a name="Beeswax-BeeswaxandHiveInstallationandConfiguration"></a>Beeswax and Hive Installation and Configuration</h1>
|
|
<h1><a name="Beeswax-BeeswaxandHiveInstallationandConfiguration"></a>Beeswax and Hive Installation and Configuration</h1>
|
|
|
|
|
|
|
|
-<p>Beeswax is installed and configured as part of Hue. For more information about installing Hue, see <a href="https://ccp.cloudera.com/display/CDH4DOC/Hue+Installation">Hue Installation</a>.</p>
|
|
|
|
|
|
|
+<p>Beeswax is installed and configured as part of Hue. For information about installing and configuring Hue, see <a href="https://ccp.cloudera.com/display/CDH4DOC/Hue+Installation">Hue Installation</a>.</p>
|
|
|
|
|
|
|
|
-<p>Beeswax assumes an existing Hive installation. The Hue installation instructions include the configuration necessary for Beeswax to access Hive. You can view the current Hive configuration from from the <b>Settings</b> tab in the Beeswax application.</p>
|
|
|
|
|
|
|
+<p>Beeswax assumes an existing Hive installation. The Hue installation instructions include the configuration necessary for Beeswax to access Hive. You can view the current Hive configuration from from the <b>Settings</b> tab in the Beeswax application.</p>
|
|
|
|
|
|
|
|
-<p>By default, a Beeswax user can see the saved queries for all users – both his/her own queries and those of other Beeswax users. If this behavior is not desirable, there is a configuration option you can change in the <tt>/etc/hue/hue.ini</tt> file under the <tt>[beeswax]</tt> section to restrict viewing saved queries to only the query owner and Hue administrators. To change this setting, find and uncomment the <tt>share_saved_queries</tt> property and set it to <tt>false</tt>.</p>
|
|
|
|
|
|
|
+<p>By default, a Beeswax user can see the saved queries for all users – both his/her own queries and those of other Beeswax users. To restrict viewing saved queries to the query owner and Hue administrators, set the <tt>share_saved_queries</tt> property under the <tt>[beeswax]</tt> section in the Hue configuration file to <tt>false</tt>. </p>
|
|
|
|
|
|
|
|
|
|
|
|
|
<h1><a name="Beeswax-StartingBeeswax"></a>Starting Beeswax</h1>
|
|
<h1><a name="Beeswax-StartingBeeswax"></a>Starting Beeswax</h1>
|
|
|
|
|
|
|
|
-<p>To start the Beeswax application, click the <b>Beeswax</b> icon ( <span class="image-wrap" style=""><img src="/beeswax/static/art/beeswax-logo.png" width="30" style="border: 0px solid black"/></span>) in the navigation bar at the top of the Hue browser page.</p>
|
|
|
|
|
|
|
+<p>To start the Beeswax application, click the <b>Beeswax</b> icon (<span class="image-wrap" style=""><img src="/beeswax/static/help/images/23888161.png" width="30" style="border: 0px solid black"/></span>) in the navigation bar at the top of the Hue browser page.</p>
|
|
|
|
|
|
|
|
-<p>The first time you run Beeswax, the "Welcome to Beeswax for Hive" page appears, and prompts you to install the sample tables or import your own tables.</p>
|
|
|
|
|
|
|
+<h3><a name="Beeswax-InstallingtheSampleTables"></a>Installing the Sample Tables</h3>
|
|
|
|
|
|
|
|
-<p>Once some tables have been created — either from installing the samples or importing your own data — clicking the Beeswax tab will bring you directly into the Query Editor.</p>
|
|
|
|
|
-
|
|
|
|
|
-<p>The tabs in the Beeswax navigation bar allow you to navigate to the main functional areas of Beeswax.</p>
|
|
|
|
|
-
|
|
|
|
|
-<h3><a name="Beeswax-InstallingtheBeeswaxSamples"></a>Installing the Beeswax Samples</h3>
|
|
|
|
|
-
|
|
|
|
|
-<p>You can install two sample Beeswax tables to use as examples.</p>
|
|
|
|
|
|
|
+<p>You can install two sample tables to use as examples.</p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the <b>Welcome to Beeswax</b> window, click <b>Install Samples</b>
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Confirm that you want to install these samples.
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
|
|
+ <li>In the Beeswax window, click <b>Tables</b>.</li>
|
|
|
|
|
+ <li>In the ACTIONS pane, click <b>Install samples</b>.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
|
-<p>Once you have installed the sample data, you will no longer see either the <b>Import Data</b> and <b>Install Samples</b> buttons when you run Beeswax.</p>
|
|
|
|
|
|
|
+<p>Once you have installed the sample data, you will no longer see the <b>Install samples</b> link.</p>
|
|
|
|
|
|
|
|
-<h3><a name="Beeswax-ImportingyourownData"></a>Importing your own Data</h3>
|
|
|
|
|
|
|
+<h3><a name="Beeswax-ImportingYourOwnData"></a>Importing Your Own Data</h3>
|
|
|
|
|
|
|
|
-<p>If you want to import your own data instead of installing the Sample tables:</p>
|
|
|
|
|
-
|
|
|
|
|
-<ol>
|
|
|
|
|
- <li>In the <b>Welcome to Beeswax</b> window, click the <b>Import Data</b> button.<br/>
|
|
|
|
|
-This takes you to the <b>Create a new table manually</b> page.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Follow the prompts in this wizard to specify your table. For more details see <a href="#Beeswax-CreatingTables">Creating Tables</a>.
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
-</ol>
|
|
|
|
|
-
|
|
|
|
|
-
|
|
|
|
|
-<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/static/art/help/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>Note</b><br />If the <b>Welcome to Beeswax</b> page with the <b>Import Data</b> button no longer appears, you can still import your own data by clicking the <b>Tables</b> tab, and creating a new table.</td></tr></table></div>
|
|
|
|
|
-<p><br class="atl-forced-newline" /></p>
|
|
|
|
|
|
|
+<p>If you want to import your own data instead of installing the sample tables, following the procedure in <a href="#Beeswax-CreatingTables">Creating Tables</a>.</p>
|
|
|
|
|
|
|
|
<h1><a name="Beeswax-WorkingwithQueries"></a>Working with Queries</h1>
|
|
<h1><a name="Beeswax-WorkingwithQueries"></a>Working with Queries</h1>
|
|
|
|
|
|
|
|
-<p>The <b>Query Editor</b> view lets you create queries in Hive's Query Language (HQL), which is similar to Structured Query Language (SQL). You can name and save your queries to use later. When you submit a query, the Beeswax Server uses Hive to run the queries. You can either wait for the query to complete, or return later to find the queries in the <b>Beeswax History</b> view. You can also request receive an email message after the query is completed.</p>
|
|
|
|
|
-
|
|
|
|
|
-<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/static/art/help/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>For More Information</b><br />For information about HQL syntax, see <a href="http://wiki.apache.org/hadoop/Hive/LanguageManual.">http://wiki.apache.org/hadoop/Hive/LanguageManual.</a></td></tr></table></div>
|
|
|
|
|
|
|
+<p>The Query Editor view lets you create queries in the <a href="http://wiki.apache.org/hadoop/Hive/LanguageManual">Hive Query Language (HQL)</a>, which is similar to Structured Query Language (SQL). You can name and save your queries to use later. When you submit a query, the Beeswax Server uses Hive to run the queries. You can either wait for the query to complete, or return later to find the queries in the History view. You can also request receive an email message after the query is completed.</p>
|
|
|
|
|
|
|
|
<h3><a name="Beeswax-CreatingandRunningQueries"></a>Creating and Running Queries</h3>
|
|
<h3><a name="Beeswax-CreatingandRunningQueries"></a>Creating and Running Queries</h3>
|
|
|
|
|
|
|
|
-<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/static/art/help/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>Note</b><br />To run a Query, you must be logged in to Hue as a user that also has a Unix user account on the remote server.</td></tr></table></div>
|
|
|
|
|
|
|
+<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/static/art/help/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>Note</b><br />To run a query, you must be logged in to Hue as a user that also has a Unix user account on the remote server.</td></tr></table></div>
|
|
|
|
|
|
|
|
<p><b>To create and run a query</b>:</p>
|
|
<p><b>To create and run a query</b>:</p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the Beeswax <b>Hive Query</b> window, type the query.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-For example, to select all data from the <em>sample_08</em> table, you would type:
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<tt>SELECT * FROM sample_08 WHERE salary > 100000</tt>
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>In the box to the left of the Query field, you can override the default Hive and Hadoop settings, specify file resources and user-defined functions, and enable users to enter parameters at run-time, and request email notification when the job is complete. See <a href="#Beeswax-AdvancedSettings">Advanced Query Settings</a> below for details on using these settings.
|
|
|
|
|
|
|
+ <li>In the Query Editor window, type the query. For example, to select all data from the <em>sample_08</em> table, you would type:
|
|
|
|
|
+<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
|
|
|
|
|
+<div id="root">
|
|
|
|
|
+ <pre class="theme: Default; brush: plain; gutter: false">SELECT * FROM sample_08</pre>
|
|
|
|
|
+ </div>
|
|
|
|
|
+</div></div></li>
|
|
|
|
|
+ <li>In the box to the left of the Query field, you can override the default Hive and Hadoop settings, specify file resources and user-defined functions, and enable users to enter parameters at run-time, and request email notification when the job is complete. See <a href="#Beeswax-AdvancedSettings">Advanced Query Settings</a> for details on using these settings.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>To save your query and advanced settings to use again later, click <b>Save As,</b> enter a name and description, and then click <b>OK</b>. To save changes to an existing query, click <b>Save.</b>
|
|
<li>To save your query and advanced settings to use again later, click <b>Save As,</b> enter a name and description, and then click <b>OK</b>. To save changes to an existing query, click <b>Save.</b>
|
|
@@ -127,46 +102,44 @@ For example, to select all data from the <em>sample_08</em> table, you would typ
|
|
|
<li>To run the query, click <b>Execute</b>.
|
|
<li>To run the query, click <b>Execute</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<a name="Beeswax-QueryResults"></a><br/>
|
|
<a name="Beeswax-QueryResults"></a><br/>
|
|
|
-The Beeswax <b>Query Results</b> window appears with the results of your query.
|
|
|
|
|
|
|
+The Query Results window displays with the results of the query.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>Do any of the following to download or save the query results:
|
|
<li>Do any of the following to download or save the query results:
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<ul>
|
|
<ul>
|
|
|
- <li>Click <b>Download as CSV</b> to download the results in a comma-separated values file suitable for use in other applications.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Click <b>Download as XLS</b> to download the results in a Microsoft Office Excel worksheet file.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
|
|
+ <li>Click <b>Download as CSV</b> to download the results in a comma-separated values file suitable for use in other applications.</li>
|
|
|
|
|
+ <li>Click <b>Download as XLS</b> to download the results in a Microsoft Office Excel worksheet file.</li>
|
|
|
<li>Click <b>Save</b> to save the results in a table or HDFS file.
|
|
<li>Click <b>Save</b> to save the results in a table or HDFS file.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-To save the results in a new table, select <b>to a new table</b>, enter a name, and then click <b>Save</b>.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-To save the results in an HDFS file, select <b>to HDFS directory</b>, enter a path in <b>Results Location</b> and then click <b>Save</b>.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Under <b>MR Jobs</b>, you can view any Map/Reduce jobs that the query started.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>To view a log of the query execution, click <b>Log</b> at the top of the results display. You can use the information in this tab to debug your query.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>To view the query that generated these results, click <b>Query</b> at the top of the results display.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>To return to the query in the <b>Query Editor,</b> click <b>Unsaved Query</b>.</li>
|
|
|
|
|
|
|
+ <ul>
|
|
|
|
|
+ <li>To save the results in a new table, select <b>In a new table</b>, enter a table name, and then click <b>Save</b>.</li>
|
|
|
|
|
+ <li>To save the results in an HDFS file, select <b>In an HDFS directory</b>, enter a path and then click <b>Save</b>. You can then download the file with FileBrowser.
|
|
|
|
|
+<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/static/art/help/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><ul>
|
|
|
|
|
+ <li>You can only save results to a file when the results were generated by a MapReduce job.</li>
|
|
|
|
|
+ <li>This is the preferred way to save when the result is large (for example > 1M rows).</li>
|
|
|
|
|
+</ul>
|
|
|
|
|
+</td></tr></table></div></li>
|
|
|
|
|
+ </ul>
|
|
|
|
|
+ </li>
|
|
|
</ul>
|
|
</ul>
|
|
|
</li>
|
|
</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
+<ul>
|
|
|
|
|
+ <li>Under <b>MR Jobs</b>, you can view any MapReduce jobs that the query started.</li>
|
|
|
|
|
+ <li>To view a log of the query execution, click <b>Log</b> at the top of the results display. You can use the information in this tab to debug your query.</li>
|
|
|
|
|
+ <li>To view the query that generated these results, click <b>Query</b> at the top of the results display.</li>
|
|
|
|
|
+ <li>To view the columns of the query, click <b>Columns</b>.</li>
|
|
|
|
|
+ <li>To return to the query in the Query Editor, click <b>Unsaved Query</b>.</li>
|
|
|
|
|
+</ul>
|
|
|
|
|
+
|
|
|
|
|
|
|
|
<p><a name="Beeswax-AdvancedSettings"></a></p>
|
|
<p><a name="Beeswax-AdvancedSettings"></a></p>
|
|
|
|
|
|
|
|
<h3><a name="Beeswax-AdvancedQuerySettings"></a>Advanced Query Settings</h3>
|
|
<h3><a name="Beeswax-AdvancedQuerySettings"></a>Advanced Query Settings</h3>
|
|
|
|
|
|
|
|
-<p>The section to the left of the Query field lets you specify the following options:
|
|
|
|
|
|
|
+<p>The pane to the left of the Query Editor lets you specify the following options:
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></p>
|
|
<br class="atl-forced-newline" /></p>
|
|
|
|
|
|
|
@@ -193,18 +166,21 @@ vertical-align: center;
|
|
|
<th class='confluenceTh'> Description </th>
|
|
<th class='confluenceTh'> Description </th>
|
|
|
</tr>
|
|
</tr>
|
|
|
<tr>
|
|
<tr>
|
|
|
-<td class='confluenceTd'> <b>Hive Settings</b> </td>
|
|
|
|
|
-<td class='confluenceTd'> Use <b>Hive Settings</b> to override the Hive and Hadoop default settings. Click <b>Add</b> to configure a new setting. <br class="atl-forced-newline" />
|
|
|
|
|
|
|
+<td class='confluenceTd'> <b>DATABASE</b> </td>
|
|
|
|
|
+<td class='confluenceTd'> The database containing the table definitions. </td>
|
|
|
|
|
+</tr>
|
|
|
|
|
+<tr>
|
|
|
|
|
+<td class='confluenceTd'> <b>SETTINGS</b> </td>
|
|
|
|
|
+<td class='confluenceTd'> Override the Hive and Hadoop default settings. Click <b>Add</b> to configure a new setting. <br class="atl-forced-newline" />
|
|
|
» For <b>Key</b>, enter a Hive or Hadoop configuration variable name. <br class="atl-forced-newline" />
|
|
» For <b>Key</b>, enter a Hive or Hadoop configuration variable name. <br class="atl-forced-newline" />
|
|
|
» For <b>Value</b>, enter the value you want to use for the variable. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
» For <b>Value</b>, enter the value you want to use for the variable. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
-For example, to override the directory where structured hive query logs are created, you would enter <tt>hive.querylog.location</tt> for <b>Key</b>, and a path for <b>Value.</b> <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
|
|
-Click <b>Add</b> again to add another new setting. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
|
|
|
|
+For example, to override the directory where structured <font color="#000000">Hive </font>query logs are created, you would enter <tt>hive.querylog.location</tt> for <b>Key</b>, and a path for <b>Value.</b> <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
To view the default settings, click the <b>Settings</b> tab at the top of the page. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
To view the default settings, click the <b>Settings</b> tab at the top of the page. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
-For information about Hive configuration variables, see: <a href="http://wiki.apache.org/hadoop/Hive/AdminManual/Configuration">http://wiki.apache.org/hadoop/Hive/AdminManual/Configuration</a>. For information about Hadoop configuration variables, see: <a href="http://hadoop.apache.org/common/docs/current/mapred-default.html">http://hadoop.apache.org/common/docs/current/mapred-default.html</a> </td>
|
|
|
|
|
|
|
+For information about Hive configuration variables, see: <a href="http://wiki.apache.org/hadoop/Hive/AdminManual/Configuration">http://wiki.apache.org/hadoop/Hive/AdminManual/Configuration</a>. For information about Hadoop configuration variables, see: <a href="http://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/mapred-default.xml">http://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/mapred-default.xml</a> </td>
|
|
|
</tr>
|
|
</tr>
|
|
|
<tr>
|
|
<tr>
|
|
|
-<td class='confluenceTd'> <b>File Resources</b> </td>
|
|
|
|
|
-<td class='confluenceTd'> Use <b>File Resources</b> to make locally accessible files available at query execution time on the entire Hadoop cluster. Hive uses Hadoop's Distributed Cache to distribute the added files to all machines in the cluster at query execution time. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
|
|
|
|
+<td class='confluenceTd'> <b>FILE RESOURCES</b> </td>
|
|
|
|
|
+<td class='confluenceTd'> Make locally accessible files available at query execution time on the entire Hadoop cluster. Hive uses Hadoop's Distributed Cache to distribute the added files to all machines in the cluster at query execution time. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
Click <b>Add</b> to configure a new setting. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
Click <b>Add</b> to configure a new setting. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
From the <b>Type</b> drop-down menu, choose one of the following: <br class="atl-forced-newline" />
|
|
From the <b>Type</b> drop-down menu, choose one of the following: <br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
@@ -214,23 +190,24 @@ From the <b>Type</b> drop-down menu, choose one of the following: <br class="atl
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<b>file</b> — Adds resources to the distributed cache. Typically, this might be a transform script (or similar) to be executed. <br class="atl-forced-newline" />
|
|
<b>file</b> — Adds resources to the distributed cache. Typically, this might be a transform script (or similar) to be executed. <br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-For <b>Path</b>, enter the path to the file. You can also click <b>Choose a File</b> to browse and select the file. <br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<b>Note</b>: It is not necessary to specify files used in a transform script if the files are available in the same path on all machines in the Hadoop cluster. </td>
|
|
|
|
|
|
|
+For <b>Path</b>, enter the path to the file or click <b>Choose a File</b> to browse and select the file.
|
|
|
|
|
+<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/static/art/help/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><br class="atl-forced-newline" />
|
|
|
|
|
+It is not necessary to specify files used in a transform script if the files are available in the same path on all machines in the Hadoop cluster.</td></tr></table></div>
|
|
|
|
|
+<p> </p></td>
|
|
|
</tr>
|
|
</tr>
|
|
|
<tr>
|
|
<tr>
|
|
|
-<td class='confluenceTd'> <b>User-defined Functions</b> </td>
|
|
|
|
|
-<td class='confluenceTd'> You can use user-defined functions in a query. Specify the function name for <b>Name</b>, and specify the class name for <b>Class</b> <b>name</b>. <br class="atl-forced-newline" />
|
|
|
|
|
|
|
+<td class='confluenceTd'> <b>USER-DEFINED FUNCTIONS</b> </td>
|
|
|
|
|
+<td class='confluenceTd'> Specify user-defined functions in a query. Specify the function name for <b>Name</b>, and specify the class name for <b>Class</b> <b>name</b>. <br class="atl-forced-newline" />
|
|
|
Click <b>Add</b> to configure a new setting. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
Click <b>Add</b> to configure a new setting. <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
You must specify a JAR file for the user-defined functions in <b>File Resources</b>. To include a user-defined function in a query, add a $ (dollar sign) before the function name in the query. For example, if <em>MyTable</em> is a user-defined function name in the query, you would type: <tt>SELECT * $MyTable</tt> </td>
|
|
You must specify a JAR file for the user-defined functions in <b>File Resources</b>. To include a user-defined function in a query, add a $ (dollar sign) before the function name in the query. For example, if <em>MyTable</em> is a user-defined function name in the query, you would type: <tt>SELECT * $MyTable</tt> </td>
|
|
|
</tr>
|
|
</tr>
|
|
|
<tr>
|
|
<tr>
|
|
|
-<td class='confluenceTd'> <b>Parameterization</b> </td>
|
|
|
|
|
-<td class='confluenceTd'> To display a dialog box for you or other users to enter parameter values when a query is executed, check <b>Parameterization</b>. This is enabled by default. </td>
|
|
|
|
|
|
|
+<td class='confluenceTd'> <b>PARAMETERIZATION</b> </td>
|
|
|
|
|
+<td class='confluenceTd'> Indicate that a dialog box should display to enter parameter values when a query containing the string $<parametername> is executed. Enabled by default. </td>
|
|
|
</tr>
|
|
</tr>
|
|
|
<tr>
|
|
<tr>
|
|
|
-<td class='confluenceTd'> <b>Email Notification</b> </td>
|
|
|
|
|
-<td class='confluenceTd'> To receive an email message after a query completes, check <b>Email Notification</b>. The email is sent to the email address specified in the logged-in user's profile. </td>
|
|
|
|
|
|
|
+<td class='confluenceTd'> <b>EMAIL NOTIFICATION</b> </td>
|
|
|
|
|
+<td class='confluenceTd'> Indicate that an email message should be sent after a query completes. The email is sent to the email address specified in the logged-in user's profile. </td>
|
|
|
</tr>
|
|
</tr>
|
|
|
</tbody></table>
|
|
</tbody></table>
|
|
|
</div>
|
|
</div>
|
|
@@ -239,17 +216,16 @@ You must specify a JAR file for the user-defined functions in <b>File Resources<
|
|
|
|
|
|
|
|
<h3><a name="Beeswax-ViewingQueryHistory"></a>Viewing Query History</h3>
|
|
<h3><a name="Beeswax-ViewingQueryHistory"></a>Viewing Query History</h3>
|
|
|
|
|
|
|
|
-<p>Beeswax enables you to view the history of queries that you have previously run. Results for these queries are available for one week or until Hue is restarted.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></p>
|
|
|
|
|
|
|
+<p>Beeswax enables you to view the history of queries that you have previously run. Results for these queries are available for one week or until Hue is restarted.</p>
|
|
|
|
|
+
|
|
|
|
|
|
|
|
<p><b>To view query history:</b></p>
|
|
<p><b>To view query history:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax</b> window, click <b>History</b>.
|
|
|
|
|
|
|
+ <li>In the Beeswax window, click <b>History</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays a list of your saved and unsaved queries in the Beeswax <b>Query History</b> window.
|
|
|
|
|
|
|
+Beeswax displays a list of your saved and unsaved queries in the Query History window.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>To display the queries for all users, click <b>Show everyone's queries</b>. To display your queries only, click <b>Show my queries</b>.
|
|
<li>To display the queries for all users, click <b>Show everyone's queries</b>. To display your queries only, click <b>Show my queries</b>.
|
|
@@ -261,94 +237,84 @@ Beeswax displays a list of your saved and unsaved queries in the Beeswax <b>Quer
|
|
|
|
|
|
|
|
<h3><a name="Beeswax-Viewing%2CEditing%2CorDeletingSavedQueries"></a>Viewing, Editing, or Deleting Saved Queries</h3>
|
|
<h3><a name="Beeswax-Viewing%2CEditing%2CorDeletingSavedQueries"></a>Viewing, Editing, or Deleting Saved Queries</h3>
|
|
|
|
|
|
|
|
-<p>You can view a list of saved queries of all users by clicking <b>Saved Queries</b> in the <b>Beeswax</b> window. You can copy any user's query, but you can only edit, delete, and view the history of your own queries.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></p>
|
|
|
|
|
|
|
+<p>You can view a list of saved queries of all users by clicking <b>Saved Queries</b> in the Beeswax window. You can copy any user's query, but you can only edit, delete, and view the history of your own queries.</p>
|
|
|
|
|
+
|
|
|
|
|
|
|
|
<p><b>To edit a saved query:</b></p>
|
|
<p><b>To edit a saved query:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax</b> window, click <b>Saved Queries</b>.
|
|
|
|
|
|
|
+ <li>In the Beeswax window, click <b>Saved Queries</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the Beeswax <b>Queries</b> window.
|
|
|
|
|
|
|
+The Queries window displays.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>Click the <b>Options</b> button next to the query and choose <b>Edit</b> from the context menu.
|
|
<li>Click the <b>Options</b> button next to the query and choose <b>Edit</b> from the context menu.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the query in the Beeswax <b>Query Editor</b> window.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Change the query and then click <b>Save.</b> You can also click <b>Save As</b>, enter a new name, and click <b>OK</b> to save a copy of the query.
|
|
|
|
|
|
|
+The query displays in the Query Editor window.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
|
|
+ <li>Change the query and then click <b>Save.</b> You can also click <b>Save As</b>, enter a new name, and click <b>OK</b> to save a copy of the query.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
|
<p><b>To delete a saved query:</b></p>
|
|
<p><b>To delete a saved query:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax</b> window, click <b>Saved Queries</b>.
|
|
|
|
|
|
|
+ <li>In the Beeswax window, click <b>Saved Queries</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the Beeswax <b>Queries</b> window.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Click the <b>Options</b> button next to the query and choose <b>Delete</b> from the context menu.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Click <b>Yes</b> to confirm the deletion.
|
|
|
|
|
|
|
+The Queries window displays.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
|
|
+ <li>Click the <b>Options</b> button next to the query and choose <b>Delete</b> from the context menu.</li>
|
|
|
|
|
+ <li>Click <b>Yes</b> to confirm the deletion.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
|
<p><b>To copy a saved query:</b></p>
|
|
<p><b>To copy a saved query:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax</b> window, click <b>Saved Queries</b>.
|
|
|
|
|
|
|
+ <li>In the Beeswax window, click <b>Saved Queries</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the Beeswax <b>Queries</b> window.
|
|
|
|
|
|
|
+The Queries window displays.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>Click the <b>Options</b> button next to the query and choose <b>Clone</b> from the context menu.
|
|
<li>Click the <b>Options</b> button next to the query and choose <b>Clone</b> from the context menu.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the query in the Beeswax <b>Query Editor</b> window.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Change the query as necessary and then click <b>Save.</b> You can also click <b>Save As</b>, enter a new name, and click <b>Ok</b> to save a copy of the query.
|
|
|
|
|
|
|
+Beeswax displays the query in the Query Editor window.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
|
|
+ <li>Change the query as necessary and then click <b>Save.</b> You can also click <b>Save As</b>, enter a new name, and click <b>Ok</b> to save a copy of the query.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
+
|
|
|
<p><b>To copy a query in the Beeswax Query History window:</b></p>
|
|
<p><b>To copy a query in the Beeswax Query History window:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax</b> window, click <b>History</b>.
|
|
|
|
|
|
|
+ <li>In the Beeswax window, click <b>History</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the Beeswax <b>Query History</b> window.
|
|
|
|
|
|
|
+The Query History window displays.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
- <li>To display the queries for all users, click <b>everyone's</b>.
|
|
|
|
|
|
|
+ <li>To display the queries for all users, click <b>Show everyone's queries</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the queries for all users in the Beeswax <b>Query History</b> window.
|
|
|
|
|
|
|
+The queries for all users display in the Query History window.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>Click the <b>Clone</b> link next to the query you want to copy.
|
|
<li>Click the <b>Clone</b> link next to the query you want to copy.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays a copy of the query in the Beeswax <b>Query Editor</b> window.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Change the query, if necessary, and then click <b>Save As</b>, enter a new name, and click <b>OK</b> to save the query.
|
|
|
|
|
|
|
+A copy of the query displays in the Query Editor window.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
|
|
+ <li>Change the query, if necessary, and then click <b>Save As</b>, enter a new name, and click <b>OK</b> to save the query.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
@@ -356,43 +322,45 @@ Beeswax displays a copy of the query in the Beeswax <b>Query Editor</b> window.
|
|
|
|
|
|
|
|
<p>When working with Hive tables, you can use Beeswax to:</p>
|
|
<p>When working with Hive tables, you can use Beeswax to:</p>
|
|
|
<ul>
|
|
<ul>
|
|
|
- <li>Create tables (see <a href="#Beeswax-CreatingTables">Creating Tables</a>)</li>
|
|
|
|
|
- <li>Browse tables (see <a href="#Beeswax-BrowsingTables">Browsing Tables</a>)</li>
|
|
|
|
|
- <li>Import data into tables (see <a href="#Beeswax-ImportingDataintoTables">Importing Data into Tables</a>)</li>
|
|
|
|
|
- <li>Drop tables (see <a href="#Beeswax-DroppingTables">Dropping Tables</a>)</li>
|
|
|
|
|
- <li>View the location of a table (see <a href="#Beeswax-ViewingaTable%27sLocation">Viewing a Table's Location</a>)
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
|
|
+ <li><a href="#Beeswax-SelectingtheDatabase">Select a database</a></li>
|
|
|
|
|
+ <li><a href="#Beeswax-CreatingTables">Create tables</a></li>
|
|
|
|
|
+ <li><a href="#Beeswax-BrowsingTables">Browse tables</a></li>
|
|
|
|
|
+ <li><a href="#Beeswax-ImportingDataintoTables">Import data into tables</a></li>
|
|
|
|
|
+ <li>Drop tables (see <a href="#Beeswax-DroppingTables">Dropping Tables</a></li>
|
|
|
|
|
+ <li><a href="#Beeswax-ViewingaTable%27sLocation">View the location of a table</a></li>
|
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
+<p><a name="Beeswax-SelectingtheDatabase"></a></p>
|
|
|
|
|
+<h3><a name="Beeswax-SelectingtheDatabase"></a>Selecting the Database</h3>
|
|
|
|
|
+
|
|
|
|
|
+<ol>
|
|
|
|
|
+ <li>In the pane on the left, select the database from the DATABASE drop-down list.</li>
|
|
|
|
|
+</ol>
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
<p><a name="Beeswax-CreatingTables"></a></p>
|
|
<p><a name="Beeswax-CreatingTables"></a></p>
|
|
|
|
|
|
|
|
<h3><a name="Beeswax-CreatingTables"></a>Creating Tables</h3>
|
|
<h3><a name="Beeswax-CreatingTables"></a>Creating Tables</h3>
|
|
|
|
|
|
|
|
<p>Although you can create tables by executing the appropriate HQL DDL query commands, it is easier to create a table using the Beeswax table creation wizard.</p>
|
|
<p>Although you can create tables by executing the appropriate HQL DDL query commands, it is easier to create a table using the Beeswax table creation wizard.</p>
|
|
|
|
|
|
|
|
-<p>There are two ways to create a table: from a file, or manually.</p>
|
|
|
|
|
|
|
+<p>There are two ways to create a table: from a file or manually.</p>
|
|
|
|
|
|
|
|
<p>If you create a table from a file, the format of the data in the file will determine some of the properties of the table, such as the record and file formats. The data from the file you specify is imported automatically upon table creation.</p>
|
|
<p>If you create a table from a file, the format of the data in the file will determine some of the properties of the table, such as the record and file formats. The data from the file you specify is imported automatically upon table creation.</p>
|
|
|
|
|
|
|
|
-<p>When you create a file manually, you specify all the properties of the table, and then execute the resulting query to actually create the table. You then import data into the table as an additional step.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></p>
|
|
|
|
|
|
|
+<p>When you create a file manually, you specify all the properties of the table, and then execute the resulting query to actually create the table. You then import data into the table as an additional step.</p>
|
|
|
|
|
+
|
|
|
|
|
|
|
|
-<p>*To create a table from a <a href="file:*">file:*</a></p>
|
|
|
|
|
|
|
+<p><b>To create a table from a file</b>:</p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax</b> window, click <b>Tables</b>.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>In the Beeswax <b>Action</b> pane, click <b>Create a new table from file</b>.<br/>
|
|
|
|
|
|
|
+ <li>In the Beeswax window, click <b>Tables</b>.</li>
|
|
|
|
|
+ <li>In the ACTIONS pane, click <b>Create a new table from a file</b>.<br/>
|
|
|
The table creation wizard starts.
|
|
The table creation wizard starts.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
- <li>Follow the instructions in the wizard to create the table.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-The basic steps are:
|
|
|
|
|
|
|
+ <li>Follow the instructions in the wizard to create the table. The basic steps are:
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>Choose your input file. The input file you specify must exist.<br/>
|
|
<li>Choose your input file. The input file you specify must exist.<br/>
|
|
|
Note that you can choose to have Beeswax create the table definition only based on the import file you select, without actually importing data from that file.</li>
|
|
Note that you can choose to have Beeswax create the table definition only based on the import file you select, without actually importing data from that file.</li>
|
|
@@ -403,32 +371,26 @@ Note that you can choose to have Beeswax create the table definition only based
|
|
|
</ul>
|
|
</ul>
|
|
|
</li>
|
|
</li>
|
|
|
<li>Click <b>Create Table</b> to create the table.<br/>
|
|
<li>Click <b>Create Table</b> to create the table.<br/>
|
|
|
-Beeswax displays the new table's metadata on the right side of the Beeswax <b>Table Metadata</b> window.
|
|
|
|
|
|
|
+The new table's metadata displays on the right side of the <b>Table Metadata</b> window.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-At this point, you can view the metadata or a Sample of the data in the table.<br/>
|
|
|
|
|
-From the Actions pane you can import new data into the table, browse the table, drop it, or go to the FileBrowser to see the location of the data.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
|
|
+At this point, you can view the metadata or a sample of the data in the table.<br/>
|
|
|
|
|
+From the ACTIONS pane you can import new data into the table, browse the table, drop it, or go to the File Browser to see the location of the data.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
+
|
|
|
<p><b>To create a table manually:</b></p>
|
|
<p><b>To create a table manually:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax</b> window, click <b>Tables</b>.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>In the Beeswax <b>Action</b> pane, click <b>Create a new table manually</b>.
|
|
|
|
|
|
|
+ <li>In the Beeswax window, click <b>Tables</b>.</li>
|
|
|
|
|
+ <li>In the ACTIONS pane, click <b>Create a new table manually</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
The table creation wizard starts.
|
|
The table creation wizard starts.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
- <li>Follow the instructions in the wizard to create the table.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-The basic steps are:
|
|
|
|
|
|
|
+ <li>Follow the instructions in the wizard to create the table. The basic steps are:
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>Name your table.</li>
|
|
<li>Name your table.</li>
|
|
|
<li>Choose the record format.</li>
|
|
<li>Choose the record format.</li>
|
|
@@ -436,19 +398,11 @@ The basic steps are:
|
|
|
<li>Choose the file format.</li>
|
|
<li>Choose the file format.</li>
|
|
|
<li>Specify the location for your table's data.</li>
|
|
<li>Specify the location for your table's data.</li>
|
|
|
<li>Define your columns, providing a name and selecting the type.</li>
|
|
<li>Define your columns, providing a name and selecting the type.</li>
|
|
|
- <li>Add partitions, if appropriate.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
|
|
+ <li>Add partitions, if appropriate.</li>
|
|
|
</ul>
|
|
</ul>
|
|
|
</li>
|
|
</li>
|
|
|
- <li>Click <b>Create Table</b> to construct a query to create the table.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-The new query is displayed in the Hive Query window.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
- <li>Click <b>Execute</b> to run the query and create the table.
|
|
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
|
|
|
|
+ <li>Click <b>Create table</b>.<br/>
|
|
|
|
|
+The Table Metadata window displays.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
@@ -459,23 +413,20 @@ The new query is displayed in the Hive Query window.
|
|
|
<p><b>To browse the data in a table:</b></p>
|
|
<p><b>To browse the data in a table:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the Beeswax <b>Table List</b> window, click the <b>Browse Data</b> button next to the table you want to browse.
|
|
|
|
|
|
|
+ <li>In the Table List window, click the <b>Browse Data</b> button next to the table you want to browse.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the table's data in the <b>Query Results</b> window.</li>
|
|
|
|
|
|
|
+The table's data displays in the Query Results window.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
|
<p><b>To browse the metadata in a table:</b></p>
|
|
<p><b>To browse the metadata in a table:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the Beeswax <b>Table List</b> window, click the table name.
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-<br class="atl-forced-newline" />
|
|
|
|
|
-Beeswax displays the table's metadata under a <b>Columns</b> tab.
|
|
|
|
|
|
|
+ <li>In the Table List window, click the table name.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-You can view the actual data in the table by selecting the <b>Sample</b> tab.</li>
|
|
|
|
|
|
|
+The table's metadata displays opened to the <b>Columns</b> tab. You can view the data in the table by selecting the <b>Sample</b> tab.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
@@ -488,13 +439,13 @@ You can view the actual data in the table by selecting the <b>Sample</b> tab.</l
|
|
|
<p><b>To import data into a table:</b></p>
|
|
<p><b>To import data into a table:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the Beeswax <b>Table List</b> window, double-click the table name.
|
|
|
|
|
|
|
+ <li>In the Table List window, click the table name.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the <b>Beeswax Table Metadata</b> window.
|
|
|
|
|
|
|
+The Table Metadata window displays.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
- <li>From the Actions panel, click <b>Import Data</b>.
|
|
|
|
|
|
|
+ <li>In the ACTIONS pane, click <b>Import Data</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>For <b>Path</b>, enter the path to the file that contains the data you want to import.
|
|
<li>For <b>Path</b>, enter the path to the file that contains the data you want to import.
|
|
@@ -503,7 +454,7 @@ Beeswax displays the <b>Beeswax Table Metadata</b> window.
|
|
|
<li>Check <b>Overwrite existing data</b> to replace the data in the selected table with the imported data. Leave this unchecked to append to the table.
|
|
<li>Check <b>Overwrite existing data</b> to replace the data in the selected table with the imported data. Leave this unchecked to append to the table.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
- <li>Click <b>Submit</b> to start importing the data.</li>
|
|
|
|
|
|
|
+ <li>Click <b>Submit</b>.</li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
@@ -514,13 +465,13 @@ Beeswax displays the <b>Beeswax Table Metadata</b> window.
|
|
|
<p><b>To drop a table:</b></p>
|
|
<p><b>To drop a table:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the Beeswax <b>Table List</b> window, double-click the table name.
|
|
|
|
|
|
|
+ <li>In the Table List window, click the table name.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the Beeswax <b>Table Metadata</b> window.
|
|
|
|
|
|
|
+The Table Metadata window displays.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
- <li>From the Actions panel, click <b>Drop Table</b>.
|
|
|
|
|
|
|
+ <li>In the ACTIONS pane, click <b>Drop Table</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>Click <b>Yes</b> to confirm the deletion.</li>
|
|
<li>Click <b>Yes</b> to confirm the deletion.</li>
|
|
@@ -534,16 +485,16 @@ Beeswax displays the Beeswax <b>Table Metadata</b> window.
|
|
|
<p><b>To view a table's location:</b></p>
|
|
<p><b>To view a table's location:</b></p>
|
|
|
|
|
|
|
|
<ol>
|
|
<ol>
|
|
|
- <li>In the Beeswax <b>Table List</b> window, double-click the table name.
|
|
|
|
|
|
|
+ <li>In the Table List window, click the table name.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the Beeswax <b>Table Metadata</b> window.
|
|
|
|
|
|
|
+The Table Metadata window displays.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" /></li>
|
|
<br class="atl-forced-newline" /></li>
|
|
|
<li>Click <b>View File Location</b>.
|
|
<li>Click <b>View File Location</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
<br class="atl-forced-newline" />
|
|
|
-Beeswax lists the selected table in its directory in the <b>File Browser</b> window. </li>
|
|
|
|
|
|
|
+The file location of the selected table displays in its directory in the File Browser window. </li>
|
|
|
</ol>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|