| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167 |
- <?xml version="1.0" encoding="UTF-8"?>
- <!DOCTYPE html
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html lang="en-us" xml:lang="en-us">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <link rel="stylesheet" type="text/css" href="commonltr.css"/>
- <title>Pig Editor</title>
- </head>
- <body id="xd_583c10bfdbd326ba-3ca24a24-13d80143249--7f9c"><a name="xd_583c10bfdbd326ba-3ca24a24-13d80143249--7f9c"><!-- --></a>
- <h1>Sqoop UI</h1>
- <p>The Sqoop UI enables transfering data from a relational database
- to Hadoop and vice versa. The UI lives uses Apache Sqoop to do this.
- See the <a href="http://sqoop.apache.org/docs/1.99.2/index.html">Sqoop Documentation</a> for more details on Sqoop.</p>
- <p>
- <p>Hue, the <a href="http://gethue.com">open source Big Data UI</a>, has an application that enables transferring data between relational databases and <a href="http://hadoop.apache.org/">Hadoop</a>. This new application is driven by <a href="http://sqoop.apache.org/">Sqoop 2</a> and has several user experience improvements to boot.</p>
- <p><iframe frameborder="0" height="495" src="http://player.vimeo.com/video/76063637" width="900"></iframe></p>
- <p>Sqoop is a batch data migration tool for transferring data between traditional databases and Hadoop. The first version of Sqoop is a heavy client that drives and oversees data transfer via MapReduce. In Sqoop 2, the majority of the work was moved to a server that a thin client communicates with. Also, any client can communicate with the Sqoop 2 server over its JSON-REST protocol. Sqoop 2 was chosen instead of its predecessors because of its client-server design.</p>
- <h2>Importing from MySQL to HDFS</h2>
- <p>The following is the canonical import job example sourced from <a href="http://sqoop.apache.org/docs/1.99.2/Sqoop5MinutesDemo.html"><a href="http://sqoop.apache.org/docs/1.99.2/Sqoop5MinutesDemo.html">http://sqoop.apache.org/docs/1.99.2/Sqoop5MinutesDemo.html</a></a>. In Hue, this can be done in 3 easy steps:</p>
- <h3>Environment</h3>
- <ul><li>
- <p>CDH 4.4 or <span>Hue 3.0.0</span></p>
- </li>
- <li>
- <p>MySQL 5.1</p>
- </li>
- </ul><h3>Troubleshooting</h3>
- <p>If the new job button is not appearing, Sqoop2 is probably not starting. Make sure the MySql or other DB connectors are in the /usr/lib/sqoop/lib directory of Sqoop2. Make sure you have these properties in the Sqoop2 Server configuration:</p>
- <pre class="code">org.apache.sqoop.repository.schema.immutable=false
- org.apache.sqoop.connector.autoupgrade=true
- org.apache.sqoop.framework.autoupgrade=true
- </pre>
- <h3>1. Create a Connection</h3>
- <p>In the Sqoop app, the connection manager is available from the “New Job” wizard. To get to the new job wizard, click on “New Job”. There may be a list of connections available if a few have been created before. For the purposes of this demo, we’ll go through the process of creating a new connection. Click “Add a new connection” and fill in the blanks with the data below. Then click save to return to the “New Job” wizard!</p>
- <div>
- <pre class="code">Connection Parameter Value
- Name mysql-connection-demo
- JDBC Driver Class com.mysql.jdbc.Driver
- JDBC Connection String jdbc:mysql://hue-demo/demo
- Username demo
- Password demo
- </pre>
- </div>
- <p><br/>Connection form values.<br/><br/></p>
- <h3>2. Create a Job</h3>
- <p>After creating a connection, follow the wizard and fill in the blanks with the information below.</p>
- <div>
- <pre class="code">Job Wizard Parameter Value
- Name mysql-import-job-demo
- Type IMPORT
- Connection mysql-connection-demo
- Table name test
- Storage Type HDFS
- Output format TEXT_FILE
- Output directory /tmp/mysql-import-job-demo
- </pre>
- </div>
- <p><br/>Job wizard form values.</p>
- <h3>3. Save and Submit the Job</h3>
- <p>At the end of the Job wizard, click “Save and Run”! The job should automagically start after that and the job dashboard will be displayed. As the job is running, a progress bar below the job listing will be dynamically updated. Links to the HDFS output via the File Browser and Map Reduce logs via Job Browser will be available on the left hand side of the job edit page.</p>
- <h1>Sum Up</h1>
- <p>The new Sqoop application enables batch data migration from a more traditional databases to Hadoop and vice versa through Hue. Using Hue, a user can move data between storage systems in a distributed fashion with the click of a button.</p>
- <p>I’d like to send out a big thank you to the Sqoop community for the new client-server design!</p>
- <p>Both projects are undergoing heavy development and are welcoming external contributions! Have any suggestions? Feel free to tell us what you think through <a href="http://groups.google.com/a/cloudera.org/group/hue-user">hue-user</a> or <a href="https://twitter.com/gethue">@gethue</a>!</p>
- </p>
- <h2>Installation and Configuration</h2>
- <p>The Sqoop UI is one of the applications installed as part of
- Hue. For information about installing and configuring Hue, see the Hue Installation
- manual.</p>
- <h2>Starting</h2>
- <p>Click the <strong>Sqoop</strong> icon
- (<img alt="image" src="/sqoop/static/art/icon_sqoop_24.png" />) in the navigation bar at the top of
- the Hue browser page.</p>
- <h2>Sqoop Jobs</h2>
- <p>Sqoop UI is oriented around jobs in Apache Sqoop.</p>
- <h3>Creating a New Job</h3>
- <ol>
- <li>Click the <strong>New job</strong> button at the top right.</li>
- <li>In the Name field, enter a name.</li>
- <li>Choose the type of job: import or export.
- The proceeding form fields will change depending on which type is chosen.</li>
- <li>Select a connection, or create one if it does not exist.</li>
- <li>Fill in the rest of the fields for the job.
- For importing, the "Table name", "Storage type", "Output format", and "Output directory" are necessary at a minimum.
- For exporting, the "Table name" and "Input directory" are necessary at a minimum.</li>
- <li>Click <strong>save</strong> to finish.</li>
- </ol>
- <h3>Editing a Job</h3>
- <ol>
- <li>In the list of jobs, click on the name of the job.</li>
- <li>Edit the desired form fields in the job.</li>
- </ol>
- <h3>Copying a Job</h3>
- <ol>
- <li>In the list of jobs, click on the name of the job.</li>
- <li>On the left hand side of the job editor, there should be a panel containing actions.
- Click <strong>Copy</strong>.</li>
- </ol>
- <h3>Removing a Job</h3>
- <ol>
- <li>In the list of jobs, click on the name of the job.</li>
- <li>On the left hand side of the job editor, there should be a panel containing actions.
- Click <strong>Delete</strong>.</li>
- </ol>
- <h3>Running a Job</h3>
- <p>There's a status on each of the items in the job list indicating
- the last time a job was ran. The progress of the job should dynamically
- update. There's a progress bar at the bottom of each item on the job list
- as well.</p>
- <ol>
- <li>In the list of jobs, click on the name of the job.</li>
- <li>On the left hand side of the job editor, there should be a panel containing actions.
- Click <strong>Run</strong>.</li>
- </ol>
- <h3>Creating a New Connection</h3>
- <ol>
- <li>Click the <strong>New job</strong> button at the top right.</li>
- <li>At the connection field, click the link titled <strong>Add a new connection</strong>.</li>
- <li>Fill in the displayed fields.</li>
- <li>Click <strong>save</strong> to finish.</li>
- </ol>
- <h3>Editing a Connection</h3>
- <ol>
- <li>Click the <strong>New job</strong> button at the top right.</li>
- <li>At the connection field, select the connection by name that should be edited.</li>
- <li>Click <strong>Edit</strong>.</li>
- <li>Edit the any of the fields.</li>
- <li>Click <strong>save</strong> to finish.</li>
- </ol>
- <h3>Removing a Connection</h3>
- <ol>
- <li>Click the <strong>New job</strong> button at the top right.</li>
- <li>At the connection field, select the connection by name that should be deleted.</li>
- <li>Click <strong>Delete</strong>.</li>
- </ol>
- <p>NOTE: If this does not work, it's like because a job is using that connection.
- Make sure not jobs are using the connection that will be deleted.</p>
- <h3>Filtering Sqoop Jobs</h3>
- <p>The text field in the top, left corner of the Sqoop Jobs page enables fast filtering
- of sqoop jobs by name.</p>
- </body>
- </html>
|