编辑 - Teradata Data Mover

用途

edit 命令可修改现有作业定义。所有以前执行的作业都会与新的作业定义相关联。

语法

请参阅 http://schemas.teradata.com/unity/DataMover.xsd。

参数

请参阅参数顺序。

data_streams

[可选] 可在源数据库和目标数据库之间使用的数据流数量。适用于使用 Teradata DSA 和 TPT API（与 Teradata 之间）的作业。所有其他协议均使用单个数据流。

示例: 4

缺省值由 Data Mover 动态计算。

db_client_encryption

[可选] 数据传输期间需要加密作业时设置为 true。

force_utility

[可选] 强制 Data Mover 守护程序使用特定实用程序执行所有复制操作。

有效值

• dsa
• jdbc
• tptapi
• tptapi_load
• tptapi_stream
• tptapi_update
• T2T

如果未指定此值，则 Data Mover 守护程序将确定最适合该作业的 Teradata 实用程序。

使用 Teradata DSA 将数据复制到旧版 Teradata Database 是无效的。如果源 TDPID 和目标 TDPID 相同，则不能使用 Teradata DSA。

示例: dsa

job_name

要编辑的作业的名称

示例: 12315DFHJKS

job_priority

[可选] 指定作业的执行优先级。支持的值包括：“HIGH”、“MEDIUM”、“LOW”和“UNSPECIFIED”。如果未指定值，则运行时使用缺省值“MEDIUM”。

示例: MEDIUM

log_level

[可选] 日志文件输出的日志级别。

有效值

• 0
• 1
• 2
• 99

示例: 2

缺省值为 0。

max_agents_per_task

[可选] 移动表或数据库时，可并行使用的 Data Mover 代理的最大数量。

示例: 4

缺省值由 Data Mover 动态计算。

netrace

[可选] CLI netrace 参数。该值大于或等于 0 时会生成 CLI 跟踪日志。必须提供有效的 CLI 值。

netrace_buf_len

[可选] CLI netrace_buf_len 参数。该值大于或等于 0 时会生成 CLI 跟踪日志。必须提供有效的 CLI 值。

online_archive

[可选] 使用 Teradata DSA 复制源表时，允许读写访问源表。复制过程中源表会发生更新，但更新不会传输至目标表。复制成功后，目标表中包含的数据与复制开始时源表中的数据匹配。

有效值

值	说明
True	启用在线存档
False	禁用在线存档
Unspecified	缺省值- 此值将设置为 Data Mover 守护程序配置文件中的值

示例: true

overwrite_existing_objects

[可选] 作业覆盖目标上已存在的对象。

有效值

值	说明
True	启用覆盖
False	禁用覆盖
Unspecified	缺省值- 此值将设置为 Data Mover 守护程序配置文件中的值

如果未指定此参数，该值将设置为 Data Mover 守护程序配置文件中的 overwrite_existing_objects 参数值。如果此参数指定为 true 或 false，则该值优先于 Data Mover 守护程序配置文件中的参数值。

示例: true

query_band

[可选] 唯一标识 Teradata 会话或源及目标事务的分号分隔名称-值对集。要使用查询带标识作业 payroll、用户 ID aa100000 以及作业会话编号 1122，请按照如下方式定义查询带:

示例: Job=payroll;Userid=aa1000000;Jobsession=1122;

此参数必须添加为 XML 作业定义中的最后一个参数。有关定义查询带使用的详细语法规则，请参考关于查询带。

response_timeout

[可选] 等待 Data Mover 守护程序响应的时间（以秒为单位）。

示例: 60

security_password

[可选] 超级用户或授权 Viewpoint 用户的密码。

示例: 53cUr17y

如果 Data Mover 守护程序上已启用安全管理功能，则必须提供此参数。如果同时指定了 -security_password_encrypted，则此参数无效。

security_password_encrypted

[可选] 超级用户的加密密码。

示例: 052c7aabd14c7770141ac3c0137ab98ae0d3f0f7cddf588981206b010c0c1b2f

如果 Data Mover 守护程序上已启用安全管理功能，则必须提供此参数。如果同时指定了 -security_password，则此参数无效。

security_username

[可选] 超级用户或授权 Viewpoint 用户的用户 ID。超级用户的用户 ID 为 dmcl_admin 且不能更改。

如果 Data Mover 守护程序上已启用安全管理功能，则必须提供此参数。

source_account_id

[可选] 源数据库的登录帐户 ID。

如果源或目标帐户 ID 的帐户名中存在空格，则会导致作业失败。

source_logon_mechanism

[可选] 源系统的登录机制。要登录源 Teradata Database 系统，用户必须至少提供以下其中之一：

• source_user 和 source_password
• source_logon_mechanism

Teradata DSA 作业不支持登录机制。请仅对 Teradata PT API 和 Teradata JDBC 作业使用登录机制。如果指定了 -source_logon_mechanism，而未使用 -force_utility，则缺省情况下会使用 Teradata PT API。如果已为 -force_utility 指定 Teradata DSA，指定 -source_logon_mechanism 将导致出现错误。

示例: KRB5

source_logon_mechanism_data

[可选] 源系统的登录机制所需的其他参数。

示例: joe@domain1@@mypassword

source_password

[可选] 源 Teradata 登录密码。

示例: 123456789

如果同时指定了 source_password_encrypted，则此参数无效。

source_password_encrypted

[可选] 源 Teradata 加密登录密码。

示例: 17894cc84b5637a88e36fa37a010e3662d18f64b8ce204bef8d63868ad417810

如果同时指定了 -source_password，则此参数无效。

source_sessions

[可选] 源数据库上每数据流的会话数。

示例: 4

缺省值由 Data Mover 动态计算。

source_tdpid

[可选] 源 Teradata Database。

示例: Checks

source_user

[可选] 源 Teradata 登录 ID。

示例: TD_API_user

source_userid_pool

[可选] 作业会从指定的凭据池提取用户。适用于所有作业类型。如果在同一作业中同时指定 target_userid_pool 参数，则这两个参数必须使用相同的凭据池。

示例: POOL-1

target_account_id

[可选] 目标数据库的登录帐户 ID。

如果源或目标帐户 ID 的帐户名中存在空格，则会导致作业失败。

target_logon_mechanism

[可选] 目标系统的登录机制。要登录目标 Teradata Database 系统，用户必须至少提供以下其中之一：

• target_user 和 target_password
• target_logon_mechanism

Teradata DSA 不支持登录机制。请仅对 Teradata PT API 和 Teradata JDBC 作业使用登录机制。如果指定了 -target_logon_mechanism，而未使用 -force_utility，则缺省情况下会使用 Teradata PT API。如果已为 -force_utility 指定 Teradata DSA，则指定 -target_logon_mechanism 将导致出现错误。

示例: KRB5

target_logon_mechanism_data

[可选] 目标系统登录机制所需的其他参数。

示例: my@domain2@@mypassword

target_password

[可选] 目标 Teradata 登录密码。

示例: 212133344

如果同时指定了 -target_password_encrypted，则此参数无效。

target_password_encrypted

[可选] 目标 Teradata 加密登录密码。

示例: 30e458fce484cefef07724653f5046095208f69fcfbf76bf7290b8576192c2fe

如果同时指定了 -target_password，则此参数无效。

target_sessions

[可选] 目标数据库上每数据流的会话数。

示例: 4

缺省值由 Data Mover 动态计算。

target_tdpid

[可选] 目标 Teradata Database。

示例: Leo

target_user

[可选] 目标 Teradata 登录 ID。

示例: TD_tar_user

target_userid_pool

[可选] 作业会从指定的凭据池提取用户。适用于所有作业类型。如果在同一作业中同时指定 source_userid_pool 参数，则这两个参数必须使用相同的凭据池。

示例: POOL-1

tpt_debug

[可选] TPT API 跟踪调试日志参数。该值大于或等于 0 时会生成 TPT API 跟踪日志。必须提供有效的 TPT API 值。

uowid

[可选] 与作业关联的批量工作的备用 ID 或名称。如果提供了此参数的值，将事件发送至 Teradata Ecosystem Manager 或其内部 TMSMEVENT 表时，Data Mover 将此值报告为工作单元 ID。如果未指定此参数，将事件发送至 Teradata Ecosystem Manager 或其内部 TMSMEVENT 表时，Data Mover 会使用缺省值作为工作单元 ID。工作单元 ID 的缺省值由作业执行名称和当前时间戳构成。例如，如果要定义查询源的来源，而作业执行名称为 sales_table，则工作单元 ID 的缺省值为 sales_table-20110115155656EST

示例: sales_tables_start

用法说明

如果已启用安全设置，并且在修改后的 XML 中指定了 job_security 以更改作业所有者，则用户必须为 dcml_admin；如果已启用安全设置，并且在修改后的 XML 中指定了 job_security 以更改作业权限，则用户必须为 dcml_admin 或作业所有者，并且该用户必须提供所有权限（而不仅仅是修改后的权限）。

请确保 XML 文件中的对象列表包含所有要移动的对象，而不仅仅是修改了名称的对象。如果更新后的列表不包含原始作业中指定的某个对象，则该对象不会从新作业定义中移除。如果未列出任何对象，Data Mover 会假定原始对象列表没有更新。

XML 文件示例

对于 edit 命令，请键入 datamove edit -f parameters.xml。

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
<dmEdit xmlns="http://schemas.teradata.com/dataMover/v2009"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://schemas.teradata.com/unity/datamover.xsd"> 
<!-- source and target ip not provided, they will be retrieved from original job def --> 
    <job_name>job_name<job_name>    
    <source_user>dm12066</source_user> 
    <source_password>dbc</source_password> 
    <target_user>dm12066</target_user> 
    <target_password>dbc</target_password> 
<!-- The following are the object which are different from original job def --> 
<database selection="unselected"> 
    <name>dm12066</name> 
    <table selection="included"> 
        <name>fmt_inf</name> 
        <validate_row_count>ALL</validate_row_count> 
        <compare_ddl>true</compare_ddl> 
    </table> 
    <table selection="included"> 
        <name>NOPITab</name> 
        <validate_row_count>ALL</validate_row_count> 
        <compare_ddl>true</compare_ddl> 
    </table> 
    </database> 
        <views> 
            <view selection="included" copyData="true"> 
                <name>arrayTabView</name> 
                <database>dm12066</database> 
                <validate_row_count>partial</validate_row_count> 
                <compare_ddl>true</compare_ddl> 
                <sql_where_clause><![CDATA[ where c1 = 2]]></sql_where_clause> 
                <key_columns> 
                    <key_column>c1</key_column> 
                </key_columns> 
            </view> 
        </views> 
</dmEdit>