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-netezza.md
+110-5Lines changed: 110 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ author: jianleishen
6
6
ms.subservice: data-movement
7
7
ms.custom: synapse
8
8
ms.topic: conceptual
9
-
ms.date: 01/02/2025
9
+
ms.date: 07/01/2025
10
10
ms.author: jianleishen
11
11
---
12
12
# 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
17
17
>[!TIP]
18
18
>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).
19
19
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
+
20
23
## Supported capabilities
21
24
22
25
This Netezza connector is supported for the following capabilities:
@@ -38,9 +41,23 @@ This Netezza connector supports:
38
41
39
42
The service provides a built-in driver to enable connectivity. You don't need to manually install any driver to use this connector.
40
43
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.
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
+
### <aname="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.
44
61
45
62
## Get started
46
63
@@ -75,7 +92,57 @@ The following sections provide details about properties you can use to define en
75
92
76
93
## Linked service properties
77
94
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
+
### <aname="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:
79
146
80
147
| Property | Description | Required |
81
148
|:--- |:--- |:--- |
@@ -263,10 +330,48 @@ You are suggested to enable parallel copy with data partitioning especially when
263
330
}
264
331
```
265
332
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
+
266
357
## Lookup activity properties
267
358
268
359
To learn details about the properties, check [Lookup activity](control-flow-lookup-activity.md).
269
360
361
+
## <aname="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
+
### <aname="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.
0 commit comments