Skip to content

Commit 81928d3

Browse files
Merge pull request #296742 from Lucky-Wang16/0321-Add_vertica_difference
[Doc update] Add difference section for Vertica
2 parents b7b9821 + 95ad49e commit 81928d3

File tree

2 files changed

+29
-21
lines changed

2 files changed

+29
-21
lines changed

articles/data-factory/connector-cassandra.md

Lines changed: 11 additions & 11 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/07/2025
9+
ms.date: 03/21/2025
1010
ms.author: jianleishen
1111
---
1212
# Copy data from Cassandra using Azure Data Factory or Synapse Analytics
@@ -347,6 +347,16 @@ The following tables show the virtual tables that renormalize the data from the
347347

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

350+
## Upgrade the Cassandra connector
351+
352+
Here are steps that help you upgrade the Cassandra connector:
353+
354+
1. In **Edit linked service** page, select version 2.0 (Preview) and configure the linked service by referring to [Linked service properties](#linked-service-properties).
355+
356+
2. In version 2.0 (Preview), the `query` in the copy activity source supports only CQL query, not SQL-92 query. For more information, see [Cassandra as source](#cassandra-as-source).
357+
358+
3. The data type mapping for version 2.0 (Preview) is different from that for version 1.0. To learn the latest data type mapping, see [Data type mapping for Cassandra](#data-type-mapping-for-cassandra).
359+
350360
## Differences between Cassandra version 2.0 (Preview) and version 1.0
351361

352362
The Cassandra connector version 2.0 (Preview) offers new functionalities and is compatible with most features of version 1.0. The table below shows the feature differences between version 2.0 (Preview) and version 1.0.
@@ -358,15 +368,5 @@ The Cassandra connector version 2.0 (Preview) offers new functionalities and is
358368
| No virtual tables are created for collection types. For more information, see [Work with collections when using version 2.0 (Preview)](#work-with-collections-when-using-version-20-preview). | Virtual tables are created for collection types. For more information, see [Work with Cassandra collection types using virtual table when using version 1.0](#work-with-collections-using-virtual-table-when-using-version-10). |
359369
| The following mappings are used from Cassandra data types to interim service data type. <br><br> SMALLINT -> Short <br> TINYINT -> SByte | The following mappings are used from Cassandra data types to interim service data type. <br><br> SMALLINT -> Int16 <br> TINYINT -> Int16 |
360370

361-
## Upgrade the Cassandra connector
362-
363-
Here are steps that help you upgrade the Cassandra connector:
364-
365-
1. In **Edit linked service** page, select version 2.0 (Preview) and configure the linked service by referring to [Linked service properties](#linked-service-properties).
366-
367-
2. In version 2.0 (Preview), the `query` in the copy activity source supports only CQL query, not SQL-92 query. For more information, see [Cassandra as source](#cassandra-as-source).
368-
369-
3. The data type mapping for version 2.0 (Preview) is different from that for version 1.0. To learn the latest data type mapping, see [Data type mapping for Cassandra](#data-type-mapping-for-cassandra).
370-
371371
## Related content
372372
For a list of data stores supported as sources and sinks by the copy activity, see [supported data stores](copy-activity-overview.md#supported-data-stores-and-formats).

articles/data-factory/connector-vertica.md

Lines changed: 18 additions & 10 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: 08/12/2024
9+
ms.date: 03/21/2025
1010
ms.author: jianleishen
1111
---
1212
# Copy data from Vertica using Azure Data Factory or Synapse Analytics
@@ -29,11 +29,11 @@ For a list of data stores that are supported as sources/sinks by the copy activi
2929

3030
The service provides a built-in driver to enable connectivity, therefore you don't need to manually install any driver using this connector.
3131

32-
For version 2.0 (Preview), you need to [install a Vertica ODBC driver](#install-vertica-odbc-driver-for-the-version-20-preview) manually. For version 1.0, the service provides a built-in driver to enable connectivity, therefore you don't need to manually install any driver.
32+
For version 2.0, you need to [install a Vertica ODBC driver](#install-vertica-odbc-driver-for-the-version-20) manually. For version 1.0, the service provides a built-in driver to enable connectivity, therefore you don't need to manually install any driver.
3333

3434
## Prerequisites
3535

36-
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. If you use the version 2.0 (Preview), your self-hosted integration runtime version should be 5.44.8984.1 or above.
36+
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. If you use the version 2.0, your self-hosted integration runtime version should be 5.44.8984.1 or above.
3737

3838
For more information about the network security mechanisms and options supported by Data Factory, see [Data access strategies](data-access-strategies.md).
3939

@@ -44,9 +44,9 @@ If your data store is a managed cloud data service, you can use the Azure Integr
4444
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.
4545

4646

47-
### Install Vertica ODBC driver for the version 2.0 (Preview)
47+
### Install Vertica ODBC driver for the version 2.0
4848

49-
To use Vertica connector with version 2.0 (Preview), install the Vertica ODBC driver on the machine running the self-hosted Integration runtime by following these steps:
49+
To use Vertica connector with version 2.0, install the Vertica ODBC driver on the machine running the self-hosted Integration runtime by following these steps:
5050

5151
1. Download the Vertica client setup for ODBC driver from [Client Drivers | OpenText™ Vertica™](https://www.vertica.com/download/vertica/client-drivers/). Take Windows system setup as an example:
5252

@@ -97,7 +97,7 @@ The following sections provide details about properties that are used to define
9797

9898
## Linked service properties
9999

100-
If you use version 2.0 (Preview), the following properties are supported for Vertica linked service:
100+
If you use version 2.0, the following properties are supported for Vertica linked service:
101101

102102
| Property | Description | Required |
103103
|:--- |:--- |:--- |
@@ -107,7 +107,7 @@ If you use version 2.0 (Preview), the following properties are supported for Ver
107107
| database | Name of the Vertica database. | Yes |
108108
| uid | The user ID that is used to connect to the database. | Yes |
109109
| pwd | The password that the application uses to connect to the database. | Yes |
110-
| version | The version when you select version 2.0 (Preview). The value is `2.0`. | Yes |
110+
| version | The version when you select version 2.0. The value is `2.0`. | Yes |
111111
| connectVia | The [Integration Runtime](concepts-integration-runtime.md) to be used to connect to the data store. Learn more from [Prerequisites](#prerequisites) section. You can only use the self-hosted integration runtime and its version should be 5.44.8984.1 or above. |No |
112112

113113
**Example:**
@@ -274,9 +274,17 @@ To learn details about the properties, check [Lookup activity](control-flow-look
274274

275275
Here are steps that help you upgrade your Vertica version:
276276

277-
1. Install a Vertica ODBC driver by following the steps in [Prerequisites](#install-vertica-odbc-driver-for-the-version-20-preview).
278-
1. In **Edit linked service page**, select **2.0 (Preview)** under **Version** and configure the linked service by referring to [Linked service properties](#linked-service-properties).
279-
1. Apply a self-hosted integration runtime with version 5.44.8984.1 or above. Azure integration runtime is not supported by version 2.0 (Preview).
277+
1. Install a Vertica ODBC driver by following the steps in [Prerequisites](#install-vertica-odbc-driver-for-the-version-20).
278+
1. In **Edit linked service page**, select version 2.0 and configure the linked service by referring to [Linked service properties](#linked-service-properties).
279+
1. Apply a self-hosted integration runtime with version 5.44.8984.1 or above. Azure integration runtime is not supported by version 2.0.
280+
281+
## Differences between Vertica version 2.0 and version 1.0
282+
283+
The Vertica connector version 2.0 offers new functionalities and is compatible with most features of version 1.0. The table below shows the feature differences between version 2.0 and version 1.0.
284+
285+
| Version 2.0 | Version 1.0 |
286+
| --- | --- |
287+
| Only support the self-hosted integration runtime with version 5.44.8984.1 or above. You need to [install a Vertica ODBC driver](#install-vertica-odbc-driver-for-the-version-20) on the machine running the self-hosted Integration runtime. | Support the Azure integration runtime and self-hosted integration runtime.|
280288

281289
## Related content
282290
For a list of data stores supported as sources and sinks by the copy activity, see [supported data stores](copy-activity-overview.md#supported-data-stores-and-formats).

0 commit comments

Comments
 (0)