Skip to content

Commit a5ee7b3

Browse files
Clare Zheng (Shanghai Wicresoft Co Ltd)Clare Zheng (Shanghai Wicresoft Co Ltd)
authored andcommitted
Update Oracle GA and upgrade doc
1 parent 0449aff commit a5ee7b3

File tree

3 files changed

+44
-34
lines changed

3 files changed

+44
-34
lines changed

articles/data-factory/connector-deprecation-plan.md

Lines changed: 21 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.service: azure-data-factory
77
ms.subservice: data-movement
88
ms.topic: concept-article
99
ms.custom: references_regions
10-
ms.date: 04/14/2025
10+
ms.date: 04/24/2025
1111
---
1212

1313
# Upgrade plan for Azure Data Factory connectors
@@ -27,15 +27,15 @@ This article describes future upgrades for some connectors of Azure Data Factory
2727
| [Greenplum (version 1.0)](connector-greenplum.md)  | [Link](connector-greenplum.md#upgrade-the-greenplum-connector) |Preview version available | To be determined | /|
2828
| [MariaDB (version 1.0)](connector-mariadb.md)  | [Link](connector-mariadb.md#upgrade-the-mariadb-driver-version) | End of support and GA version available | October 31, 2024 | September 30, 2025|
2929
| [MySQL (version 1.0)](connector-mysql.md)  | [Link](connector-mysql.md#upgrade-the-mysql-driver-version) |End of support and GA version available | October 31, 2024| September 30, 2025|
30-
| [Oracle (version 1.0)](connector-oracle.md) |[Link](connector-oracle.md#upgrade-the-oracle-connector) | Preview version available | To be determined| / |
31-
| [Salesforce (V1)](connector-salesforce-legacy.md)   | [Link](connector-salesforce.md#upgrade-the-salesforce-linked-service) | GA version available | To be determined | /|
32-
| [Salesforce Service Cloud (V1)](connector-salesforce-service-cloud-legacy.md)   | [Link](connector-salesforce-service-cloud.md#upgrade-the-salesforce-service-cloud-linked-service) | GA version available | To be determined |/ |
30+
| [Oracle (version 1.0)](connector-oracle.md) |[Link](connector-oracle.md#upgrade-the-oracle-connector) | GA version available | August 31, 2025| December 31, 2025 |
3331
| [PostgreSQL (V1)](connector-postgresql-legacy.md)   | [Link](connector-postgresql.md#upgrade-the-postgresql-linked-service)| End of support and GA version available |October 31, 2024 | September 30, 2025|
3432
| [Presto (version 1.0)](connector-presto.md)   | [Link](connector-presto.md#upgrade-the-presto-connector)| Preview version available |To be determined | / |
33+
| [Salesforce (V1)](connector-salesforce-legacy.md)   | [Link](connector-salesforce.md#upgrade-the-salesforce-linked-service) | GA version available | To be determined | /|
34+
| [Salesforce Service Cloud (V1)](connector-salesforce-service-cloud-legacy.md)   | [Link](connector-salesforce-service-cloud.md#upgrade-the-salesforce-service-cloud-linked-service) | GA version available | To be determined |/ |
3535
| [ServiceNow (V1)](connector-servicenow-legacy.md)   | [Link](connector-servicenow.md#upgrade-your-servicenow-linked-service) | GA version available | To be determined | / |
3636
| [Snowflake (V1)](connector-snowflake-legacy.md)   | [Link](connector-snowflake.md#upgrade-the-snowflake-linked-service) | GA version available | To be determined | / |
3737
| [Spark (version 1.0)](connector-spark.md)   | [Link](connector-spark.md#upgrade-the-spark-connector)| Preview version available |To be determined | / |
38-
| [Vertica (version 1.0)](connector-vertica.md)| [Link](connector-vertica.md#upgrade-the-vertica-version) | GA version available | July 31, 2025 | / |
38+
| [Vertica (version 1.0)](connector-vertica.md)| [Link](connector-vertica.md#upgrade-the-vertica-version) | GA version available | July 31, 2025 | September 30, 2025 |
3939
| [Azure Database for MariaDB](connector-azure-database-for-mariadb.md) |/ | End of support |December 31, 2024 | December 31, 2024 |
4040
| [Concur (Preview)](connector-concur.md) |/ | End of support | December 31, 2024 | December 31, 2024 |
4141
| [Couchbase (Preview)](connector-couchbase.md) |/ | End of support | December 31, 2024 | December 31, 2024 |
@@ -52,7 +52,7 @@ This article describes future upgrades for some connectors of Azure Data Factory
5252
| [Zoho (Preview)](connector-zoho.md) |/ | End of support | December 31, 2024 | December 31, 2024 |
5353
| [Amazon Marketplace Web Service](connector-amazon-marketplace-web-service.md)|/ | Disabled |/ |/ |
5454

55-
If you need upgrade help, contact us via the way provided in the [FAQ article](connector-deprecation-frequently-asked-questions.md#what-should-i-do-if-i-encounter-the-feature-gaps-and-errors-bugs-that-are-preventing-me-from-migrating-to-the-new-connectors). 
55+
If you encounter any gaps while upgrading your connector to the latest version, please contact for help via the way provided in the [FAQ article](connector-deprecation-frequently-asked-questions.md#what-should-i-do-if-i-encounter-the-feature-gaps-and-errors-bugs-that-are-preventing-me-from-migrating-to-the-new-connectors). 
5656

5757
## Release stages and support
5858

@@ -110,13 +110,10 @@ The following connectors are at End of Support stage. You should migrate to [alt
110110
- [Salesforce Marketing Cloud](connector-salesforce-marketing-cloud.md)
111111
- [Zoho (Preview)](connector-zoho.md)
112112

113-
114-
## Connectors that are deprecated
115-
116-
The following connector was deprecated.
117-
113+
The following connector is at End of Support stage.
118114
- [Amazon Marketplace Web Service](connector-amazon-marketplace-web-service.md)
119115

116+
120117
## Options to replace deprecated connectors
121118

122119
If V1 connectors are deprecated with no updated connectors available, you can still use the
@@ -134,6 +131,19 @@ Here's the steps to get your objects which still rely on the deprecated connecto
134131

135132
:::image type="content" source="media/connector-deprecation-plan/linked-services-page.png" alt-text="Screenshot of the linked services page." lightbox="media/connector-deprecation-plan/linked-services-page.png":::
136133

134+
## How to find notifications in Azure Service Health portal
135+
136+
Regular notifications are sent to you to help you upgrade related connectors, or notify you the connectors' End of Support or disabled dates. You can find the notification under Service Health portal - Health advisories tab.
137+
138+
Here's the steps to help you find the notification:
139+
140+
1. Navigate to [Service Health protal](https://portal.azure.com/#view/Microsoft_Azure_Health/AzureHealthBrowseBlade/%7E/serviceIssues) or you can select **Service Health** icon on your Azure portal dashboard.
141+
1. Go to **Health advisories** tab and you can see the notification related to your connectors in the list. You can also go to **Health history** tab to check historical notifications.
142+
143+
:::image type="content" source="media/connector-deprecation-plan/service-health-health-advisories.png" alt-text="Screenshot of service health.":::
144+
145+
To learn more about the Service Health portal, see this [article](/azure/service-health/service-health-overview).
146+
137147
## Related content
138148

139149
- [Azure Data Factory connectors overview](connector-overview.md)

articles/data-factory/connector-oracle.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: jianleishen
66
ms.subservice: data-movement
77
ms.custom: synapse
88
ms.topic: conceptual
9-
ms.date: 03/20/2025
9+
ms.date: 04/23/2025
1010
ms.author: jianleishen
1111
---
1212

@@ -32,7 +32,7 @@ For a list of data stores that are supported as sources or sinks by the copy act
3232

3333
Specifically, this Oracle connector supports:
3434

35-
- The following versions of an Oracle database for version 2.0 (Preview):
35+
- The following versions of an Oracle database for version 2.0:
3636
- Oracle Database 19c or later
3737
- The following versions of an Oracle database for version 1.0:
3838
- Oracle 19c R1 (19.1) and higher
@@ -86,14 +86,14 @@ The following sections provide details about properties that are used to define
8686

8787
## Linked service properties
8888

89-
The Oracle connector version 2.0 (Preview) supports TLS 1.3. Refer to this [section](#upgrade-the-oracle-connector) to upgrade your Oracle connector version from version 1.0. For the property details, see the corresponding sections.
89+
The Oracle connector version 2.0 supports TLS 1.3. Refer to this [section](#upgrade-the-oracle-connector) to upgrade your Oracle connector version from version 1.0. For the property details, see the corresponding sections.
9090

91-
- [Version 2.0 (Preview)](#version-20-preview)
91+
- [Version 2.0](#version-20)
9292
- [Version 1.0](#version-10)
9393

94-
### Version 2.0 (Preview)
94+
### Version 2.0
9595

96-
The Oracle linked service supports the following properties when apply version 2.0 (Preview):
96+
The Oracle linked service supports the following properties when apply version 2.0:
9797

9898
| Property | Description | Required |
9999
|:--- |:--- |:--- |
@@ -348,7 +348,7 @@ To copy data from Oracle, set the source type in the copy activity to `OracleSou
348348
|:--- |:--- |:--- |
349349
| type | The type property of the copy activity source must be set to `OracleSource`. | Yes |
350350
| oracleReaderQuery | Use the custom SQL query to read data. An example is `"SELECT * FROM MyTable"`.<br>When you enable partitioned load, you need to hook any corresponding built-in partition parameters in your query. For examples, see the [Parallel copy from Oracle](#parallel-copy-from-oracle) section. | No |
351-
| convertDecimalToInteger | Oracle NUMBER type with zero or unspecified scale will be converted to corresponding integer. Allowed values are **true** and **false** (default). <br>If you are using Oracle version 2.0 (Preview), this property will only be allowed to be set when supportV1DataTypes is true. | No |
351+
| convertDecimalToInteger | Oracle NUMBER type with zero or unspecified scale will be converted to corresponding integer. Allowed values are **true** and **false** (default). <br>If you are using Oracle version 2.0, this property will only be allowed to be set when supportV1DataTypes is true. | No |
352352
| partitionOptions | Specifies the data partitioning options used to load data from Oracle. <br>Allowed values are: **None** (default), **PhysicalPartitionsOfTable**, and **DynamicRange**.<br>When a partition option is enabled (that is, not `None`), the degree of parallelism to concurrently load data from an Oracle database is controlled by the [`parallelCopies`](copy-activity-performance-features.md#parallel-copy) setting on the copy activity. | No |
353353
| partitionSettings | Specify the group of the settings for data partitioning. <br>Apply when the partition option isn't `None`. | No |
354354
| partitionNames | The list of physical partitions that needs to be copied. <br>Apply when the partition option is `PhysicalPartitionsOfTable`. If you use a query to retrieve the source data, hook `?AdfTabularPartitionName` in the WHERE clause. For an example, see the [Parallel copy from Oracle](#parallel-copy-from-oracle) section. | No |
@@ -487,7 +487,7 @@ You are suggested to enable parallel copy with data partitioning especially when
487487

488488
When you copy data from and to Oracle, the following interim data type mappings are used within 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).
489489

490-
| Oracle data type | Interim service data type (for version 2.0 (Preview)) | Interim service data type (for version 1.0) |
490+
| Oracle data type | Interim service data type (for version 2.0) | Interim service data type (for version 1.0) |
491491
|:--- |:--- |:--- |
492492
| BFILE |Byte[] | Byte[] |
493493
| BINARY_FLOAT | Single | Single |
@@ -525,9 +525,9 @@ To learn details about the properties, check [Lookup activity](control-flow-look
525525

526526
Here are steps that help you upgrade the Oracle connector:
527527

528-
1. In **Edit linked service** page, select **2.0 (Preview)** under **Version** and configure the linked service by referring to [Linked service properties version 2.0 (Preview)](#version-20-preview).
528+
1. In **Edit linked service** page, select **2.0** under **Version** and configure the linked service by referring to [Linked service properties version 2.0](#version-20).
529529

530-
For the authentication related properties including username and password, specify the original values in the corresponding fields in version 2.0 (Preview). Other connection properties such as host, port, and Oracle Service Name/Oracle SID in version 1.0 are now parameters of the [`server` property in version 2.0 (Preview)](#server-property-configuration).
530+
For the authentication related properties including username and password, specify the original values in the corresponding fields in version 2.0. Other connection properties such as host, port, and Oracle Service Name/Oracle SID in version 1.0 are now parameters of the [`server` property in version 2.0](#server-property-configuration).
531531

532532
For example, if you configure the version 1.0 linked service as shown below:
533533

@@ -549,7 +549,7 @@ Here are steps that help you upgrade the Oracle connector:
549549
}
550550
```
551551

552-
The identical version 2.0 (Preview) linked service configuration using **Easy Connect (Plus) Naming** is:
552+
The identical version 2.0 linked service configuration using **Easy Connect (Plus) Naming** is:
553553

554554
:::image type="content" source="media/connector-oracle/easy-connect-naming-linked-service.png" alt-text="Screenshot of linked service using easy connector (Plus) naming.":::
555555

@@ -573,7 +573,7 @@ Here are steps that help you upgrade the Oracle connector:
573573
}
574574
```
575575

576-
The identical version 2.0 (Preview) linked service configuration using **Connector Descriptor** is:
576+
The identical version 2.0 linked service configuration using **Connector Descriptor** is:
577577

578578
:::image type="content" source="media/connector-oracle/connector-descriptor-linked-service.png" alt-text="Screenshot of linked service using connector descriptor.":::
579579

@@ -603,13 +603,13 @@ Here are steps that help you upgrade the Oracle connector:
603603

604604
Note that:
605605

606-
- If you use **Oracle Service Name** in version 1.0, you can use **Easy Connect (Plus) Naming** or **Connector Descriptor** as the server format in version 2.0 (Preview).
606+
- If you use **Oracle Service Name** in version 1.0, you can use **Easy Connect (Plus) Naming** or **Connector Descriptor** as the server format in version 2.0.
607607

608-
- If you use **Oracle SID** in version 1.0, you need to use **Connector Descriptor** as the server format in version 2.0 (Preview).
608+
- If you use **Oracle SID** in version 1.0, you need to use **Connector Descriptor** as the server format in version 2.0.
609609

610-
- For some additional connection properties in version 1.0, we provide alternative properties or parameters in the `server` property in version 2.0 (Preview). You can refer to the table below to upgrade the version 1.0 properties.
610+
- For some additional connection properties in version 1.0, we provide alternative properties or parameters in the `server` property in version 2.0. You can refer to the table below to upgrade the version 1.0 properties.
611611

612-
| Version 1.0 | Version 2.0 (Preview)  |
612+
| Version 1.0 | Version 2.0 |
613613
|:--- |:--- |
614614
| encryptionmethod| PROTOCOL (parameter in `server`) |
615615
| tnsnamesfile | TNS_ADMIN (environment variable supported on the self-hosted integration runtime)  |
@@ -625,7 +625,7 @@ Here are steps that help you upgrade the Oracle connector:
625625
| cryptoprotocolversion | SSL_VERSION (parameter in `server`) |
626626
| truststore | WALLET_LOCATION (parameter in `server`) |
627627

628-
For example, if you use `alternateservers` in version 1.0, you can set the `DESCRIPTION_LIST` parameter in the server property in version 2.0 (Preview):
628+
For example, if you use `alternateservers` in version 1.0, you can set the `DESCRIPTION_LIST` parameter in the server property in version 2.0:
629629

630630
Version 1.0 linked service using `alternateservers`:
631631

@@ -641,7 +641,7 @@ Here are steps that help you upgrade the Oracle connector:
641641
}
642642
```
643643

644-
Identical version 2.0 (Preview) linked service using `DESCRIPTION_LIST` parameter in **Connector Descriptor**:
644+
Identical version 2.0 linked service using `DESCRIPTION_LIST` parameter in **Connector Descriptor**:
645645

646646
```json
647647
{
@@ -659,15 +659,15 @@ Here are steps that help you upgrade the Oracle connector:
659659
}
660660
```
661661

662-
2. The data type mapping for the Oracle linked service version 2.0 (Preview) is different from that for the version 1.0. To learn the latest data type mapping, see [Data type mapping for Oracle](#data-type-mapping-for-oracle).
662+
2. The data type mapping for the Oracle linked service version 2.0 is different from that for the version 1.0. To learn the latest data type mapping, see [Data type mapping for Oracle](#data-type-mapping-for-oracle).
663663

664-
An additional connection property `supportV1DataTypes` in version 2.0 (Preview) can reduce upgrade difficulties caused by data type changes. Setting this property to `true` ensures that the data type in version 2.0 (Preview) remains consistent with version 1.0.
664+
An additional connection property `supportV1DataTypes` in version 2.0 can reduce upgrade difficulties caused by data type changes. Setting this property to `true` ensures that the data type in version 2.0 remains consistent with version 1.0.
665665

666-
## Differences between Oracle version 2.0 (Preview) and version 1.0
666+
## Differences between Oracle version 2.0 and version 1.0
667667

668-
The Oracle connector version 2.0 (Preview) offers new functionalities and is compatible with most features of version 1.0. The following table shows the feature differences between version 2.0 (Preview) and version 1.0.
668+
The Oracle connector version 2.0 offers new functionalities and is compatible with most features of version 1.0. The following table shows the feature differences between version 2.0 and version 1.0.
669669

670-
| Version 2.0 (Preview) | Version 1.0  |
670+
| Version 2.0 | Version 1.0  |
671671
|:--- |:--- |
672672
|The following mappings are used from Oracle data types to interim service data types used by the service internally. <br><br>NUMBER(p,s) -> Int16, Int32, Int64, Double, Single, Decimal <br>FLOAT(p)-> Double or Decimal based on its precision <br>NUMBER -> Decimal <br>TIMESTAMP WITH TIME ZONE -> DateTimeOffset <br>INTERVAL YEAR TO MONTH -> Int64 <br>INTERVAL DAY TO SECOND -> TimeSpan |The following mappings are used from Oracle data types to interim service data types used by the service internally. <br><br>NUMBER(p,s) -> Decimal or String based on its precision <br>FLOAT(p)-> Double <br>NUMBER -> Double <br>TIMESTAMP WITH TIME ZONE -> DateTime <br>INTERVAL YEAR TO MONTH -> String <br>INTERVAL DAY TO SECOND -> String |
673673
| Support convertDecimalToInteger in copy source when `supportV1DataTypes` is set to `true`. | Support convertDecimalToInteger in copy source.  |
75.5 KB
Loading

0 commit comments

Comments
 (0)