Skip to content

Commit a9699a5

Browse files
Lucky-Wang16Lucky-Wang16
committed
Update Netezza v2 doc
1 parent 0a209cb commit a9699a5

File tree

2 files changed

+99
-4
lines changed

2 files changed

+99
-4
lines changed

‎articles/data-factory/connector-netezza.md

Lines changed: 97 additions & 4 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 (Preview) 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 (Preview) 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,6 +41,8 @@ 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 (Preview), you need to install a [IBM's Netezza ODBC driver](https://knowledge.informatica.com/s/article/HOW-TO-Download-the-Netezza-ODBC-driver?language=en_US) manually and its version should be v11.02.02 or higher. 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

4348
[!INCLUDE [data-factory-v2-integration-runtime-requirements](includes/data-factory-v2-integration-runtime-requirements.md)]
@@ -75,7 +80,57 @@ The following sections provide details about properties you can use to define en
7580

7681
## Linked service properties
7782

78-
The following properties are supported for the Netezza linked service:
83+
The Netezza connector now supports version 2.0 (Preview). 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.
84+
85+
- [Version 2.0 (Preview)](#version-20)
86+
- [Version 1.0](#version-10)
87+
88+
### <a name="version-20"></a> Version 2.0 (Preview)
89+
90+
The Netezza linked service supports the following properties when apply version 2.0 (Preview):
91+
92+
| Property | Description | Required |
93+
|:--- |:--- |:--- |
94+
| type | The **type** property must be set to **Netezza**. | Yes |
95+
| version | The version that you specify. The value is `2.0`. | Yes |
96+
| server | The hostname or the IP address of the Netezza server. | Yes |
97+
| port | The port number of the server listener. | Yes |
98+
| database | Name of the Netezza database. | Yes |
99+
| uid | The user id used to connect to the database. | Yes |
100+
| pwd | The password used to connect to the database. | Yes |
101+
| 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 |
102+
| 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 |
103+
104+
**Example**
105+
106+
```json
107+
{
108+
"name": "NetezzaLinkedService",
109+
"properties": {
110+
"type": "Netezza",
111+
"version": "2.0",
112+
"typeProperties": {
113+
"server": "<server>",
114+
"port": "<port>",
115+
"database": "<database>",
116+
"uid": "<username>",
117+
"pwd": {
118+
"type": "SecureString",
119+
"value": "<password>"
120+
},
121+
"securityLevel": "preferredUnSecured"
122+
},
123+
"connectVia": {
124+
"referenceName": "<name of Integration Runtime>",
125+
"type": "IntegrationRuntimeReference"
126+
}
127+
}
128+
}
129+
```
130+
131+
### Version 1.0
132+
133+
The following properties are supported for the Netezza linked service when apply version 1.0:
79134

80135
| Property | Description | Required |
81136
|:--- |:--- |:--- |
@@ -263,10 +318,48 @@ You are suggested to enable parallel copy with data partitioning especially when
263318
}
264319
```
265320

321+
## Data type mapping for Netezza
322+
323+
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).
324+
325+
| Netezza data type | Interim service data type (for version 2.0 (Preview)) | Interim service data type (for version 1.0) |
326+
|:--- |:--- |:--- |
327+
| BOOLEAN | Boolean | Boolean |
328+
| CHAR | String | String |
329+
| VARCHAR | String | String |
330+
| NCHAR | String | String |
331+
| NVARCHAR | String | String |
332+
| DATE | Date | DateTime |
333+
| TIMESTAMP | DateTime | DateTime |
334+
| TIME | Time | TimeSpan |
335+
| INTERVAL | Not Supported | TimeSpan |
336+
| TIME WITH TIME ZONE | String | String |
337+
| NUMERIC(p,s) | Decimal | Decimal |
338+
| REAL | Single | Single |
339+
| DOUBLE PRECISION | Double | Double |
340+
| INTEGER | Int32 | Int32 |
341+
| BYTEINT | Int16 | SByte |
342+
| SMALLINT | Int16 | Int16 |
343+
| BIGINT | Int64 | Int64 |
344+
266345
## Lookup activity properties
267346

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

349+
## <a name="differences-between-netezza-version-20-and-version-10"></a> Netezza connector lifecycle and upgrade
350+
351+
The following table shows the release stage and change logs for different versions of the Netezza connector:
352+
353+
| Version | Release stage | Change log |
354+
| :----------- | :------- |:------- |
355+
| Version 1.0 | End of support announced | / |
356+
| Version 2.0 (Preview) | GA version available | • DATE is read as Date data type. <br><br>• TIME is read as Time data type. <br><br>• INTERVAL is not supported. <br><br>• BYTEINT is read as Int16 data type. <br><br>• Only support the self-hosted integration runtime.|
357+
358+
### <a name="upgrade-the-netezza-connector"></a> Upgrade the Netezza connector from version 1.0 to version 2.0 (Preview)
359+
360+
1. In **Edit linked service** page, select 2.0 (Preview) for version. For more information, see [linked service version 2.0 (Preview) properties](#version-20).
361+
1. The data type mapping for the Netezza 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 Netezza](#data-type-mapping-for-netezza).
362+
1. Only support the self-hosted integration runtime. Azure integration runtime is not supported by version 2.0 (Preview).
270363

271364
## Related content
272365

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

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

0 commit comments

Comments
 (0)