spring batch (二) 元数据表

内容来自《Spring Batch 批处理框架》，作者：刘相。

一、spring batch 框架进行元数据管理共有六张表，三张SEQUENCE用来分配主键的，九张表分别是：

　　BATCH_JOB_INSTANCE

　　BATCH_JOB_EXECUTION

　　BATCH_JOB_EXECUTION_PARAMS

　　BATCH_STEP_EXECUTION

　　BATCH_STEP_EXECUTION_CONTEXT

　　BATCH_JOB_EXECUTION_CONTEXT

　　BATCH_STEP_EXECUTION_SEQ

　　BATCH_JOB_EXECUTION_SEQ

　　BATCH_JOB_SEQ

　　这几张表的建表脚本可以从框架中获取。我的在：spring-batch-core-3.0.9.RELEASE\org\springframework\batch\core\schema-oracle10g.sql。

　　下面对每张表的作用做个说明：

BATCH_JOB_INSTANCE	作业实例表。用于存放Job的实例信息。
BATCH_JOB_EXECUTION	作业执行器表。用于存放当前作业的执行信息，比如创建时间。执行开始时间，执行结束时间，执行的哪个Job实例，执行状态等。
BATCH_JOB_EXECUTION_PARAMS	作业参数表。用于存放每个Job执行时候的参数信息，该参数实际上是对应Job实例的。
BATCH_STEP_EXECUTION	作业步执行器表。用于存放每个Step执行器的信息，比如作业步的开始时间、执行完成时间、执行状态、读/写次数、跳过次数等。
BATCH_STEP_EXECUTION_CONTEXT	作业步执行上下文表。用于存放每个作业步的上下文信息。
BATCH_JOB_EXECUTION_CONTEXT	作业执行上下文表。用于存放作业执行器上下文的信息。
BATCH_STEP_EXECUTION_SEQ	作业步序列表。用于给表BATCH_STEP_EXECUTION和BATCH_STEP_EXECUTION_CONTEXT提供主键。
BATCH_JOB_EXECUTION_SEQ	作业执行器序列表。用于给表BATCH_JOB_EXECUTION和BATCH_JOB_EXECUTION_CONTEXT提供主键。
BATCH_JOB_SEQ	作业序列表。用于给表BATCH_JOB_INSTANCE和BATCH_JOB_EXECUTION_PARAMS提供主键。

二、每个表字段说明：

　　1.BATCH_JOB_INSTANCE

　　　　1.1 建表SQL：

CREATE TABLE BATCH_JOB_INSTANCE  (
    JOB_INSTANCE_ID NUMBER(19,0)  NOT NULL PRIMARY KEY ,
    VERSION NUMBER(19,0) ,
    JOB_NAME VARCHAR2(100) NOT NULL,
    JOB_KEY VARCHAR2(32) NOT NULL,
    constraint JOB_INST_UN unique (JOB_NAME, JOB_KEY)
) ;

　　　　1.2 字段说明：

　　　　　　JOB_INSTANCE_ID ：主键。作业实例ID编号，根据BATCH_JOB_SEQ自动生成。

　　　　　　VERSION ：版本号。

　　　　　　JOB_NAME ：作业名称。即在配置文件中定义的 job id 字段的内容。

　　　　　　JOB_KEY ：作业标识。根据作业参数序列化生成的标识。需要注意通过 JOB_NAME +JOB_KEY  能够唯一区分一个作业实例。如果是同一个Job，则JOB KEY一定不能相通，即作业参数不能相同。如果不是同一个JOB则KEY可以相同，也就说可以是同一个作业参数。

　　2.BATCH_JOB_EXECUTION

　　　　2.1 建表SQL：

CREATE TABLE BATCH_JOB_EXECUTION  (
    JOB_EXECUTION_ID NUMBER(19,0)  NOT NULL PRIMARY KEY ,
    VERSION NUMBER(19,0)  ,
    JOB_INSTANCE_ID NUMBER(19,0) NOT NULL,
    CREATE_TIME TIMESTAMP NOT NULL,
    START_TIME TIMESTAMP DEFAULT NULL ,
    END_TIME TIMESTAMP DEFAULT NULL ,
    STATUS VARCHAR2(10) ,
    EXIT_CODE VARCHAR2(2500) ,
    EXIT_MESSAGE VARCHAR2(2500) ,
    LAST_UPDATED TIMESTAMP,
    JOB_CONFIGURATION_LOCATION VARCHAR(2500) NULL,
    constraint JOB_INST_EXEC_FK foreign key (JOB_INSTANCE_ID)
    references BATCH_JOB_INSTANCE(JOB_INSTANCE_ID)
) ;

　　　　2.2 字段说明：

　　　　　　JOB_EXECUTION_ID ：主键。作业执行器ID编号。

　　　　　　VERSION ：版本号。

　　　　　　JOB_INSTANCE_ID ：作业实例ID编号。

　　　　　　CREATE_TIME ：作业执行器创建时间。

　　　　　　START_TIME ：作业执行器开始执行时间。

　　　　　　END_TIME ：作业执行器结束时间。

　　　　　　STATUS ：作业执行器的状态。如：COMPLETED,STARTING,STARTED,STOPPING,STOPTED,FAILED,ABANDED,UNKNOWN。这些状态在类org.springframework.batch.core.ExitStatus中。

　　　　　　EXIT_CODE ：作业执行器退出编码。如：UNKNOWN,EXEXCUTION,COMPLETED,NOOP,FAILED,STOPPED。这些状态在类org.springframework.batch.core.ExitStatus中定义的。

　　　　　　EXIT_MESSAGE ：作业执行器退出描述，详细描述退出的信息，如果发生异常，通常包含异常的堆栈信息。

　　　　　　LAST_UPDATED ：本条记录上次更新时间。

　　　　　　JOB_CONFIGURATION_LOCATION ：Job本地配置信息。

　　3.BATCH_JOB_EXECUTION_PARAMS

　　　　3.1 建表SQL：

CREATE TABLE BATCH_JOB_EXECUTION_PARAMS  (
    JOB_EXECUTION_ID NUMBER(19,0) NOT NULL ,
    TYPE_CD VARCHAR2(6) NOT NULL ,
    KEY_NAME VARCHAR2(100) NOT NULL ,
    STRING_VAL VARCHAR2(250) ,
    DATE_VAL TIMESTAMP DEFAULT NULL ,
    LONG_VAL NUMBER(19,0) ,
    DOUBLE_VAL NUMBER ,
    IDENTIFYING CHAR(1) NOT NULL ,
    constraint JOB_EXEC_PARAMS_FK foreign key (JOB_EXECUTION_ID)
    references BATCH_JOB_EXECUTION(JOB_EXECUTION_ID)
) ;

　　　　3.2 字段说明：

　　　　　　JOB_EXECUTION_ID：外键，作业执行器ID编号。一个作业实例可能会有多行参数记录，主要根据参数的个数决定的。

　　　　　　TYPE_CD ：参数类型，可能是如下四种当中的一种：date、string、long、double。

　　　　　　KEY_NAME ：参数的名字。

　　　　　　STRING_VAL ：如果参数是String类型此处存放是String类型的参数值。

　　　　　　DATE_VAL ：如果参数是date类型，此处存放的是date类型的参数值。

　　　　　　LONG_VAL ：如果参数是long类型，此处存放是long类型的参数值。

　　　　　　DOUBLE_VAL ：如果参数是double类型，则此处存放double类型的参数值。

　　　　　　IDENTIFYING ：用于标识作业参数是否标识作业实例。

　　4.BATCH_STEP_EXECUTION

　　　　4.1 建表SQL：

CREATE TABLE BATCH_STEP_EXECUTION  (
    STEP_EXECUTION_ID NUMBER(19,0)  NOT NULL PRIMARY KEY ,
    VERSION NUMBER(19,0) NOT NULL,
    STEP_NAME VARCHAR2(100) NOT NULL,
    JOB_EXECUTION_ID NUMBER(19,0) NOT NULL,
    START_TIME TIMESTAMP NOT NULL ,
    END_TIME TIMESTAMP DEFAULT NULL ,
    STATUS VARCHAR2(10) ,
    COMMIT_COUNT NUMBER(19,0) ,
    READ_COUNT NUMBER(19,0) ,
    FILTER_COUNT NUMBER(19,0) ,
    WRITE_COUNT NUMBER(19,0) ,
    READ_SKIP_COUNT NUMBER(19,0) ,
    WRITE_SKIP_COUNT NUMBER(19,0) ,
    PROCESS_SKIP_COUNT NUMBER(19,0) ,
    ROLLBACK_COUNT NUMBER(19,0) ,
    EXIT_CODE VARCHAR2(2500) ,
    EXIT_MESSAGE VARCHAR2(2500) ,
    LAST_UPDATED TIMESTAMP,
    constraint JOB_EXEC_STEP_FK foreign key (JOB_EXECUTION_ID)
    references BATCH_JOB_EXECUTION(JOB_EXECUTION_ID)
) ;

　　　　4.2 字段说明：

　　　　　　STEP_EXECUTION_ID ：主键，作业步实例ID编号。

　　　　　　VERSION ：版本。

　　　　　　STEP_NAME ：操作步的名字。

　　　　　　JOB_EXECUTION_ID ：外键。操作执行器ID。

　　　　　　START_TIME ：操作步执行器开始执行时间。

　　　　　　END_TIME ：操作步执行器结束时间。

　　　　　　STATUS ：操作步执行器执行状态，如：COMPLETED,STARTING,STARTED,STOPPING,STOPPED,FAILED,ABANDED,UNKNOWN。这些状态在类：org.springframework.batch.core.ExitStatus中。

　　　　　　COMMIT_COUNT ：事务提交次数。

　　　　　　READ_COUNT ：读数据的次数。

　　　　　　FILTER_COUNT ：过滤掉的数据次数。

　　　　　　WRITE_COUNT ：写数据的次数。

　　　　　　READ_SKIP_COUNT ：读数据跳过的次数。

　　　　　　WRITE_SKIP_COUNT ：写数据跳过的次数。

　　　　　　PROCESS_SKIP_COUNT ：处理数据跳过的次数。

　　　　　　ROLLBACK_COUNT ：事务回滚次数。

　　　　　　EXIT_CODE ：操作步执行器的退出编码。如：UNKNOWN,EXEXCUTION,COMPLETED,NOOP,FAILED,STOPPED。这些状态在类org.springframework.batch.core.ExitStatus中定义的。

　　　　　　EXIT_MESSAGE ：操作步执行器退出描述，详细描述退出的信息。如异常的堆栈信息等。

　　　　　　LAST_UPDATED ：本条记录上次更新时间。

　　5.BATCH_STEP_EXECUTION_CONTEXT

　　　　5.1 建表SQL：

CREATE TABLE BATCH_STEP_EXECUTION_CONTEXT  (
    STEP_EXECUTION_ID NUMBER(19,0) NOT NULL PRIMARY KEY,
    SHORT_CONTEXT VARCHAR2(2500) NOT NULL,
    SERIALIZED_CONTEXT CLOB ,
    constraint STEP_EXEC_CTX_FK foreign key (STEP_EXECUTION_ID)
    references BATCH_STEP_EXECUTION(STEP_EXECUTION_ID)
) ;

　　　　5.2 字段说明：

　　　　　　STEP_EXECUTION_ID ：外键。操作步执行器ID编号。

　　　　　　SHORT_CONTEXT ：作业执行器上下文字符串格式。

　　　　　　SERIALIZED_CONTEXT ：序列化的作业执行器上下文。

　　6.BATCH_JOB_EXECUTION_CONTEXT

　　　　6.1 建表SQL：

CREATE TABLE BATCH_JOB_EXECUTION_CONTEXT  (
    JOB_EXECUTION_ID NUMBER(19,0) NOT NULL PRIMARY KEY,
    SHORT_CONTEXT VARCHAR2(2500) NOT NULL,
    SERIALIZED_CONTEXT CLOB ,
    constraint JOB_EXEC_CTX_FK foreign key (JOB_EXECUTION_ID)
    references BATCH_JOB_EXECUTION(JOB_EXECUTION_ID)
) ;

　　　　6.2 字段说明：

　　　　　　JOB_EXECUTION_ID ：外键。作业执行器ID编号。

　　　　　　SHORT_CONTEXT ：作业执行器上下文字符串格式。

　　　　　　SERIALIZED_CONTEXT ：序列化的作业执行器上下文。