16.20 - create (Teradata Database) - Teradata Data Mover

Teradata® Data Mover 用户指南

Product
Teradata Data Mover
Release Number
16.20
Published
2021 年 11 月
Content Type
用户指南
Publication ID
B035-4101-107K-CHS
Language
中文 (简体)

用途

create 命令使用语法参数和对象列表在守护程序上创建一个作业。作业定义由参数和对象列表组成。

参数

请参阅参数顺序

additional_arc_parameters
[可选] 指定要在执行每个 ARC 任务时附加的额外 ARC 参数。限制为 2048 个字符。
示例: VBMASK=15
broker.port
[可选] 可输入代理程序端口覆盖 commandline.properties 文件中指定的缺省值,以便在运行时连接到不同的 ActiveMQ 服务器(进而可连接到不同的守护程序)。
示例: 61616
broker.url
[可选] 可输入代理程序 URL 覆盖 commandline.properties 文件中指定的缺省值,以便在运行时连接到不同的 ActiveMQ 服务器(进而可连接到不同的守护程序)。
示例: dm-server1
data_streams
[可选] 可在源数据库和目标数据库之间使用的数据流数量。适用于使用 Teradata ARC、Teradata DSA 和 TPT API(与 Teradata 之间)的作业。所有其他协议均使用单个数据流。
示例: 4
缺省值由 Data Mover 动态计算。
db_client_encryption
[可选] 数据传输期间需要加密作业时设置为 true
execute_permission
[可选] 定义对已创建的作业具有执行权限的用户名和角色。
force_utility
[可选] 强制 Data Mover 守护程序使用特定实用程序执行所有复制操作。

有效值

  • arc
  • dsa
  • jdbc
  • tptapi
  • tptapi_load
  • tptapi_stream
  • tptapi_update
  • T2T
如果未指定此值,则 Data Mover 守护程序将确定最适合该作业的 Teradata 实用程序。
使用 Teradata ARC 或 Teradata DSA 将数据复制到旧版 Teradata Database 是无效的。如果源 TDPID 和目标 TDPID 相同,则不能使用 Teradata ARC 或 Teradata DSA。
示例: arc
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
[可选] 指定要用于此作业的事件表。有关详细信息,请参阅使用事件表
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 ARC 或 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 ARC 或 Teradata DSA 作业不支持登录机制。请仅对 Teradata PT API 和 Teradata JDBC 作业使用登录机制。如果指定了 -source_logon_mechanism,而未使用 -force_utility,则缺省情况下会使用 Teradata PT API。如果已为 -force_utility 指定 Teradata ARC 或 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 ARC 和 Teradata DSA 不支持登录机制。请仅对 Teradata PT API 和 Teradata JDBC 作业使用登录机制。如果指定了 -target_logon_mechanism,而未使用 -force_utility,则缺省情况下会使用 Teradata PT API。如果已为 -force_utility 指定 Teradata ARC 和 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 parameters.xml 可创建作业。当 create 命令完成时,将会在屏幕上显示作业名称。请记住此作业名称以在其他命令中使用,例如 stopstart 命令。

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>arc</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>