|
|
@@ -1,292 +1,293 @@
|
|
|
<h1><a name="Beeswax-IntroducingBeeswax"></a>Introducing Beeswax</h1>
|
|
|
|
|
|
-<p>Beeswax enables you to perform queries on Apache Hive, a data warehousing system designed to work with Hadoop. </p>
|
|
|
+<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>
|
|
|
|
|
|
-<h2><a name="Beeswax-BeeswaxandHiveInstallationandConfiguration"></a>Beeswax and Hive Installation and Configuration</h2>
|
|
|
|
|
|
-<p>Beeswax is installed as part of Hue. For more information about installing Hue, see <a href="https://ccp.cloudera.com/display/CDHDOC/Hue+Installation">https://ccp.cloudera.com/display/CDHDOC/Hue+Installation</a>. </p>
|
|
|
+<h2><a name="Beeswax-Contents"></a>Contents</h2>
|
|
|
|
|
|
-<h2><a name="Beeswax-HiveConfiguration"></a>Hive Configuration</h2>
|
|
|
+<style type='text/css'>/*<![CDATA[*/
|
|
|
+div.rbtoc1334186923081 {margin-left: 1.5em;padding: 0px;}
|
|
|
+div.rbtoc1334186923081 ul {margin-left: 0px;padding-left: 20px;}
|
|
|
+div.rbtoc1334186923081 li {margin-left: 0px;padding-left: 0px;}
|
|
|
|
|
|
-<p>Beeswax, the Hive user interface in Hue, includes Hive 0.5. You do not need an existing Hive installation.</p>
|
|
|
+/*]]>*/</style><div class='rbtoc1334186923081'>
|
|
|
+<ul>
|
|
|
+ <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-StartingBeeswax'>Starting Beeswax</a></li>
|
|
|
+<ul>
|
|
|
+<ul>
|
|
|
+ <li><a href='#Beeswax-InstallingtheBeeswaxSamples'>Installing the Beeswax Samples</a></li>
|
|
|
+ <li><a href='#Beeswax-ImportingyourownData'>Importing your own Data</a></li>
|
|
|
+</ul>
|
|
|
+</ul>
|
|
|
+ <li><a href='#Beeswax-WorkingwithQueries'>Working with Queries</a></li>
|
|
|
+<ul>
|
|
|
+<ul>
|
|
|
+ <li><a href='#Beeswax-CreatingandRunningQueries'>Creating and Running Queries</a></li>
|
|
|
+ <li><a href='#Beeswax-TheAdvancedSettingsmenu'>The Advanced Settings menu</a></li>
|
|
|
+ <li><a href='#Beeswax-ViewingQueryHistory'>Viewing Query History</a></li>
|
|
|
+ <li><a href='#Beeswax-Viewing%2CEditing%2CorDeletingSavedQueries'>Viewing, Editing, or Deleting Saved Queries</a></li>
|
|
|
+</ul>
|
|
|
+</ul>
|
|
|
+ <li><a href='#Beeswax-WorkingwithTables'>Working with Tables</a></li>
|
|
|
+<ul>
|
|
|
+<ul>
|
|
|
+ <li><a href='#Beeswax-CreatingTables'>Creating 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-DroppingTables'>Dropping Tables</a></li>
|
|
|
+ <li><a href='#Beeswax-ViewingaTable%27sLocation'>Viewing a Table's Location</a></li>
|
|
|
+</ul>
|
|
|
+</ul>
|
|
|
+</ul></div>
|
|
|
+<p><br class="atl-forced-newline" /></p>
|
|
|
|
|
|
-<p>Your Hive data is stored in the Hadoop Distributed File System (HDFS), typically in the <tt>/user/hive/warehouse</tt> directory (or the directory you specify as <tt>hive.metastore.warehouse.dir</tt> in the <tt>hive-site.xml</tt> file). Make sure this directory exists and is writable by the users whom you expect to be creating tables. The directory <tt>/tmp</tt> (on the local file system) must also be world-writable because Hive uses it extensively.</p>
|
|
|
+<h1><a name="Beeswax-BeeswaxandHiveInstallationandConfiguration"></a>Beeswax and Hive Installation and Configuration</h1>
|
|
|
|
|
|
-<h2><a name="Beeswax-BeeswaxConfiguration"></a>Beeswax Configuration </h2>
|
|
|
+<p>Beeswax is installed and configured as part of Hue. For more information about installing Hue, see <a href="https://ccp.cloudera.com/display/CDH4B2/Hue+Installation">Hue Installation</a>.</p>
|
|
|
|
|
|
-<p><b>If there is an existing Hive installation:</b></p>
|
|
|
+<p>Beeswax assumes an existing Hive installation. The Hue installation instructions include the configuration necessary for Beeswax to access Hive. </p>
|
|
|
|
|
|
-<p>In <tt>/etc/hue/conf/hue-beeswax.ini</tt>, modify <tt>hive_conf_dir</tt> to refer to the directory containing <tt>hive-site.xml</tt>.</p>
|
|
|
+<p>You can view the current Hive configuration from from the <b>Settings</b> tab in the Beeswax application. </p>
|
|
|
|
|
|
-<p><b>If there is no existing Hive installation:</b></p>
|
|
|
|
|
|
-<p>For information about the configuration options in <tt>hive-site.xml</tt>, see <a href="http://wiki.apache.org/hadoop/Hive/AdminManual/Configuration">http://wiki.apache.org/hadoop/Hive/AdminManual/Configuration</a>. The <tt>hive-site.xml</tt> file is optional but it is often useful, particularly if you want to set up a metastore. You may store the <tt>hive-site.xml</tt> file in <tt>/etc/hue/conf</tt>, or instruct Beeswax to locate it using the <tt>hive_conf_dir</tt> configuration variable (see <tt>/etc/hue/conf/hue-beeswax.ini</tt>).</p>
|
|
|
|
|
|
-<h1><a name="Beeswax-UsingBeeswax"></a>Using Beeswax</h1>
|
|
|
|
|
|
-<h2><a name="Beeswax-StartingBeeswax"></a>Starting Beeswax </h2>
|
|
|
+<h1><a name="Beeswax-StartingBeeswax"></a>Starting Beeswax</h1>
|
|
|
|
|
|
-<p>To start the Beeswax application, click this icon <span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259203.jpg" height="29" width="30" style="border: 0px solid black"/></span> in the application bar at the bottom of the Hue web browser page. The <b>Beeswax: Hive Query</b> window opens in the Hue web page. </p> <h2><a name="Beeswax-InstallingtheBeeswaxSamples"></a>Installing the Beeswax Samples</h2>
|
|
|
+<p>To start the Beeswax application, click the <b>Beeswax</b> tab in the navigation bar at the top of the Hue browser page. </p>
|
|
|
|
|
|
-<p>You can install two sample Beeswax tables to use as examples. </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>
|
|
|
|
|
|
-<p><b>To install Beeswax samples:</b> </p>
|
|
|
+<p>Once some tables have been created, clicking the Beeswax tab will bring you directly into the Query Editor. </p>
|
|
|
+
|
|
|
+<p>The tabs at the top of the page 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>
|
|
|
|
|
|
<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 <b>Table List</b> window, click <b>install samples</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259202.jpg" height="416" width="710" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-After you click <b>install samples</b>, the samples are displayed in the <b>Hive Table List</b> window. Beeswax removes the <b>install samples</b> button after the samples are installed. </li>
|
|
|
+ <li>In the <b>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" /> <br class="atl-forced-newline" />
|
|
|
+Once you have installed the sample data, this option will no longer appear.</li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+
|
|
|
+<h3><a name="Beeswax-ImportingyourownData"></a>Importing your own Data</h3>
|
|
|
+
|
|
|
+<p>You can import data or your own:</p>
|
|
|
+<ol>
|
|
|
+ <li>In the "Beeswax" 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" /> <br class="atl-forced-newline" /></li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
-<h2><a name="Beeswax-WorkingwithQueries"></a>Working with Queries</h2>
|
|
|
+<h1><a name="Beeswax-WorkingwithQueries"></a>Working with Queries</h1>
|
|
|
|
|
|
-<p>The <b>Hive Query</b> view enables you to enter 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 receive an email message after the query is completed. </p>
|
|
|
+<p>The <b>Query Editor</b> view enables you to enter 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 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>
|
|
|
+<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>
|
|
|
|
|
|
<h3><a name="Beeswax-CreatingandRunningQueries"></a>Creating and Running Queries</h3>
|
|
|
|
|
|
-<p><b>To create and run a query</b>: </p>
|
|
|
+<p><b>To create and run a query</b>:</p>
|
|
|
|
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax: 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:
|
|
|
+ <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</tt>
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <li>The Advanced Settings section lets you 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 Settings</a> below for details on using these settings.
|
|
|
+<br class="atl-forced-newline" /> <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>
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <li>If you want to view the execution plan for the query, click <b>Explain</b>. For more information, see <a href="http://wiki.apache.org/hadoop/Hive/LanguageManual/Explain">http://wiki.apache.org/hadoop/Hive/LanguageManual/Explain</a>.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <li>To run the query, click <b>Execute</b>.
|
|
|
<br class="atl-forced-newline" />
|
|
|
+<a name="Beeswax-QueryResults"></a><br/>
|
|
|
+The Beeswax <b>Query Results</b> window appears with the results of your query.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <li>Do any of the following to download or save the query results:
|
|
|
<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259206.jpg" height="411" width="713" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>To override the default Hive and Hadoop settings for the current query, click <b>Advanced</b>. (To view the Hive default settings, click <b>Settings</b>.)
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-A panel opens on the left side of the window where you can specify the advanced settings.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259207.jpg" height="411" width="713" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Click the plus sign icon <span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259208.jpg" height="18" width="18" style="border: 0px solid black"/></span> to add a setting for the following options. Click the plus sign icon again to specify multiple settings for a group, such as <b>Hive Settings</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
+ <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>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>
|
|
|
+</ol>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+<p><a name="Beeswax-AdvancedSettings"></a></p>
|
|
|
+<h3><a name="Beeswax-TheAdvancedSettingsmenu"></a>The Advanced Settings menu</h3>
|
|
|
+
|
|
|
+<p>The Advanced settings section lets you specify the following options:
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></p>
|
|
|
<div class='table-wrap'>
|
|
|
<table class='confluenceTable'><tbody>
|
|
|
<tr>
|
|
|
-<th class='confluenceTh'> <b>Option</b> </th>
|
|
|
-<th class='confluenceTh'> <b>Description</b> </th>
|
|
|
+<th class='confluenceTh'> Option </th>
|
|
|
+<th class='confluenceTh'> Description </th>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<td class='confluenceTd'> <b>Hive Settings</b> </td>
|
|
|
-<td class='confluenceTd'> Use <b>Hive Settings</b> to override Hive and Hadoop default settings. For <b>Key</b>, enter a Hive or Hadoop configuration variable name. For <b>Value</b>, enter the value you want to use for the variable. 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> 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>
|
|
|
+<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/>
|
|
|
+» For <b>Key</b>, enter a Hive or Hadoop configuration variable name. <br/>
|
|
|
+» 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" />
|
|
|
+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>
|
|
|
</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" />
|
|
|
+<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" />
|
|
|
+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" />
|
|
|
<br class="atl-forced-newline" />
|
|
|
-From the <b>Type</b> drop-down menu, choose one of the following:
|
|
|
+<b>jar</b> — Adds the resources to the Java classpath. This is required in order to reference objects such as user defined functions. <br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
|
+<b>archive</b> — Automatically unarchives resources when distributing them. <br class="atl-forced-newline" />
|
|
|
<br class="atl-forced-newline" />
|
|
|
-<b>JAR</b> — Adds the resources to the Java classpath. This is required in order to reference objects such as user defined functions.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<b>ARCHIVE</b> — Automatically unarchives resources when distributing them.
|
|
|
-<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" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-For <b>Path</b>, enter the path to the file. You can also click <b>Choose File</b> to browse and select the file.
|
|
|
+<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" />
|
|
|
+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>
|
|
|
</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>. 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>
|
|
|
+<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/>
|
|
|
+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>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<td class='confluenceTd'> <b>Parameterization</b> </td>
|
|
|
-<td class='confluenceTd'> If you want to display a dialog box for you or other users to enter parameter values when a query is executed, select <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>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<td class='confluenceTd'> <b>Email Notification</b> </td>
|
|
|
-<td class='confluenceTd'> If you want to receive an email message after a query completes, select <b>Email Notification</b>. </td>
|
|
|
+<td class='confluenceTd'> To receive an email message after a query completes, check <b>Email Notification</b>. </td>
|
|
|
</tr>
|
|
|
</tbody></table>
|
|
|
</div>
|
|
|
|
|
|
-<p><br class="atl-forced-newline" /></p></li>
|
|
|
- <li>Click the red Close icon <span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259205.jpg" height="16" width="16" style="border: 0px solid black"/></span> to close a group, and click all of the Close icons to close the <b>Advanced</b> panel.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>If you want to save your query and advanced settings to use them 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>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>If you want to view the execution plan for the query, click <b>Explain</b>. For more information, see <a href="http://wiki.apache.org/hadoop/Hive/LanguageManual/Explain">http://wiki.apache.org/hadoop/Hive/LanguageManual/Explain</a>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>To run the query, click <b>Execute</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-The <b>Beeswax: Hive Query</b> window appears with the results of your query.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259204.jpg" height="411" width="712" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Do any of the following to download or save the query results:
|
|
|
-<br class="atl-forced-newline" />
|
|
|
- <ul>
|
|
|
- <li>Click <b>Download XLS</b> to download the results in a Microsoft Office Excel worksheet file.</li>
|
|
|
- <li>Click <b>Download CSV</b> to download the results in a comma-separated values file suitable for use in other applications.</li>
|
|
|
- <li>Click <b>Save.</b> To save the results in a new table, select <b>In a new table</b>, enter a name, and then click <b>Save</b>. To save the results in an HDFS file, select <b>In an HDFS directory</b>, enter a path or <b>Choose File</b> and browse to the directory, and then click <b>Save</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- </ul>
|
|
|
- </li>
|
|
|
- <li>To view a log of the query execution, click <b>Log</b>. You can use the information in this tab to debug your query.
|
|
|
-<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 return to the query in the <b>Query Editor,</b> click <b>Unsaved Query</b> or the name of your saved query in the blue box at the top of the panel on the left side of the Beeswax window.</li>
|
|
|
-</ol>
|
|
|
-
|
|
|
+<p><br class="atl-forced-newline" /></p>
|
|
|
|
|
|
<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. </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.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></p>
|
|
|
|
|
|
<p><b>To view query history:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
<li>In the <b>Beeswax</b> window, click <b>History</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays a list of your unsaved and saved queries in the <b>Beeswax:Query History</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259210.jpg" height="385" width="711" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>To display the queries for all users, click <b>everyone's</b>. To display your queries only, click <b>mine</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>To display the automatically generated actions that Beeswax performed on a user's behalf, click <b>auto actions</b>. To display user queries again, click <b>user queries</b>.</li>
|
|
|
+<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.
|
|
|
+<br class="atl-forced-newline" /> <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>.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <li>To display the automatically generated actions that Beeswax performed on a user's behalf, click <b>Show auto actions</b>. To display user queries again, click <b>Show user queries</b>.</li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
-
|
|
|
<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" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259211.jpg" height="385" width="711" style="border: 0px solid black"/></span>
|
|
|
+<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" /></p>
|
|
|
|
|
|
<p><b>To edit a saved query:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
<li>In the <b>Beeswax</b> window, click <b>Saved Queries</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the <b>Beeswax:Queries</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Right-click one of your queries and choose <b>Edit</b> from the context menu.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259212.jpg" height="385" width="711" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the query in the <b>Beeswax:Query Editor</b> window.
|
|
|
-<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>Edit</b> from the context menu.
|
|
|
+<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.
|
|
|
<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>
|
|
|
|
|
|
|
|
|
-
|
|
|
<p><b>To delete a saved query:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
<li>In the <b>Beeswax</b> window, click <b>Saved Queries</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the <b>Beeswax:Queries</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Right-click any of the queries and choose <b>Delete</b> from the context menu.
|
|
|
-<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.
|
|
|
<br class="atl-forced-newline" /></li>
|
|
|
- <li>Click <b>OK</b> to confirm the deletion.</li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
-
|
|
|
<p><b>To copy a saved query:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
<li>In the <b>Beeswax</b> window, click <b>Saved Queries</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the <b>Beeswax:Queries</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Right-click on any of the queries and choose <b>Clone</b> from the context menu.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the query in the <b>Beeswax:Query Editor</b> window.
|
|
|
-<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>Clone</b> from the context menu.
|
|
|
+<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.
|
|
|
<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>
|
|
|
|
|
|
|
|
|
-
|
|
|
-<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>
|
|
|
<li>In the <b>Beeswax</b> window, click <b>History</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the <b>Beeswax: Query History</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
+Beeswax displays the Beeswax <b>Query History</b> window.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
<li>To display the queries for all users, click <b>everyone's</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the queries for all users in the <b>Beeswax:Query History</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259209.jpg" height="385" width="711" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
+<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.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
<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" />
|
|
|
-Beeswax displays a copy of the query in the <b>Beeswax: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.</li>
|
|
|
+<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.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
-<h2><a name="Beeswax-WorkingwithTables"></a>Working with Tables</h2>
|
|
|
+<h1><a name="Beeswax-WorkingwithTables"></a>Working with Tables</h1>
|
|
|
|
|
|
<p>When working with Hive tables, you can use Beeswax to:</p>
|
|
|
<ul>
|
|
|
@@ -294,155 +295,160 @@ Beeswax displays a copy of the query in the <b>Beeswax:Query Editor</b> window.
|
|
|
<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>)</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>
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
-<h3><a name="Beeswax-CreatingTables"></a><a name="Beeswax-CreatingTables"></a>Creating Tables</h3>
|
|
|
+<p><a name="Beeswax-CreatingTables"></a></p>
|
|
|
+<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>There are two ways to create a table: from a file, or manually.</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>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><b>To create a table:</b></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><b>To create a table from a file:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
<li>In the <b>Beeswax</b> window, click <b>Tables</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259215.jpg" height="411" width="713" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>In the <b>Beeswax: Table List</b> window, click <b>new table</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-The table creation wizard starts.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259216.jpg" height="411" width="713" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Follow the instructions in the wizard to create the table. For information about an option in the wizard, place your mouse cursor on the help icon <span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259217.jpg" height="16" width="16" style="border: 0px solid black"/></span> next to the option.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-After you click <b>Submit Query</b> at the end of the table creation wizard, a new query to create the table is displayed in the Query Editor window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259214.jpg" height="416" width="710" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
+<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/>
|
|
|
+The table creation wizard starts.
|
|
|
+<br class="atl-forced-newline" /> <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:
|
|
|
+ <ul>
|
|
|
+ <li>Choose your input file. The input file you specify must exist.</li>
|
|
|
+ <li>Specify the column delimiter.</li>
|
|
|
+ <li>Define your columns, providing a name and selecting the type.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ </ul>
|
|
|
+ </li>
|
|
|
+ <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.
|
|
|
+<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. </li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+
|
|
|
+<p><b>To create a table manually:</b></p>
|
|
|
+
|
|
|
+<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>.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
+The table creation wizard starts.
|
|
|
+<br class="atl-forced-newline" /> <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:
|
|
|
+ <ul>
|
|
|
+ <li>Name your table.</li>
|
|
|
+ <li>Choose the record format.</li>
|
|
|
+ <li>Configure record serialization by specifying delimiters for columns, collections, and map keys.</li>
|
|
|
+ <li>Choose the file format.</li>
|
|
|
+ <li>Specify the location for your table's data.</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>
|
|
|
+ </ul>
|
|
|
+ </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" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the new table's metadata on the right side of the <b>Beeswax:Table Metadata</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259213.jpg" height="416" width="709" style="border: 0px solid black"/></span></li>
|
|
|
+<br class="atl-forced-newline" /></li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
-<h3><a name="Beeswax-BrowsingTables"></a><a name="Beeswax-BrowsingTables"></a>Browsing Tables</h3>
|
|
|
+<p><a name="Beeswax-BrowsingTables"></a></p>
|
|
|
+<h3><a name="Beeswax-BrowsingTables"></a>Browsing Tables</h3>
|
|
|
|
|
|
<p><b>To browse the data in a table:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax:Table List</b> window, click <b>Tables</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Click the <b>Browse Data</b> link next to the table you want to browse.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259218.jpg" height="416" width="710" style="border: 0px solid black"/></span>
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the table's data in the <b>Query Results</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<span class="image-wrap" style=""><img src="/beeswax/static/help/images/6259219.jpg" width="710" style="border: 0px solid black"/></span></li>
|
|
|
+ <li>In the Beeswax <b>Table List</b> 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" />
|
|
|
+Beeswax displays the table's data in the <b>Query Results</b> window.</li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
<p><b>To browse the metadata in a table:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax:Table List</b> window, click <b>Tables</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Double-click the table.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the table's metadata on the right side of the <b>Beeswax:Table Metadata</b> window. </li>
|
|
|
+ <li>In the Beeswax <b>Table List</b> window, double-click the table name.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
+Beeswax displays the table's metadata on the right side of the Beeswax <b>Table Metadata</b> window.</li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
-<h3><a name="Beeswax-ImportingDataintoTables"></a><a name="Beeswax-ImportingDataintoTables"></a>Importing Data into Tables</h3>
|
|
|
+<p><a name="Beeswax-ImportingDataintoTables"></a></p>
|
|
|
+<h3><a name="Beeswax-ImportingDataintoTables"></a>Importing Data into Tables</h3>
|
|
|
|
|
|
-<p>When importing data, you can choose to append or overwrite the table's data with data from a file. </p>
|
|
|
+<p>When importing data, you can choose to append or overwrite the table's data with data from a file.</p>
|
|
|
|
|
|
<p><b>To import data into a table:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax:Table List</b> window, click <b>Tables</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Double-click the table.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the <b>Beeswax:Table Metadata</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /> </li>
|
|
|
- <li>Click <b>Import Data</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Select <b>Overwrite existing data</b> to replace the data in the selected table with the imported data.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<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, or click <b>Choose File</b> to browse to the file.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
+ <li>In the Beeswax <b>Table List</b> window, double-click the table name.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
+Beeswax displays the <b>Beeswax Table Metadata</b> window.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <li>From the Actions panel, click <b>Import Data</b>.
|
|
|
+<br class="atl-forced-newline" /> <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.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <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" /></li>
|
|
|
<li>Click <b>Submit</b> to start importing the data.</li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
-<h3><a name="Beeswax-DroppingTables"></a><a name="Beeswax-DroppingTables"></a>Dropping Tables</h3>
|
|
|
+<p><a name="Beeswax-DroppingTables"></a></p>
|
|
|
+<h3><a name="Beeswax-DroppingTables"></a>Dropping Tables</h3>
|
|
|
|
|
|
<p><b>To drop a table:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax:Table List</b> window, click <b>Tables</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Double-click the table.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the <b>Beeswax:Table Metadata</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Click <b>Drop Table</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Click <b>Ok</b> to confirm the deletion.</li>
|
|
|
+ <li>In the Beeswax <b>Table List</b> window, double-click the table name.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
+Beeswax displays the Beeswax <b>Table Metadata</b> window.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <li>From the Actions panel, click <b>Drop Table</b>.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
+ <li>Click <b>Yes</b> to confirm the deletion.</li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
-<h3><a name="Beeswax-ViewingaTable%27sLocation"></a><a name="Beeswax-ViewingaTable%27sLocation"></a>Viewing a Table's Location</h3>
|
|
|
+<p><a name="Beeswax-ViewingaTable%27sLocation"></a></p>
|
|
|
+<h3><a name="Beeswax-ViewingaTable%27sLocation"></a>Viewing a Table's Location</h3>
|
|
|
|
|
|
<p><b>To view a table's location:</b></p>
|
|
|
|
|
|
<ol>
|
|
|
- <li>In the <b>Beeswax:Table List</b> window, click <b>Tables</b>.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
- <li>Double-click the table.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-Beeswax displays the <b>Beeswax:Table Metadata</b> window.
|
|
|
-<br class="atl-forced-newline" />
|
|
|
-<br class="atl-forced-newline" /></li>
|
|
|
+ <li>In the Beeswax <b>Table List</b> window, double-click the table name.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" />
|
|
|
+Beeswax displays the Beeswax <b>Table Metadata</b> window.
|
|
|
+<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
|
|
|
<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>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
- <br/>
|
|
|
-
|
|
|
+
|
|
|
+ </td>
|
|
|
+ </tr>
|
|
|
+ </table>
|
|
|
+
|
|
|
+ </body>
|
|
|
+</html>
|
|
|
+
|