Updated Branches:
  refs/heads/sqoop2 065ecd6d2 -> 30581fb4e

SQOOP-1234. Sqoop2: Clean up comments in MSubmission class

(Jarek Jarcec Cecho via Hari Shreedharan)


Project: http://git-wip-us.apache.org/repos/asf/sqoop/repo
Commit: http://git-wip-us.apache.org/repos/asf/sqoop/commit/30581fb4
Tree: http://git-wip-us.apache.org/repos/asf/sqoop/tree/30581fb4
Diff: http://git-wip-us.apache.org/repos/asf/sqoop/diff/30581fb4

Branch: refs/heads/sqoop2
Commit: 30581fb4e5dec1e4b46945deb4795f8950414dce
Parents: 065ecd6
Author: Hari Shreedharan <[email protected]>
Authored: Sun Feb 2 21:09:16 2014 -0800
Committer: Hari Shreedharan <[email protected]>
Committed: Sun Feb 2 21:09:16 2014 -0800

----------------------------------------------------------------------
 .../org/apache/sqoop/model/MSubmission.java     | 24 +++++++++++++-------
 1 file changed, 16 insertions(+), 8 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/sqoop/blob/30581fb4/common/src/main/java/org/apache/sqoop/model/MSubmission.java
----------------------------------------------------------------------
diff --git a/common/src/main/java/org/apache/sqoop/model/MSubmission.java 
b/common/src/main/java/org/apache/sqoop/model/MSubmission.java
index a126d40..1edd6ee 100644
--- a/common/src/main/java/org/apache/sqoop/model/MSubmission.java
+++ b/common/src/main/java/org/apache/sqoop/model/MSubmission.java
@@ -53,49 +53,56 @@ public class MSubmission extends MAccountableEntity {
   /**
    * Any valid external id associated with this submission.
    *
-   * This property might be missing, but it's value will be recorded in 
metastore.
+   * This property is optional and might be NULL in case that the job has not
+   * yet been submitted to the external system (JobTracker, ResourceManager, 
...).
    */
   String externalId;
 
   /**
    * Progress in the job.
    *
-   * This is optional property that is not serialized in metastore.
+   * This property is optional.
+   *
+   * This property holds the progress of the external process that is 
executing the
+   * Sqoop 2 job. As a result, this property will contain 0 during 
initialization
+   * and submission and will be updated only after the successful submission. 
Please
+   * note that some submission engines might not be able to report the 
progress at
+   * the required granularity and such this property might not be used at all.
    */
   double progress;
 
   /**
    * Counters associated with the job if it's already in finished state
    *
-   * This is optional property that is not serialized in metastore.
+   * This is property is optional.
    */
   Counters counters;
 
   /**
    * Link to external UI if available
    *
-   * This is optional property that is not serialized in metastore.
+   * This property is optional.
    */
   String externalLink;
 
   /**
    * Associated exception info with this job (if any).
    *
-   * This is optional property that is not serialized in metastore.
+   * This property is optional.
    */
   String exceptionInfo;
 
   /**
    * Associated exception stacktrace with this job (if any).
    *
-   * This is optional property that is not serialized in metastore.
+   * This property is optional.
    */
   String exceptionStackTrace;
 
   /**
    * Schema that was reported by the connector.
    *
-   * This is optional property that is currently not serialized into metastore.
+   * This property is required.
    */
   Schema connectorSchema;
 
@@ -104,7 +111,7 @@ public class MSubmission extends MAccountableEntity {
    * note that this property might be empty and in such case the connector
    * schema will use also on Hadoop I/O side.
    *
-   * This is optional property that is currently not serialized into metastore.
+   * This property is optional.
    */
   Schema hioSchema;
 
@@ -117,6 +124,7 @@ public class MSubmission extends MAccountableEntity {
     this();
     this.jobId = jobId;
     this.status = status;
+    setCreationDate(creationDate);
   }
 
   public MSubmission(long jobId) {

Reply via email to