用途
create 命令使用语法参数和对象列表在守护程序上创建一个作业。作业定义由参数和对象列表组成。
语法
请参阅 Data Mover XML 模式。
参数
请参阅参数顺序。
- data_streams
- [可选] 可在源数据库和目标数据库之间使用的数据流数量。适用于使用 Teradata DSA 和 TPT API（与 Teradata 之间）的作业。所有其他协议均使用单个数据流。
- db_client_encryption
- [可选] 数据传输期间需要加密作业时设置为 true。
- dm.rest.endpoint
- [可选] 输入 Data Mover REST 服务器 URL 以覆盖 commandline.properties 文件中指定的缺省值，以便在运行时连接到不同的 REST 服务器（进而连接到不同的守护程序）。
- execute_permission
- [可选] 定义对已创建的作业具有执行权限的用户名和角色。
- force_utility
- [可选] 强制 Data Mover 守护程序使用特定实用程序执行所有复制操作。
有效值
- dsa
- jdbc
- tptapi
- tptapi_load
- tptapi_stream
- tptapi_update
- T2T
使用 Teradata DSA 将数据复制到旧版 Teradata Database 是无效的。如果源 TDPID 和目标 TDPID 相同，则不能使用 Teradata DSA。 - freeze_job_steps
- [可选] 冻结作业步骤，以使其不会在每次启动作业时都重新创建。只有在创建作业后源环境和目标环境不会变化时，才应设置为 true。有效值
- true - 每次启动作业时不重新创建作业步骤
- false - 每次启动作业时重新创建作业步骤
- 未指定（缺省）- 值设为 false
- job_name
- [可选] 作业的名称。该名称必须是唯一的，并且最多包含 32 个字符。
- job_priority
- [可选] 指定作业的执行优先级。支持的值包括：“HIGH”、“MEDIUM”、“LOW”和“UNSPECIFIED”。如果未指定值，则运行时使用缺省值“MEDIUM”。
- job_security
- [可选] 为已创建的作业定义访问参数。
- log_level
- [可选] 日志文件输出的日志级别。
有效值
- 0
- 1
- 2
- 99
- log_to_event_table
- [可选] 指定要用于此作业的事件表。有关详细信息，请参阅使用事件表。
- max_agents_per_task
- [可选] 移动表或数据库时，可并行使用的 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 守护程序配置文件中的值 - overwrite_existing_objects
- [可选] 作业覆盖目标上已存在的对象。有效值如果未指定此参数，该值将设置为 Data Mover 守护程序配置文件中的 overwrite_existing_objects 参数值。如果此参数指定为 true 或 false，则该值优先于 Data Mover 守护程序配置文件中的参数值。
值 说明 True 启用覆盖 False 禁用覆盖 Unspecified 缺省值- 此值将设置为 Data Mover 守护程序配置文件中的值 - owner_name
- [可选] 创建作业的用户。
- read_permission
- [可选] 定义对已创建的作业具有读取权限的用户名和角色。
- response_timeout
- [可选] 等待 Data Mover 守护程序响应的时间（以秒为单位）。
- source_account_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 将导致出现错误。
- source_logon_mechanism_data
- [可选] 源系统的登录机制所需的其他参数。
- source_password
- [可选] 源 Teradata 登录密码。
- source_password_encrypted
- [可选] 源 Teradata 加密登录密码。
- source_sessions
- [可选] 源数据库上每数据流的会话数。
- source_tdpid
- 源 Teradata Database。
- source_user
- [可选] 源 Teradata 登录 ID。
- source_userid_pool
- [可选] 作业会从指定的凭据池提取用户。适用于所有作业类型。如果在同一作业中同时指定 target_userid_pool 参数，则这两个参数必须使用相同的凭据池。
- table
- [可选] 要复制的表。
- target_account_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 将导致出现错误。
- target_logon_mechanism_data
- [可选] 目标系统登录机制所需的其他参数。
- target_password
- [可选] 目标 Teradata 登录密码。
- target_password_encrypted
- [可选] 目标 Teradata 加密登录密码。
- target_sessions
- [可选] 目标数据库上每数据流的会话数。
- target_tdpid
- [可选] 目标 Teradata Database。
- target_user
- [可选] 目标 Teradata 登录 ID。
- target_userid_pool
- [可选] 作业会从指定的凭据池提取用户。适用于所有作业类型。如果在同一作业中同时指定 source_userid_pool 参数，则这两个参数必须使用相同的凭据池。
- tpt_debug
- [可选] TPT API 跟踪调试日志参数。该值大于或等于 0 时会生成 TPT API 跟踪日志。必须提供有效的 TPT API 值。
- write_permission
- [可选] 定义对已创建的作业具有写入权限的用户名和角色。
用法说明
键入 datamove create -f parameters.xml 可创建作业。当 create 命令完成时，将会在屏幕上显示作业名称。请记住此作业名称以在其他命令中使用，例如 stop 和 start 命令。
create 命令不会启动作业。使用 start 命令启动作业，或使用 edit 命令查看作业脚本。
XML 文件示例
对于 create 命令，请键入 datamove create -f parameters.xml。
以下示例显示了 create 命令的参数文件。
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<dmCreate
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">
<job_name>floyd_dmdev_create</job_name>
<source_tdpid>floyd</source_tdpid>
<source_user>dmguest</source_user>
<source_password>please</source_password>
<target_tdpid>dmdev</target_tdpid>
<target_user>dmguest</target_user>
<target_password>please</target_password>
<data_streams>5</data_streams>
<source_sessions>1</source_sessions>
<target_sessions>1</target_sessions>
<force_utility>dsa</force_utility>
<log_level>0</log_level>
<db_client_encryption>false</db_client_encryption>
<database selection="unselected">
<name>dmguest</name>
<table selection="included">
<name>test1</name>
<db_client_encryption>true</db_client_encryption>
</table>
<table selection="included">
<name>test2</name>
</table>
<table selection="included">
<name>test3</name>
</table>
</database>
<query_band>Job=payroll;Userid=aa1000000;Jobsession=1122;</query_band>
<job_security>
<owner_name>owner</owner_name>
<read_permission>
<username>read_user1</username>
<username>read_user2</username>
<role>read_role1</role>
<role>read_role2</role>
</read_permission>
<write_permission>
<username>write_user1</username>
<username>write_user2</username>
<role>write_role1</role>
<role>write_role2</role>
</write_permission>
<execute_permission>
<username>execute_user1</username>
<username>execute_user2</username>
<role>execute_role1</role>
<role>execute_role2</role>
</execute_permission>
</job_security>
</dmCreate>