You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -75,7 +75,68 @@ The following sections provide details about properties that are used to define
75
75
76
76
## Linked service properties
77
77
78
-
The Teradata linked service supports the following properties:
78
+
The Teradata connector now supports 2.0 version. Refer to this [section](#upgrade-the-teradata-connector) to upgrade your Azure SQL Database connector version from 1.0 version. For the property details, see the corresponding sections.
79
+
80
+
-[2.0 version](#20-version)
81
+
-[1.0 version](#10-version)
82
+
83
+
### 2.0 version
84
+
85
+
The Teradata linked service 2.0 version supports the following properties:
86
+
87
+
| Property | Description | Required |
88
+
|:--- |:--- |:--- |
89
+
| type | The type property must be set to **Teradata**. | Yes |
90
+
| version | The version that you specify. The value is `2.0`. | Yes |
91
+
| server | The Teradata server name. | Yes |
92
+
| authenticationType | The authentication type to connect to Teradata. Valid values including **Basic**, **Windows**, and **LDAP**| Yes |
93
+
| username | Specify a user name to connect to Teradata. | Yes |
94
+
| password | Specify a password for the user account you specified for the user name. You can also choose to [reference a secret stored in Azure Key Vault](store-credentials-in-key-vault.md). | Yes |
95
+
| connectVia | The [Integration Runtime](concepts-integration-runtime.md) to be used to connect to the data store. Learn more from [Prerequisites](#prerequisites) section. If not specified, it uses the default Azure Integration Runtime. |No |
96
+
97
+
More connection properties you can set in connection string per your case:
98
+
99
+
| Property | Description | Default value |
100
+
|:--- |:--- |:--- |
101
+
| sslMode | The SSL mode for connections to the database. Valid values including `Disable`, `Allow`, `Prefer`, `Require`, `Verify-CA`, `Verify-Full`. |`Verify-Full`|
102
+
| portNumber |The port numbers when connecting to server through non-HTTPS/TLS connections. | 1025|
103
+
| httpsPortNumber |The port numbers when connecting to server through HTTPS/TLS connections. |443 |
104
+
| UseDataEncryption | Specifies whether to encrypt all communication with the Teradata database. Allowed values are 0 or 1.<br><br/>- **0 (disabled, default)**: Encrypts authentication information only.<br/>- **1 (enabled)**: Encrypts all data that is passed between the driver and the database. This setting is ignored for HTTPS/TLS connections.|`1`|
105
+
| CharacterSet | The character set to use for the session. For example, `CharacterSet=UTF16`.<br><br/>This value can be a user-defined character set, or one of the following predefined character sets: <br/>- ASCII<br/>- ARABIC1256_6A0<br/>- CYRILLIC1251_2A0<br/>- HANGUL949_7R0<br/>- HEBREW1255_5A0<br/>- KANJI932_1S0<br/>- KANJISJIS_0S<br/>- LATIN1250_1A0<br/>- LATIN1252_3A0<br/>- LATIN1254_7A0<br/>- LATIN1258_8A0<br/>- CHINESE936_6R0<br/>- TCHINESE950_8R0<br/>- THAI874_4A0<br/>- UTF8<br/>- UTF16 |`ASCII`|
106
+
| MaxRespSize |The maximum size of the response buffer for SQL requests, in bytes. For example, `MaxRespSize=10485760`.<br/><br/>Range of permissible values are from `4096` to `16775168`. The default value is `524288`. |`524288`|
107
+
| sslCrc |Controls the behavior of the connection depending on the result of the certificate revocation check. This setting is ignored when sslMode is not `Verify-Full`. Valid values including **Allow** and **Require**<br/>- **Allow**: The connection is established if the certificate revocation status is not Revoked. The connection is not terminated if the revocation status cannot be determined or is anything other than Revoked.<br/>- **Require**: The connection is established only if the revocation status is Good, otherwise it is terminated. |`Allow`|
108
+
| sslCRCTimeout |Sets the maximum amount of time to be spent during the retrieval of OCSP response or certificate revocation list (CRL). A value of zero means no limits. This setting is ignored when sslMode is not `Verify-Full`. |`10`|
109
+
| commandTimeout |The amount of time in seconds that the Data Provider waits for a response from Teradata. If the request is not processed within the specified commandTimeout, the request is aborted and the transaction is rolled back. A zero value indicates that the Data Provider should wait indefinitely for the SQL statement to execute. |`30`|
110
+
| connectionTimeout |Represents the time to wait for establishment of a connection before terminating the attempt and generating an error. |`60`|
111
+
| queryBand |This property is used to define Query Bands at the connection level. It should be in below format: `key1=value1; key2=value2; keyn=valuen;`. For more information, see this [article](https://teradata-docs.s3.amazonaws.com/doc/connectivity/tdnetdp/20.00/help/QueryBandReserved.html). | N/A |
112
+
| dataBase |The database selected as the default database when a Teradata connection is opened. | N/A |
113
+
| restrictToDefaultDatabase |Indicates whether schema queries should be restricted to the default database. Allowed values are 0 or 1. 0 for false, and 1 for true. |`0`|
114
+
| useXViews |Whether all schema queries return only user owned data. |N/A |
115
+
116
+
**Example**
117
+
118
+
```json
119
+
{
120
+
"name": "TeradataLinkedService",
121
+
"properties": {
122
+
"type": "Teradata",
123
+
"version": "2.0",
124
+
"typeProperties": {
125
+
"server": "<server name>",
126
+
"username": "<user name>",
127
+
"password": "<password>",
128
+
"authenticationType": "<authentication type>"
129
+
},
130
+
"connectVia": {
131
+
"referenceName": "<name of Integration Runtime>",
132
+
"type": "IntegrationRuntimeReference"
133
+
}
134
+
}
135
+
}
136
+
```
137
+
### 1.0 version
138
+
139
+
The Teradata linked service 1.0 version supports the following properties:
79
140
80
141
| Property | Description | Required |
81
142
|:--- |:--- |:--- |
@@ -333,53 +394,61 @@ You are suggested to enable parallel copy with data partitioning especially when
333
394
334
395
When you copy data from Teradata, the following mappings apply from Teradata's data types to the internal data types used by the service. To learn about how the copy activity maps the source schema and data type to the sink, see [Schema and data type mappings](copy-activity-schema-and-type-mapping.md).
335
396
336
-
| Teradata data type | Interim service data type |
| Xml | String |Not supported. Apply explicit cast in source query. |
377
438
378
439
379
440
## Lookup activity properties
380
441
381
442
To learn details about the properties, check [Lookup activity](control-flow-lookup-activity.md).
382
443
444
+
## Upgrade the Teradata connector
445
+
446
+
Here are steps that help you upgrade the Teradata connector:
447
+
448
+
1. In **Edit linked service** page, select **2.0 (Preview)** under **Version** and configure the linked service by referring to [linked service 2.0 version properties](#20-version).
449
+
450
+
2. The data type mapping for the Teradata linked service 2.0 version is different from that for the 1.0 version. To learn the latest data type mapping, see [Data type mapping for Teradata](#data-type-mapping-for-teradata).
451
+
383
452
384
453
## Related content
385
454
For a list of data stores supported as sources and sinks by the copy activity, see [Supported data stores](copy-activity-overview.md#supported-data-stores-and-formats).
0 commit comments