Teradata
使用 Teradata 连接器,您可以对 Teradata 数据库执行插入、删除、更新和读取操作。
准备工作
在使用 Teradata 连接器之前,请先完成以下任务:
- 在您的 Google Cloud 项目中:
- 将 roles/connectors.admin IAM 角色授予配置连接器的用户。
- 将以下 IAM 角色授予您要用其来使用连接器的服务账号:
roles/secretmanager.viewer
roles/secretmanager.secretAccessor
服务账号是一种特殊类型的 Google 账号,用于表示需要验证身份并获得授权以访问 Google API 数据的非人类用户。如果您没有服务账号,则必须创建一个服务账号。如需了解详情,请参阅创建服务账号。
- 启用以下服务:
secretmanager.googleapis.com
(Secret Manager API)connectors.googleapis.com
(Connectors API)
如需了解如何启用服务,请参阅启用服务。
如果之前没有为您的项目启用这些服务或权限,则在您配置连接器时,系统会提示您启用。
配置连接器
配置连接器时,您需要创建与数据源(即后端系统)的连接。一个连接需专用于一个数据源。这意味着,如果您有许多数据源,则必须为每个数据源创建单独的连接。如需创建连接,请执行以下步骤:
- 在 Cloud 控制台 中,进入 Integration Connectors > 连接页面,然后选择或创建一个 Google Cloud 项目。
- 点击 + 新建以打开创建连接页面。
- 在位置部分中,选择连接的位置。
- 区域:从下拉列表中选择一个位置。
如需查看所有受支持区域的列表,请参阅位置。
- 点击下一步。
- 区域:从下拉列表中选择一个位置。
- 在连接详情部分中,完成以下操作:
- 连接器:从可用连接器的下拉列表中选择 Teradata。
- 连接器版本:从可用版本的下拉列表中选择一个连接器版本。
- 在连接名称字段中,输入连接实例的名称。
连接名称必须符合以下条件:
- 连接名称可以使用字母、数字或连字符。
- 字母必须小写。
- 连接名称必须以字母开头,以字母或数字结尾。
- 连接名称不能超过 63 个字符。
- (可选)输入连接实例的说明。
- 服务账号:选择具有所需角色的服务账号。
- (可选)配置连接节点设置:
- 节点数下限:输入连接节点数下限。
- 节点数上限:输入连接节点数上限。
节点是处理事务的连接单元(或副本)。 连接处理越多事务就需要越多节点,相反,处理越少事务需要越少节点。 如需了解节点如何影响连接器价格,请参阅连接节点的价格。如果未输入任何值,则默认情况下,节点数下限设置为 2(以便提高可用性),节点数上限设置为 50。
- 数据库:打开 Teradata 连接时选择的默认数据库。
- 字符集:指定用于对进出 Teradata 数据库的字符数据进行编码和解码的会话字符集。默认值为 ASCII。
- (可选)点击 + 添加标签,以键值对的形式向连接添加标签。
- 点击下一步。
- 在目标部分中,输入要连接到的远程主机(后端系统)的详细信息。
- Destination Type:选择 Destination Type。
- 在主机地址字段中,指定目标的主机名或 IP 地址。
- 如果要与后端系统建立专用连接,请按以下步骤操作:
- 如果要与后端系统建立公共连接以提高安全性,您可以考虑为连接配置静态出站 IP 地址,然后将防火墙规则配置为仅将特定静态 IP 地址列入许可名单。
要输入其他目的地,请点击 + 添加目的地。
- 在主机地址字段中,指定目标的主机名或 IP 地址。
- 点击下一步。
- Destination Type:选择 Destination Type。
-
在身份验证部分中,输入身份验证详细信息。
- 选择身份验证类型,然后输入相关详细信息。
Teradata 连接支持以下身份验证类型:
- 用户名和密码
- 点击下一步。
如需了解如何配置这些身份验证类型,请参阅配置身份验证。
- 选择身份验证类型,然后输入相关详细信息。
- 查看:查看您的连接和身份验证详细信息。
- 点击创建。
配置身份验证
根据您要使用的身份验证输入详细信息。
-
用户名和密码
- 用户名:连接器的用户名
- 密码:包含与连接器关联的密码的 Secret Manager Secret。
实体、操作和动作
所有集成连接器都会为所连接应用的对象提供抽象层。您只能通过此抽象访问应用的对象。抽象作为实体、操作和动作向您展示。
- 实体:实体可以被视为连接的应用或服务中的对象或属性集合。不同连接器的实体定义也会有所不同。例如,在数据库连接器中,表是实体;在文件服务器连接器中,文件夹是实体;在消息传递系统连接器中,队列是实体。
不过,可能连接器不支持或不支持任何实体,在这种情况下,
Entities
列表将为空。 - 操作:操作是指您可以对实体执行的操作。您可以对实体执行以下任一操作:
从可用列表中选择一个实体,系统会生成该实体可用的操作列表。如需了解操作的详细说明,请参阅连接器任务的实体操作。但是,如果连接器不支持任何实体操作,则此类不受支持的操作不会列在
Operations
列表中。 - 动作:动作是可通过连接器接口提供给集成的头等函数。动作可让您对一个或多个实体进行更改,并且动作因连接器而异。但可能的情况是,连接器不支持任何动作,在这种情况下,
Actions
列表将为空。
操作
此连接器支持执行以下操作:
- 用户定义的存储过程和函数。如果您的后端中有任何存储过程和函数,这些过程和函数会列在
Configure connector task
对话框的Actions
列中。 - 自定义 SQL 查询。为了执行自定义 SQL 查询,连接器提供执行自定义查询操作。
要创建自定义查询,请按以下步骤操作:
- 按照详细说明 添加连接器任务。
- 在配置连接器任务时,在要执行的操作类型中选择操作。
- 在操作列表中,选择执行自定义查询,然后点击完成。
- 展开任务输入部分,然后执行以下操作:
- 在超时后字段中,输入查询执行之前等待的秒数。
默认值:
180
秒。 - 在最大行数字段中,输入要从数据库返回的最大行数。
默认值为
25
。 - 要更新自定义查询,请点击修改自定义查询。系统会打开脚本编辑器对话框。
- 在脚本编辑器对话框中,输入 SQL 查询,然后点击保存。
您可以在 SQL 语句中使用问号 (?) 来表示必须在查询参数列表中指定的单个参数。例如,以下 SQL 查询会选择
Employees
表中与LastName
列指定的值匹配的所有行:SELECT * FROM Employees where LastName=?
- 如果您在 SQL 查询中使用了问号,则必须针对每个问号点击 + 添加参数名称,以添加参数。在执行集成时,这些参数会按顺序替换 SQL 查询中的问号 (?)。例如,如果您添加了三个问号 (?),则必须按顺序添加三个参数。如需添加查询参数,请执行以下操作:
- 从类型列表中,选择参数的数据类型。
- 在值字段中,输入参数的值。
- 如需添加多个参数,请点击 + 添加查询参数。
- 在超时后字段中,输入查询执行之前等待的秒数。
系统限制
Teradata 连接器每秒最多可以为每个节点处理 70 个事务,并且会限制任何超出此限制的事务。默认情况下,Integration Connectors 会为连接分配 2 个节点(以提高可用性)。
如需了解适用于 Integration Connectors 的限制,请参阅限制。
支持的数据类型
以下是此连接器支持的数据类型:
- BIGINT
- BINARY
- BIT
- BOOLEAN
- CHAR
- 日期
- DECIMAL
- DOUBLE
- FLOAT
- INTEGER
- LONGN VARCHAR
- LONG VARCHAR
- NCHAR
- NUMERIC
- NVARCHAR
- REAL
- 室内
- 时间
- TIMESTAMP
- 暗含
- VARBINARY
- VARCHAR
操作
借助 Oracle 数据库连接器,您可以使用 Oracle 数据库支持的格式执行存储过程、函数和自定义 SQL 查询。为了执行自定义 SQL 查询,连接器提供 ExecuteCustomQuery
操作。
执行 CustomQuery 操作
执行此操作后,您可以执行自定义 SQL 查询。
ExecuteCustomQuery 操作的输入参数
参数名称 | 数据类型 | 需要 | 说明 |
---|---|---|---|
个查询 | 字符串 | 是 | 要执行的查询。 |
queryParameters | 采用以下格式的 JSON 数组:[{"value": "VALUE", "dataType": "DATA_TYPE"}]
|
否 | 查询参数。 |
maxRows | 数字 | 否 | 要返回的行数上限。 |
超时 | 数字 | 否 | 等待查询执行的秒数。 |
ExecuteCustomQuery 操作的输出参数
成功执行后,此操作会返回状态 200 (OK),并附带包含查询结果的响应正文。
如需查看有关如何配置 ExecuteCustomQuery
操作的示例,请参阅示例。
如需了解如何使用 ExecuteCustomQuery
操作,请参阅操作示例。
操作示例
本部分介绍如何执行该连接器中的一些操作。
示例 - 按查询执行分组
- 在
Configure connector task
对话框中,点击Actions
。 - 选择
ExecuteCustomQuery
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "query": "select E.EMPLOYEE_ID,E.EMPLOYEE_NAME,E.CITY from EMPLOYEES E LEFT JOIN EMPLOYEE_DEPARTMENT ED ON E.EMPLOYEE_ID=ED.ID where E.EMPLOYEE_NAME = 'John' Group by E.CITY,E.EMPLOYEE_ID,E.EMPLOYEE_NAME" }
此示例从 EMPLOYEES
和 EMPLOYEE_DEPARTMENT
表中选择员工记录。如果操作成功,连接器任务的 connectorOutputPayload
响应参数将包含查询结果集。
示例 - 执行参数化查询
- 在
Configure connector task
对话框中,点击Actions
。 - 选择
ExecuteCustomQuery
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "query": "select C.ID,C.NAME,C.CITY,C.O_DATE,E.EMPLOYEE_ID from customqueries C,Employees E where C.ID=E.Employee_id and C.NAME=?", "queryParameters": [{ "value": "John", "dataType": "VARCHAR" }], "timeout":10, "maxRows":3 }
此示例选择员工姓名为 John
的员工记录。请注意,员工姓名使用 queryParameters
参数进行参数化。如果操作成功,连接器任务的 connectorOutputPayload
响应参数的值将如下所示:
[{ "NAME": "John", "O_DATE": "2023-06-01 00:00:00.0", "EMPLOYEE_ID": 1.0 }, { "NAME": "John", "O_DATE": "2021-07-01 00:00:00.0", "EMPLOYEE_ID": 3.0 }, { "NAME": "John", "O_DATE": "2022-09-01 00:00:00.0", "EMPLOYEE_ID": 4.0 }]
示例 - 使用序列值插入记录
- 在
Configure connector task
对话框中,点击Actions
。 - 选择
ExecuteCustomQuery
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "query": "INSERT INTO AUTHOR(id,title) VALUES(author_table_id_seq.NEXTVAL,'Sample_book_title')" }
此示例使用现有的 author_table_id_seq
序列对象在 AUTHOR
表中插入一条记录。如果操作成功,连接器任务的 connectorOutputPayload
响应参数的值将如下所示:
[{ }]
示例 - 使用聚合函数执行查询
- 在
Configure connector task
对话框中,点击Actions
。 - 选择
ExecuteCustomQuery
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "query": "SELECT SUM(SALARY) as Total FROM EMPLOYEES" }
此示例将计算 EMPLOYEES
表中的工资汇总值。如果操作成功,连接器任务的 connectorOutputPayload
响应参数的值将如下所示:
[{ "TOTAL": 13000.0 }]
示例 - 创建新表
- 在
Configure connector task
对话框中,点击Actions
。 - 选择
ExecuteCustomQuery
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "query": "CREATE TABLE TEST1 (ID INT, NAME VARCHAR(40),DEPT VARCHAR(20),CITY VARCHAR(10))" }
此示例会创建 TEST1
表。如果操作成功,连接器任务的 connectorOutputPayload
响应参数的值将如下所示:
[{ }]
实体操作示例
示例 - 列出所有员工
以下示例列出了 Employee
实体中的所有员工。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Employee
。 - 选择
List
操作,然后点击完成。 - (可选)在连接器任务的任务输入部分,您可以通过指定 filter 子句来过滤结果集。
示例 - 获取员工详细信息
此示例从 Employee
实体获取具有指定 ID 的员工的详细信息。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Employee
。 - 选择
Get
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击 EntityId,然后在默认值字段中输入
45
。其中,
45
是Employee
实体的主键值。
示例 - 创建员工记录
此示例在 Employee
实体中添加了一条新员工记录。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Employee
。 - 选择
Create
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "EMPLOYEE_ID": 69.0, "EMPLOYEE_NAME": "John", "CITY": "Bangalore" }
如果集成成功,连接器任务的
connectorOutputPayload
字段的值将如下所示:{ "ROWID": "AAAoU0AABAAAc3hAAF" }
示例 - 更新员工记录
此示例更新了 Employee
实体中 ID 为 69 的员工记录。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Employee
。 - 选择
Update
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "EMPLOYEE_NAME": "John", "CITY": "Mumbai" }
- 点击 entityId,然后在 Default Value 字段中输入
69
。或者,您也可以不指定 entityId,而是将 filterClause 设置为
69
。如果集成成功,连接器任务的
connectorOutputPayload
字段的值将如下所示:{ }
示例 - 删除员工记录
此示例将删除 Employee
实体中指定 ID 的员工记录。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Employee
。 - 选择
Delete
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击 entityId,然后在默认值字段中输入
35
。
使用 Terraform 创建连接
您可以使用 Terraform 资源创建新连接。如需了解如何应用或移除 Terraform 配置,请参阅基本 Terraform 命令。
如需查看用于创建连接的示例 Terraform 模板,请参阅示例模板。
使用 Terraform 创建此连接时,您必须在 Terraform 配置文件中设置以下变量:
参数名称 | 数据类型 | 需要 | 说明 |
---|---|---|---|
client_charset | STRING | True | 指定 Java 字符集,用于对传入和传出 Teradata 数据库的字符数据进行编码和解码。 |
数据库 | STRING | True | 打开 Teradata 连接时选择为默认数据库的数据库。 |
账号 | STRING | False | 指定一个帐号字符串,以替换为 Teradata 数据库用户定义的默认帐号字符串。 |
字符集 | STRING | True | 指定用于对传入和传出 Teradata 数据库的字符数据进行编码和解码的会话字符集。默认值为 ASCII。 |
column_name | INTEGER | True | 控制 ResultSetMetaData getColumnName 和 getColumnLabel 方法的行为。 |
connect_failure_ttl | STRING | False | 此选项使适用于 Teradata 的 CData ADO.NET 提供程序记住每个 IP 地址/端口组合的上次连接失败时间。此外,在后续登录期间,Teradata 的 CData ADO.NET 提供程序会在连接失败存留时间 (CONNECTFAILURETTL) 值指定的秒数内跳过与该 IP 地址/端口的连接尝试。 |
connect_function | STRING | False | 指定 Teradata 数据库应为此会话分配登录序列号 (LSN),还是将此会话与现有 LSN 关联。 |
警察 | STRING | False | 指定是否执行 COP 发现。 |
cop_last | STRING | False | 指定 COP Discovery 如何确定最后一个 COP 主机名。 |
数字统计信息 | ENUM | False | 指定 DDSTATS 的值。支持的值包括:ON、OFF |
disable_auto_commit_in_batch | BOOLEAN | True | 指定执行批量操作时是否停用自动提交。 |
encrypt_data | ENUM | False | 指定 EncryptData 值(ON 或 OFF)。支持的值包括:ON、OFF |
error_query_count | STRING | False | 指定在执行 JDBC FastLoad 操作后,JDBC FastLoad 尝试查询 FastLoad 错误表 1 的最大次数。 |
error_query_interval | STRING | False | 指定在一次 JDBC FastLoad 操作之后,JDBC FastLoad 在尝试查询 FastLoad 错误表 1 之间等待的毫秒数。 |
error_table1_suffix | STRING | False | 为 JDBC FastLoad 和 JDBC FastLoad CSV 创建的 FastLoad 错误表 1 的名称指定后缀。 |
error_table2_suffix | STRING | False | 为 JDBC FastLoad 和 JDBC FastLoad CSV 创建的 FastLoad 错误表 2 的名称指定后缀。 |
error_table_database | STRING | False | 指定 JDBC FastLoad 和 JDBC FastLoad CSV 创建的 FastLoad 错误表的数据库名称。 |
field_sep | STRING | False | 指定仅用于 JDBC FastLoad CSV 的字段分隔符。默认分隔符为“,”(英文逗号)。 |
finalize_auto_close | STRING | False | 将“FinalizeAutoClose”的值指定为“开启”或“关闭”。 |
geturl_credentials | STRING | False | 将 GeturlCredentials 的值指定为“ON”或“OFF”。 |
治理 | STRING | False | 指定 GOVERN、ON 或 OFF 的值。 |
literal_underscore | STRING | False | 在 DatabaseMetaData 调用中自动转义 LIKE 谓词模式,例如 schemPattern 和 tableNamePattern。 |
lob_support | STRING | False | 将 LobSupport 的值指定为“ON”或“OFF”。 |
lob_temp_table | STRING | False | 指定包含以下列的表名称:ID 整数、bval blob、cval clob。 |
日志 | STRING | False | 指定连接的日志记录级别(详细程度)。日志记录始终启用。日志记录级别按照简明到详细的顺序列出。 |
log_data | STRING | False | 指定登录机制所需的其他数据,例如安全令牌、标识名或域/域名称。 |
log_mech | STRING | False | 指定登录机制,用于确定连接的身份验证和加密功能。 |
logon_sequence_number | STRING | False | 指定与此会话关联的现有登录序列号 (LSN)。 |
max_message_body | STRING | False | 指定响应消息的大小上限(以字节为单位)。 |
maybe_null | STRING | False | 控制 ResultSetMetaData.isNullable 方法的行为。 |
new_password | STRING | False | 此连接参数可让应用自动更改过期的密码。 |
partition | STRING | False | 为 Connection 指定 Teradata Database 分区。 |
prep_support | STRING | False | 指定在创建 PreparedStatement 或 CallableStatement 时 Teradata 数据库是否执行 prepare 操作。 |
reconnect_count | STRING | False | 启用 Teradata 会话重新连接。指定 Teradata JDBC 驱动程序将尝试重新连接会话的最大次数。 |
reconnect_interval | STRING | False | 启用 Teradata 会话重新连接。指定 Teradata JDBC 驱动程序在尝试重新连接会话之间等待的秒数。 |
重新驾车 | STRING | False | 启用 Teradata 会话重新连接,以及自动重新分配因数据库重启而中断的 SQL 请求。 |
run_startup | STRING | False | 将 RunStartup 的值指定为 ON 或 OFF。 |
会话 | STRING | False | 指定要创建的 FastLoad 或 FastExport 连接的数量,其中 1 <= FastLoad 或 FastExport 连接的数量 <= AMP 的数量。 |
sip_support | STRING | False | 控制 Teradata 数据库和 Teradata JDBC 驱动程序是否使用 StatementInfo Parcel (SIP) 来传递元数据。 |
slob_receive_threshold | STRING | False | 控制从 Teradata 数据库接收小型 LOB 值的方式。在应用明确从 Blob/Clob 对象中读取数据之前,从 Teradata 数据库预提取小 LOB 值。 |
slob_transmit_threshold | STRING | False | 控制将小型 LOB 值传输到 Teradata 数据库的方式。 |
sp_spl | STRING | False | 指定创建或替换 Teradata 存储过程的行为。 |
strict_encode | STRING | False | 指定对字符数据进行编码以传输到 Teradata 数据库的行为。 |
Tmode | STRING | False | 指定连接的事务模式。 |
Tnano | STRING | False | 指定绑定到 PreparedStatement 或 CallableStatement 并作为 TIME 或 TIME WITH TIME ZONE 值传输到 Teradata 数据库的所有 java.sql.Time 值的小数秒精度。 |
Tsnano | STRING | False | 指定绑定到 PreparedStatement 或 CallableStatement 并作为 TIMESTAMP 或 TIMESTAMP WITH TIME ZONE 值传输到 Teradata 数据库的所有 java.sql.Timestamp 值的小数秒精度。 |
tcp | STRING | False | 指定一项或多项 TCP 套接字设置,以加号 () 分隔。 |
trusted_sql | STRING | False | 指定 TrustedSql 的值。 |
类型 | STRING | False | 指定与用于 SQL 语句的 Teradata Database 配合使用的协议类型。 |
upper_case_identifiers | BOOLEAN | False | 此媒体资源以大写形式报告所有标识符。这是 Oracle 数据库的默认设置,因此可以更好地与 Oracle 工具(如 Oracle 数据库网关)集成。 |
use_xviews | STRING | False | 指定应查询哪些数据字典视图以从 DatabaseMetaData 方法返回结果集。 |
在集成中使用 Teradata 连接
创建连接后,它在 Apigee Integration 和 Application Integration 中均可使用。您可以通过连接器任务在集成中使用该连接。
- 如需了解如何在 Apigee Integration 中创建和使用连接器任务,请参阅连接器任务。
- 如需了解如何在 Application Integration 中创建和使用连接器任务,请参阅连接器任务。
向 Google Cloud 社区寻求帮助
您可以在 Cloud 论坛的 Google Cloud 社区发布您的问题并讨论此连接器。后续步骤
- 了解如何暂停和恢复连接。
- 了解如何监控连接器的使用情况。
- 了解如何查看连接器日志。