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
Copy file name to clipboardExpand all lines: articles/data-factory/connector-oracle.md
+35-35Lines changed: 35 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -97,20 +97,12 @@ The Oracle linked service supports the following properties when apply version 2
97
97
|:--- |:--- |:--- |
98
98
| type | The type property must be set to **Oracle**. | Yes |
99
99
| version | The version that you specify. The value is `2.0`. | Yes |
100
-
| server | The location of Oracle database you want to connect to. | Yes |
100
+
| server | The location of Oracle database you want to connect to. You can refer to [server property configuration](#server-property-configuration) to specify it. | Yes |
101
101
| authenticationType | Authentication type for connecting to the Oracle database. Only **Basic** auth is supported now. | Yes |
102
102
| username | The Oracle database username. | Yes |
103
103
| password | The Oracle database password. | Yes |
104
104
| 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, the default Azure Integration Runtime is used. |No |
105
105
106
-
For `server` property, you can specify it in one of the following three ways:
|[Oracle Net Services Name (TNS Alias)](https://docs.oracle.com/en/database/oracle/oracle-database/23/netrf/local-naming-parameters-in-tns-ora-file.html#GUID-12C94B15-2CE1-4B98-9D0C-8226A9DDF4CB) (only for the self-hosted integration runtime)|sales|
113
-
114
106
More connection properties you can set in linked service per your case:
115
107
116
108
| Property | Description | Required | Default value |
@@ -127,6 +119,37 @@ More connection properties you can set in linked service per your case:
127
119
| supportV1DataTypes | Specifies whether to use the version 1.0 data type mappings. Do not set this to true unless you want to keep backward compatibility with version 1.0's data type mappings. Type: boolean | No, this property is for backward compatibility use only | false |
128
120
| fetchTswtzAsTimestamp | Specifies whether the driver returns column value with the TIMESTAMP WITH TIME ZONE data type as DateTime or string. This setting is ignored if supportV1DataTypes is not true. Type: boolean | No, this property is for backward compatibility use only | true |
129
121
122
+
#### `server` property configuration
123
+
124
+
For `server` property, you can specify it in one of the following three formats:
|[Oracle Net Services Name (TNS Alias)](https://docs.oracle.com/en/database/oracle/oracle-database/23/netrf/local-naming-parameters-in-tns-ora-file.html#GUID-12C94B15-2CE1-4B98-9D0C-8226A9DDF4CB) (only for the self-hosted integration runtime)|sales|
131
+
132
+
The location of Oracle database you want to connect to. There are three ways to specify it and you can check the details after tables.
133
+
134
+
| Property |Description | Sample |
135
+
|:--- |:--- |:--- |
136
+
|***Connect Required***|||
137
+
| HOST | The host name or IP address used to connect to the Oracle database. | sales-svr |
138
+
| PORT | The server port for the Oracle database. | 1521 |
139
+
| PROTOCOL | The transport protocol to be used while connecting to the Oracle database. | tcp |
140
+
| SERVICE_NAME | Specifies the logical representation of a database. | sales.us.example.com |
141
+
| SID | Specifies the name that identifies a specific instance of an Oracle database. | sales |
142
+
| INSTANCE_NAME | Specifies the database instance to access. | sales1 |
143
+
| SERVER | Specifies type of service handler. | dedicated |
144
+
|***Match Version 1.0***|||
145
+
| CONNECT_TIMEOUT | Specifies the amount of time, in milliseconds, seconds, or minutes, in which clients must establish Oracle Net connections to database instances. | 10ms |
146
+
| RETRY_COUNT | Specifies the number of times to connect before terminating the connection attempt. | 3 |
147
+
| RETRY_DELAY | Specifies the delay between connection retries. | 5 |
148
+
| SSL_VERSION | Define valid Transport Layer Security (TLS) versions to be used for connections. | TLSv1.3 |
149
+
|***Most Secure Behavior***|||
150
+
| SSL_SERVER_DN_MATCH | Enforce server-side certificate validation through distinguished name (DN) matching. | TRUE |
151
+
| SSL_SERVER_CERT_DN | Specifies the distinguished name (DN) of the database server. | cn=finance,cn=OracleContext,c=us,o=example |
152
+
130
153
**Example:**
131
154
132
155
```json
@@ -482,15 +505,15 @@ When you copy data from and to Oracle, the following interim data type mappings
482
505
| CLOB |String |String |
483
506
| DATE |DateTime |DateTime |
484
507
| FLOAT (P < 16) | Double | Double |
485
-
| FLOAT (P >= 16) |IBigDecimal| Double |
508
+
| FLOAT (P >= 16) |Decimal| Double |
486
509
| INTERVAL YEAR TO MONTH |Int64 |String |
487
510
| INTERVAL DAY TO SECOND |TimeSpan |String |
488
511
| LONG |String |String |
489
512
| LONG RAW |Byte[]|Byte[]|
490
513
| NCHAR |String |String |
491
514
| NCLOB |String |String |
492
-
| NUMBER (p,s) |Int16, Int32, Int64, Double, Single, IBigDecimal|Decimal, String (if p > 28) |
493
-
| NUMBER without precision and scale |IBigDecimal|Double |
515
+
| NUMBER (p,s) |Int16, Int32, Int64, Double, Single, Decimal|Decimal, String (if p > 28) |
516
+
| NUMBER without precision and scale |Decimal|Double |
494
517
| NVARCHAR2 |String |String |
495
518
| RAW |Byte[]|Byte[]|
496
519
| TIMESTAMP |DateTime |DateTime |
@@ -506,29 +529,6 @@ When you copy data from and to Oracle, the following interim data type mappings
506
529
507
530
To learn details about the properties, check [Lookup activity](control-flow-lookup-activity.md).
508
531
509
-
## Security
510
-
511
-
To avoid the security risks in the server properties, you can refer to an allow list to configure which properties in the server can be set. The allow list includes the following properties.
512
-
513
-
| Property |Description | Sample |
514
-
|:--- |:--- |:--- |
515
-
|***Connect Required***|||
516
-
| HOST | The host name or IP address used to connect to the Oracle database. | sales-svr |
517
-
| PORT | The server port for the Oracle database. | 1521 |
518
-
| PROTOCOL | The transport protocol to be used while connecting to the Oracle database. | tcp |
519
-
| SERVICE_NAME | Specifies the logical representation of a database. | sales.us.example.com |
520
-
| SID | Specifies the name that identifies a specific instance of an Oracle database. | sales |
521
-
| INSTANCE_NAME | Specifies the database instance to access. | sales1 |
522
-
| SERVER | Specifies type of service handler. | dedicated |
523
-
|***Match Version 1.0***|||
524
-
| CONNECT_TIMEOUT | Specifies the amount of time, in milliseconds, seconds, or minutes, in which clients must establish Oracle Net connections to database instances. | 10ms |
525
-
| RETRY_COUNT | Specifies the number of times to connect before terminating the connection attempt. | 3 |
526
-
| RETRY_DELAY | Specifies the delay between connection retries. | 5 |
527
-
| SSL_VERSION | Define valid Transport Layer Security (TLS) versions to be used for connections. | TLSv1.3 |
528
-
|***Most Secure Behavior***|||
529
-
| SSL_SERVER_DN_MATCH | Enforce server-side certificate validation through distinguished name (DN) matching. | TRUE |
530
-
| SSL_SERVER_CERT_DN | Specifies the distinguished name (DN) of the database server. | cn=finance,cn=OracleContext,c=us,o=example |
531
-
532
532
## Upgrade the Oracle connector
533
533
534
534
Here are steps that help you upgrade the Oracle connector:
0 commit comments