Java tutorial
/** * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.cloudera.sqoop.manager; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import java.io.FileInputStream; import java.io.File; import java.sql.Connection; import java.sql.SQLException; import java.sql.PreparedStatement; import java.sql.ResultSet; import java.sql.Statement; import java.util.Date; import java.util.Calendar; import java.util.TimeZone; import java.util.ArrayList; import java.text.ParseException; import java.text.DateFormat; import java.text.SimpleDateFormat; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.apache.hadoop.fs.Path; import org.apache.hadoop.io.IOUtils; import com.cloudera.sqoop.SqoopOptions; import com.cloudera.sqoop.testutil.CommonArgs; import com.cloudera.sqoop.testutil.ImportJobTestCase; import com.cloudera.sqoop.util.FileListing; /** * Test the OracleManager implementation. * * This uses JDBC to import data from an Oracle database into HDFS. * * Since this requires an Oracle installation on your local machine to use, * this class is named in such a way that Hadoop's default QA process does * not run it. You need to run this manually with -Dtestcase=OracleManagerTest. * * You need to put Oracle's JDBC driver library (ojdbc6_g.jar) in a location * where Hadoop will be able to access it (since this library cannot be checked * into Apache's tree for licensing reasons). * * To set up your test environment: * <ol> * <li>Install Oracle 10.2.0 or later</li> * <li>Create a database user named SQOOPTEST with password '12345' having * CONNECT and RESOURCE privileges.</li> * <li>Create a database user named SQOOPTEST2 with password 'abcdef' having * CONNECT and RESOURCE privileges</li> * </ol> * * One way to do this is to connect to the database instance via SQL*Plus client * as the SYSTEM user and execute the following commands: * <ul> * <li>CREATE USER SQOOPTEST identified by 12345;</li> * <li>GRANT CONNECT, RESOURCE to SQOOPTEST;</li> * <li>CREATE USER SQOOPTEST2 identified by ABCDEF;</li> * <li>GRANT CONNECT, RESOURCE to SQOOPTEST2;</li> * </ul> * * Oracle XE does a poor job of cleaning up connections in a timely fashion. * Too many connections too quickly will be rejected, because XE will gc the * closed connections in a lazy fashion. Oracle tests have a delay built in * to work with this gc, but it is possible that you will see this error: * * ORA-12516, TNS:listener could not find available handler with matching * protocol stack * * If so, log in to your database as SYSTEM and execute the following: * ALTER SYSTEM SET processes=200 scope=spfile; * ... then restart your database. */ public class OracleManagerTest extends ImportJobTestCase { public static final Log LOG = LogFactory.getLog(OracleManagerTest.class.getName()); static final String TABLE_NAME = "EMPLOYEES"; static final String SECONDARY_TABLE_NAME = "CUSTOMER"; static final String QUALIFIED_SECONDARY_TABLE_NAME = OracleUtils.ORACLE_SECONDARY_USER_NAME + "." + SECONDARY_TABLE_NAME; /* * Array containing SQL statements necessary to create and populate * the main test table. */ private static final String[] MAIN_TABLE_SQL_STMTS = new String[] { "CREATE TABLE " + TABLE_NAME + " (" + "id INT NOT NULL, " + "name VARCHAR2(24) NOT NULL, " + "start_date DATE, " + "salary FLOAT, " + "dept VARCHAR2(32), " + "timestamp_tz TIMESTAMP WITH TIME ZONE, " + "timestamp_ltz TIMESTAMP WITH LOCAL TIME ZONE, " + "PRIMARY KEY (id))", "INSERT INTO " + TABLE_NAME + " VALUES(" + "1,'Aaron',to_date('2009-05-14','yyyy-mm-dd')," + "1000000.00,'engineering','29-DEC-09 12.00.00.000000000 PM'," + "'29-DEC-09 12.00.00.000000000 PM')", "INSERT INTO " + TABLE_NAME + " VALUES(" + "2,'Bob',to_date('2009-04-20','yyyy-mm-dd')," + "400.00,'sales','30-DEC-09 12.00.00.000000000 PM'," + "'30-DEC-09 12.00.00.000000000 PM')", "INSERT INTO " + TABLE_NAME + " VALUES(" + "3,'Fred',to_date('2009-01-23','yyyy-mm-dd'),15.00," + "'marketing','31-DEC-09 12.00.00.000000000 PM'," + "'31-DEC-09 12.00.00.000000000 PM')", }; /* * Array containing SQL statements necessary to create, populate and * provision the secondary test table. */ private static final String[] SECONDARY_TABLE_SQL_STMTS = new String[] { "CREATE TABLE " + SECONDARY_TABLE_NAME + " (" + "id INT NOT NULL, " + "name VARCHAR2(24) NOT NULL, " + "PRIMARY KEY (id))", "INSERT INTO " + SECONDARY_TABLE_NAME + " VALUES(" + "1,'MercuryCorp')", "INSERT INTO " + SECONDARY_TABLE_NAME + " VALUES(" + "2,'VenusCorp')", "INSERT INTO " + SECONDARY_TABLE_NAME + " VALUES(" + "3,'EarthCorp')", "INSERT INTO " + SECONDARY_TABLE_NAME + " VALUES(" + "4,'MarsCorp')", "INSERT INTO " + SECONDARY_TABLE_NAME + " VALUES(" + "5,'JupiterCorp')", "INSERT INTO " + SECONDARY_TABLE_NAME + " VALUES(" + "6,'SaturnCorp')", "GRANT SELECT, INSERT ON " + SECONDARY_TABLE_NAME + " TO " + OracleUtils.ORACLE_USER_NAME, }; // instance variables populated during setUp, used during tests private OracleManager manager; @Override protected boolean useHsqldbTestServer() { return false; } private void executeUpdates(OracleManager mgr, String[] sqlStmts) { Connection connection = null; Statement st = null; try { connection = mgr.getConnection(); connection.setAutoCommit(false); st = connection.createStatement(); for (String sql : sqlStmts) { st.executeUpdate(sql); } connection.commit(); } catch (SQLException sqlE) { LOG.error("Encountered SQL Exception: " + sqlE); sqlE.printStackTrace(); fail("SQLException when running test setUp(): " + sqlE); } finally { try { if (null != st) { st.close(); } if (null != connection) { connection.close(); } } catch (SQLException sqlE) { LOG.warn("Got SQLException when closing connection: " + sqlE); } } } private void provisionSecondaryTable() { SqoopOptions options = new SqoopOptions(OracleUtils.CONNECT_STRING, SECONDARY_TABLE_NAME); OracleUtils.setOracleSecondaryUserAuth(options); OracleManager mgr = new OracleManager(options); // Drop the existing table if there is one try { OracleUtils.dropTable(SECONDARY_TABLE_NAME, mgr); } catch (SQLException sqlE) { fail("Could not drop table " + SECONDARY_TABLE_NAME + ": " + sqlE); } executeUpdates(mgr, SECONDARY_TABLE_SQL_STMTS); try { mgr.close(); } catch (SQLException sqlE) { fail("Failed to close secondary manager instance : " + sqlE); } } @Before public void setUp() { super.setUp(); provisionSecondaryTable(); SqoopOptions options = new SqoopOptions(OracleUtils.CONNECT_STRING, TABLE_NAME); OracleUtils.setOracleAuth(options); manager = new OracleManager(options); options.getConf().set("oracle.sessionTimeZone", "US/Pacific"); // Drop the existing table, if there is one. try { OracleUtils.dropTable(TABLE_NAME, manager); } catch (SQLException sqlE) { fail("Could not drop table " + TABLE_NAME + ": " + sqlE); } executeUpdates(manager, MAIN_TABLE_SQL_STMTS); } @After public void tearDown() { super.tearDown(); try { manager.close(); } catch (SQLException sqlE) { LOG.error("Got SQLException: " + sqlE.toString()); fail("Got SQLException: " + sqlE.toString()); } } private String[] getArgv() { return getArgv(TABLE_NAME); } private String[] getArgv(String tableName) { ArrayList<String> args = new ArrayList<String>(); CommonArgs.addHadoopFlags(args); args.add("-D"); args.add("oracle.sessionTimeZone=US/Pacific"); args.add("--table"); args.add(tableName); args.add("--warehouse-dir"); args.add(getWarehouseDir()); args.add("--connect"); args.add(OracleUtils.CONNECT_STRING); args.add("--username"); args.add(OracleUtils.ORACLE_USER_NAME); args.add("--password"); args.add(OracleUtils.ORACLE_USER_PASS); args.add("--num-mappers"); args.add("1"); return args.toArray(new String[0]); } private void runSecondaryTableTest(String[] expectedResults) throws IOException { Path warehousePath = new Path(this.getWarehouseDir()); Path tablePath = new Path(warehousePath, QUALIFIED_SECONDARY_TABLE_NAME); Path filePath = new Path(tablePath, "part-m-00000"); File tableFile = new File(tablePath.toString()); if (tableFile.exists() && tableFile.isDirectory()) { // remove the directory before running the import FileListing.recursiveDeleteDir(tableFile); } String[] argv = getArgv(QUALIFIED_SECONDARY_TABLE_NAME); try { runImport(argv); } catch (IOException ioe) { LOG.error("Got IOException during import: " + ioe.toString()); ioe.printStackTrace(); fail(ioe.toString()); } File f = new File(filePath.toString()); assertTrue("Could not find imported data file", f.exists()); BufferedReader r = null; try { // Read through the file and make sure it's all there. r = new BufferedReader(new InputStreamReader(new FileInputStream(f))); for (String expectedLine : expectedResults) { compareRecords(expectedLine, r.readLine()); } } catch (IOException ioe) { LOG.error("Got IOException verifying results: " + ioe.toString()); ioe.printStackTrace(); fail(ioe.toString()); } finally { IOUtils.closeStream(r); } } private void runOracleTest(String[] expectedResults) throws IOException { Path warehousePath = new Path(this.getWarehouseDir()); Path tablePath = new Path(warehousePath, TABLE_NAME); Path filePath = new Path(tablePath, "part-m-00000"); File tableFile = new File(tablePath.toString()); if (tableFile.exists() && tableFile.isDirectory()) { // remove the directory before running the import. FileListing.recursiveDeleteDir(tableFile); } String[] argv = getArgv(); try { runImport(argv); } catch (IOException ioe) { LOG.error("Got IOException during import: " + ioe.toString()); ioe.printStackTrace(); fail(ioe.toString()); } File f = new File(filePath.toString()); assertTrue("Could not find imported data file", f.exists()); BufferedReader r = null; try { // Read through the file and make sure it's all there. r = new BufferedReader(new InputStreamReader(new FileInputStream(f))); for (String expectedLine : expectedResults) { compareRecords(expectedLine, r.readLine()); } } catch (IOException ioe) { LOG.error("Got IOException verifying results: " + ioe.toString()); ioe.printStackTrace(); fail(ioe.toString()); } finally { IOUtils.closeStream(r); } } @Test public void testOracleImport() throws IOException { // no quoting of strings allowed. NOTE: Oracle JDBC 11.1 drivers // auto-cast SQL DATE to java.sql.Timestamp. Even if you define your // columns as DATE in Oracle, they may still contain time information, so // the JDBC drivers lie to us and will never tell us we have a strict DATE // type. Thus we include HH:MM:SS.mmmmm below. // See http://www.oracle.com // /technology/tech/java/sqlj_jdbc/htdocs/jdbc_faq.html#08_01 String[] expectedResults = { "1,Aaron,2009-05-14 00:00:00.0,1000000,engineering," + "2009-12-29 12:00:00.0,2009-12-29 12:00:00.0", "2,Bob,2009-04-20 00:00:00.0,400,sales," + "2009-12-30 12:00:00.0,2009-12-30 12:00:00.0", "3,Fred,2009-01-23 00:00:00.0,15,marketing," + "2009-12-31 12:00:00.0,2009-12-31 12:00:00.0", }; runOracleTest(expectedResults); } @Test public void testSecondaryTableImport() throws IOException { String[] expectedResults = { "1,MercuryCorp", "2,VenusCorp", "3,EarthCorp", "4,MarsCorp", "5,JupiterCorp", "6,SaturnCorp", }; runSecondaryTableTest(expectedResults); } /** * Compare two lines. Normalize the dates we receive based on the expected * time zone. * @param expectedLine expected line * @param receivedLine received line * @throws IOException exception during lines comparison */ private void compareRecords(String expectedLine, String receivedLine) throws IOException { // handle null case if (expectedLine == null || receivedLine == null) { return; } // check if lines are equal if (expectedLine.equals(receivedLine)) { return; } // check if size is the same String[] expectedValues = expectedLine.split(","); String[] receivedValues = receivedLine.split(","); if (expectedValues.length != 7 || receivedValues.length != 7) { LOG.error("Number of expected fields did not match " + "number of received fields"); throw new IOException("Number of expected fields did not match " + "number of received fields"); } // check first 5 values boolean mismatch = false; for (int i = 0; !mismatch && i < 5; i++) { mismatch = !expectedValues[i].equals(receivedValues[i]); } if (mismatch) { throw new IOException("Expected:<" + expectedLine + "> but was:<" + receivedLine + ">"); } Date expectedDate = null; Date receivedDate = null; DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.S"); int offset = TimeZone.getDefault().getOffset(System.currentTimeMillis()) / 3600000; for (int i = 5; i < 7; i++) { // parse expected timestamp. try { expectedDate = df.parse(expectedValues[i]); } catch (ParseException ex) { LOG.error("Could not parse expected timestamp: " + expectedValues[i]); throw new IOException("Could not parse expected timestamp: " + expectedValues[i]); } // parse received timestamp try { receivedDate = df.parse(receivedValues[i]); } catch (ParseException ex) { LOG.error("Could not parse received timestamp: " + receivedValues[i]); throw new IOException("Could not parse received timestamp: " + receivedValues[i]); } // compare two timestamps considering timezone offset Calendar expectedCal = Calendar.getInstance(); expectedCal.setTime(expectedDate); expectedCal.add(Calendar.HOUR, offset); Calendar receivedCal = Calendar.getInstance(); receivedCal.setTime(receivedDate); if (!expectedCal.equals(receivedCal)) { throw new IOException("Expected:<" + expectedLine + "> but was:<" + receivedLine + ">, while timezone offset is: " + offset); } } } public void testPurgeClosedConnections() throws Exception { // Ensure that after an Oracle ConnManager releases any connections // back into the cache (or closes them as redundant), it does not // attempt to re-use the closed connection. SqoopOptions options = new SqoopOptions(OracleUtils.CONNECT_STRING, TABLE_NAME); OracleUtils.setOracleAuth(options); // Create a connection manager, use it, and then recycle its connection // into the cache. ConnManager m1 = new OracleManager(options); Connection c1 = m1.getConnection(); PreparedStatement s = c1.prepareStatement("SELECT 1 FROM dual", ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY); ResultSet rs = null; try { rs = s.executeQuery(); rs.close(); } finally { s.close(); } ConnManager m2 = new OracleManager(options); Connection c2 = m2.getConnection(); // get a new connection. m1.close(); // c1 should now be cached. // Use the second connection to run a statement. s = c2.prepareStatement("SELECT 2 FROM dual", ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY); try { rs = s.executeQuery(); rs.close(); } finally { s.close(); } m2.close(); // c2 should be discarded (c1 is already cached). // Try to get another connection from m2. This should result in // a completely different connection getting served back to us. Connection c2a = m2.getConnection(); assertFalse(c1.isClosed()); assertTrue(c2.isClosed()); assertFalse(c2a.isClosed()); s = c2a.prepareStatement("SELECT 3 FROM dual", ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY); try { rs = s.executeQuery(); rs.close(); } finally { s.close(); } m2.close(); // Close the manager's active connection again. } public void testSessionUserName() throws Exception { SqoopOptions options = new SqoopOptions(OracleUtils.CONNECT_STRING, TABLE_NAME); OracleUtils.setOracleAuth(options); // Create a connection manager and get a connection OracleManager m1 = new OracleManager(options); Connection c1 = m1.getConnection(); // Make sure that the session username is the same as the Oracle // sqoop user name String sessionUserName = m1.getSessionUser(c1); assertEquals(OracleUtils.ORACLE_USER_NAME, sessionUserName); } }