Skip to content

Commit cc48644

Browse files
authored
Merge pull request #302069 from Lucky-Wang16/0701-Update_Netezza_v2
Update Netezza v2 doc
2 parents e4e0013 + 84f4209 commit cc48644

File tree

4 files changed

+114
-6
lines changed

4 files changed

+114
-6
lines changed

articles/data-factory/connector-netezza.md

Lines changed: 110 additions & 5 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: 01/02/2025
9+
ms.date: 07/01/2025
1010
ms.author: jianleishen
1111
---
1212
# Copy data from Netezza by using Azure Data Factory or Synapse Analytics
@@ -17,14 +17,17 @@ This article outlines how to use Copy Activity in Azure Data Factory or Synapse
1717
>[!TIP]
1818
>For data migration scenario from Netezza to Azure, learn more from [Migrate data from on-premises Netezza server to Azure](data-migration-guidance-netezza-azure-sqldw.md).
1919
20+
> [!IMPORTANT]
21+
> The Netezza connector version 2.0 provides improved native Netezza support. If you are using the Netezza connector version 1.0 in your solution, please [upgrade your Netezza connector](#upgrade-the-netezza-connector) before **September 30, 2025**. Refer to this [section](#differences-between-netezza-version-20-and-version-10) for details on the difference between version 2.0 and version 1.0.
22+
2023
## Supported capabilities
2124

2225
This Netezza connector is supported for the following capabilities:
2326

2427
| Supported capabilities|IR |
2528
|---------| --------|
26-
|[Copy activity](copy-activity-overview.md) (source/-)|① ②|
27-
|[Lookup activity](control-flow-lookup-activity.md)|① ②|
29+
|[Copy activity](copy-activity-overview.md) (source/-)|① (only for version 1.0) ②|
30+
|[Lookup activity](control-flow-lookup-activity.md)|① (only for version 1.0) ②|
2831

2932
*① Azure integration runtime ② Self-hosted integration runtime*
3033

@@ -38,9 +41,23 @@ This Netezza connector supports:
3841

3942
The service provides a built-in driver to enable connectivity. You don't need to manually install any driver to use this connector.
4043

44+
For version 2.0, you need to [install a IBM Netezza ODBC driver](#install-netezza-odbc-driver-for-the-version-20) manually. For version 1.0, the service provides a built-in driver to enable connectivity. You don't need to manually install any driver to use this connector.
45+
4146
## Prerequisites
4247

43-
[!INCLUDE [data-factory-v2-integration-runtime-requirements](includes/data-factory-v2-integration-runtime-requirements.md)]
48+
If your data store is located inside an on-premises network, an Azure virtual network, or Amazon Virtual Private Cloud, you need to configure a [self-hosted integration runtime](create-self-hosted-integration-runtime.md) to connect to it.
49+
50+
For more information about the network security mechanisms and options supported by Data Factory, see [Data access strategies](data-access-strategies.md).
51+
52+
### For version 1.0
53+
54+
If your data store is a managed cloud data service, you can use the Azure Integration Runtime. If the access is restricted to IPs that are approved in the firewall rules, you can add [Azure Integration Runtime IPs](azure-integration-runtime-ip-addresses.md) to the allow list.
55+
56+
You can also use the [managed virtual network integration runtime](tutorial-managed-virtual-network-on-premise-sql-server.md) feature in Azure Data Factory to access the on-premises network without installing and configuring a self-hosted integration runtime.
57+
58+
### <a name="install-netezza-odbc-driver-for-the-version-20"></a> Install Netezza ODBC driver for the version 2.0
59+
60+
To use Netezza connector with version 2.0, [install the IBM Netezza ODBC driver](https://knowledge.informatica.com/s/article/HOW-TO-Download-the-Netezza-ODBC-driver?language=en_US) version 11.02.02 or higher on the machine running the self-hosted Integration runtime.
4461

4562
## Get started
4663

@@ -75,7 +92,57 @@ The following sections provide details about properties you can use to define en
7592

7693
## Linked service properties
7794

78-
The following properties are supported for the Netezza linked service:
95+
The Netezza connector now supports version 2.0. Refer to this [section](#upgrade-the-netezza-connector) to upgrade your Netezza connector version from version 1.0. For the property details, see the corresponding sections.
96+
97+
- [Version 2.0](#version-20)
98+
- [Version 1.0](#version-10)
99+
100+
### <a name="version-20"></a> Version 2.0
101+
102+
The Netezza linked service supports the following properties when apply version 2.0:
103+
104+
| Property | Description | Required |
105+
|:--- |:--- |:--- |
106+
| type | The **type** property must be set to **Netezza**. | Yes |
107+
| version | The version that you specify. The value is `2.0`. | Yes |
108+
| server | The hostname or the IP address of the Netezza server. | Yes |
109+
| port | The port number of the server listener. | Yes |
110+
| database | Name of the Netezza database. | Yes |
111+
| uid | The user id used to connect to the database. | Yes |
112+
| pwd | The password used to connect to the database. | Yes |
113+
| SecurityLevel | The level of security that the driver uses for the connection to the data store. <br>Example: `SecurityLevel=preferredUnSecured`. Supported values are:<br/>- **Only unsecured** (**onlyUnSecured**): The driver doesn't use SSL.<br/>- **Preferred unsecured (preferredUnSecured) (default)**: If the server provides a choice, the driver doesn't use SSL. | No |
114+
| connectVia | The [Integration Runtime](concepts-integration-runtime.md) to use to connect to the data store. Learn more from [Prerequisites](#prerequisites) section. You can only use the self-hosted integration runtime. |No |
115+
116+
**Example**
117+
118+
```json
119+
{
120+
"name": "NetezzaLinkedService",
121+
"properties": {
122+
"type": "Netezza",
123+
"version": "2.0",
124+
"typeProperties": {
125+
"server": "<server>",
126+
"port": "<port>",
127+
"database": "<database>",
128+
"uid": "<username>",
129+
"pwd": {
130+
"type": "SecureString",
131+
"value": "<password>"
132+
},
133+
"securityLevel": "preferredUnSecured"
134+
},
135+
"connectVia": {
136+
"referenceName": "<name of Integration Runtime>",
137+
"type": "IntegrationRuntimeReference"
138+
}
139+
}
140+
}
141+
```
142+
143+
### Version 1.0
144+
145+
The following properties are supported for the Netezza linked service when apply version 1.0:
79146

80147
| Property | Description | Required |
81148
|:--- |:--- |:--- |
@@ -263,10 +330,48 @@ You are suggested to enable parallel copy with data partitioning especially when
263330
}
264331
```
265332

333+
## Data type mapping for Netezza
334+
335+
When you copy data from Netezza, the following mappings apply from Netezza'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).
336+
337+
| Netezza data type | Interim service data type (for version 2.0) | Interim service data type (for version 1.0) |
338+
|:--- |:--- |:--- |
339+
| BOOLEAN | Boolean | Boolean |
340+
| CHAR | String | String |
341+
| VARCHAR | String | String |
342+
| NCHAR | String | String |
343+
| NVARCHAR | String | String |
344+
| DATE | Date | DateTime |
345+
| TIMESTAMP | DateTime | DateTime |
346+
| TIME | Time | TimeSpan |
347+
| INTERVAL | Not Supported | TimeSpan |
348+
| TIME WITH TIME ZONE | String | String |
349+
| NUMERIC(p,s) | Decimal | Decimal |
350+
| REAL | Single | Single |
351+
| DOUBLE PRECISION | Double | Double |
352+
| INTEGER | Int32 | Int32 |
353+
| BYTEINT | Int16 | SByte |
354+
| SMALLINT | Int16 | Int16 |
355+
| BIGINT | Int64 | Int64 |
356+
266357
## Lookup activity properties
267358

268359
To learn details about the properties, check [Lookup activity](control-flow-lookup-activity.md).
269360

361+
## <a name="differences-between-netezza-version-20-and-version-10"></a> Netezza connector lifecycle and upgrade
362+
363+
The following table shows the release stage and change logs for different versions of the Netezza connector:
364+
365+
| Version | Release stage | Change log |
366+
| :----------- | :------- |:------- |
367+
| Version 1.0 | End of support announced | / |
368+
| Version 2.0 | GA version available | • Only support the self-hosted integration runtime. <br><br>• BYTEINT is read as Int16 data type. <br><br> • DATE is read as Date data type. <br><br>• TIME is read as Time data type. <br><br>• INTERVAL is not supported.|
369+
370+
### <a name="upgrade-the-netezza-connector"></a> Upgrade the Netezza connector from version 1.0 to version 2.0
371+
372+
1. In **Edit linked service** page, select 2.0 for version. For more information, see [linked service version 2.0 properties](#version-20).
373+
1. The data type mapping for the Netezza 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 Netezza](#data-type-mapping-for-netezza).
374+
1. Only support the self-hosted integration runtime. Azure integration runtime is not supported by version 2.0.
270375

271376
## Related content
272377

articles/data-factory/connector-release-stages-and-timelines.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,8 @@ For comprehensive details on support levels and recommended usage at each stage,
5656
| [Marketo (Preview)](connector-marketo.md) | / | End of support | December 31, 2024 | December 31, 2024 |
5757
| [MySQL](connector-mysql.md) | version 2.0 | GA | / | / |
5858
| | version 1.0 | End of support | October 31, 2024 | September 30, 2025 |
59+
| [Netezza](connector-netezza.md) | version 2.0 | GA | / | / |
60+
| | version 1.0 | End of support announced | September 30, 2025 | October 31, 2025 |
5961
| [Oracle](connector-oracle.md) | version 2.0 | GA | / | / |
6062
| | version 1.0 | End of support announced | October 31, 2025 | March 31, 2026 |
6163
| [Oracle Eloqua (Preview)](connector-oracle-eloqua.md) | / | End of support | December 31, 2024 | December 31, 2024 |

articles/data-factory/guidance-for-byod-approach.md

Lines changed: 2 additions & 1 deletion
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: 07/11/2025
10+
ms.date: 07/14/2025
1111
---
1212

1313
# Guidance on using the Bring Your Own Driver (BYOD) approach
@@ -90,6 +90,7 @@ This article provides step-by-step guidance for using connectors with Bring Your
9090
### Related connectors
9191

9292
- [Amazon Redshift (version 2.0 (Preview))](connector-amazon-redshift.md)
93+
- [Netezza (version 2.0)](connector-netezza.md)
9394
- [Vertica (version 2.0)](connector-vertica.md)
9495

9596
## Related content
-7.46 KB
Loading

0 commit comments

Comments
 (0)