创建云暂存复制作业 - Teradata Data Mover

用途

您需要一个有效的云暂存区来创建云暂存复制作业。要创建云暂存复制作业，请将 force_utility 定义为 DSA 并添加一个 cloud_staging_area 元素。

命令：create -job_name DMCS2Job -f create.xml

语法

参数

请参阅参数顺序。

以下示例显示了添加到 XML 的其他 DSA 参数。

data_streams

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

示例: 4

缺省值由 Data Mover 动态计算。

db_client_encryption

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

dm.rest.endpoint

[可选] 输入 Data Mover REST 服务器 URL 以覆盖 commandline.properties 文件中指定的缺省值，以便在运行时连接到不同的 REST 服务器（进而连接到不同的守护程序）。

https://dm-server1:1443/datamover

execute_permission

[可选] 定义对已创建的作业具有执行权限的用户名和角色。

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

freeze_job_steps

[可选] 冻结作业步骤，以便每次启动作业时不重新创建作业步骤。仅在创建作业后源环境和目标环境未更改时才设置为 true。

有效值

• true - 每次启动作业时不重新创建作业步骤
• false - 每次启动作业时重新创建作业步骤
• 未指定（缺省）- 值设为 false

示例: true

job_name

[可选] 作业的名称。该名称必须是唯一的，并且最多包含 32 个字符。

如果未指定名称，系统将使用下列格式自动生成名称：<source tdpid >_<target tdpid >_<date time year>。

job_priority

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

示例: MEDIUM

job_security

[可选] 为已创建的作业定义访问参数。

log_level

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

有效值

• 0
• 1
• 2
• 99

示例: 2

缺省值为 0。

log_to_event_table

[可选] 指定要用于此作业的事件表。有关详细信息，请参阅使用事件表。

cloud_staging_area

[可选] 指定要用于此作业的云暂存区。云暂存区是运行云暂存复制作业所必需的。

如果指定了 -cloud_storage_area 而未使用 -force_utility，则缺省情况下使用 Teradata DSA。

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

owner_name

[可选] 创建作业的用户。

示例: owner

如果守护程序安全已关闭或者用户为超级用户 (dmcl_admin)，则设置此值；否则，实际登录用户将覆盖此值。

read_permission

[可选] 定义对已创建的作业具有读取权限的用户名和角色。

response_timeout

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

示例: 60

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

如果没有为此参数指定登录 ID，此命令将提示您以交互方式输入此 ID。

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

source_userid_pool

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

示例: POOL-1

table

[可选] 要复制的表。

示例: DB1.TABLE

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

如果没有为此参数指定登录 ID，此命令将提示您以交互方式输入此 ID。

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

target_userid_pool

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

示例: POOL-1

tpt_debug

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

write_permission

[可选] 定义对已创建的作业具有写入权限的用户名和角色。

用法说明

键入 datamove create -f create.xml 可创建作业。创建命令完成后，作业名称将显示在屏幕上。

create 命令不会启动作业。使用 start 命令启动作业，或使用 edit 命令查看作业脚本。

XML 文件示例

<?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/dataMover/v2009/DataMover.xsd">
      <source_tdpid>sourceSys</source_tdpid> 
      <source_user>source_user</source_user>
      <source_password>source_password</source_password>
      <target_tdpid>targetSyc</target_tdpid>
      <target_user>target_user</target_user>
      <target_password>target_password</target_password>
      <data_streams>1</data_streams>
      <source_sessions>1</source_sessions>
      <target_sessions>1</target_sessions>
      <freeze_job_steps>FALSE</freeze_job_steps>
      <force_utility>DSA</force_utility>
      <log_level>99</log_level>
	<cloud_staging_area>
        <name>csareaname</name>
       </cloud_staging_area>
	<dsa_options>
		      <target_group_name>my_target_group</target_group_name>
		<parallel_builds>1</parallel_builds>
	  </dsa_options>
      <database selection="unselected">
          <name>db1</name>
          <table selection="included">
          <name>tb1</name>        
          </table>
      </database>
</dmCreate>