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-quickbooks.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: Copy data from QuickBooks Online
2
+
title: Copy data from QuickBooks Online (Preview)
3
3
description: Learn how to copy data from QuickBooks Online to supported sink data stores using a copy activity in an Azure Data Factory or Synapse Analytics pipeline.
4
4
titleSuffix: Azure Data Factory & Azure Synapse
5
5
author: jianleishen
@@ -10,7 +10,7 @@ ms.custom: synapse
10
10
ms.date: 06/11/2025
11
11
---
12
12
13
-
# Copy data from QuickBooks Online using Azure Data Factory or Synapse Analytics
13
+
# Copy data from QuickBooks Online using Azure Data Factory or Synapse Analytics (Preview)
This article outlines how to use the Copy Activity in an Azure Data Factory or Synapse Analytics pipeline to copy data from QuickBooks Online. It builds on the [copy activity overview](copy-activity-overview.md) article that presents a general overview of copy activity.
@@ -19,7 +19,7 @@ This article outlines how to use the Copy Activity in an Azure Data Factory or S
19
19
> This connector version 1.0 is currently in preview. You can try it out and give us feedback. If you want to take a dependency on preview connectors in your solution, please contact [Azure support](https://azure.microsoft.com/support/).
20
20
21
21
> [!IMPORTANT]
22
-
> The QuickBooks connector version 2.0 provides improved native QuickBooks support. If you are using QuickBooks connector version 1.0 (Preview) in your solution, please [upgrade the QuickBooks connector](#upgrade-the-quickbooks-connector-from-version-10-to-version-20) before **August 31, 2025**. Refer to this [section](#quickbooks-connector-lifecycle-and-upgrade) for details on the difference between version 2.0 and version 1.0 (Preview).
22
+
> The QuickBooks connector version 2.0 provides improved native QuickBooks support. If you are using QuickBooks connector version 1.0 in your solution, please [upgrade the QuickBooks connector](#upgrade-the-quickbooks-connector-from-version-10-to-version-20) before **August 31, 2025**. Refer to this [section](#quickbooks-connector-lifecycle-and-upgrade) for details on the difference between version 2.0 and version 1.0.
23
23
24
24
## Supported capabilities
25
25
@@ -69,10 +69,10 @@ The following sections provide details about properties that are used to define
69
69
70
70
## Linked service properties
71
71
72
-
The QuickBooks connector now supports version 2.0. Refer to this [section](#upgrade-the-quickbooks-connector-from-version-10-to-version-20) to upgrade your QuickBooks connector version from version 1.0 (Preview). For the property details, see the corresponding sections.
72
+
The QuickBooks connector now supports version 2.0. Refer to this [section](#upgrade-the-quickbooks-connector-from-version-10-to-version-20) to upgrade your QuickBooks connector version from version 1.0. For the property details, see the corresponding sections.
73
73
74
74
-[Version 2.0](#version-20)
75
-
-[Version 1.0 (Preview)](#version-10)
75
+
-[Version 1.0](#version-10)
76
76
77
77
### Version 2.0
78
78
@@ -113,9 +113,9 @@ The QuickBooks linked service supports the following properties when apply versi
113
113
}
114
114
```
115
115
116
-
### <aname="version-10"></a> Version 1.0 (Preview)
116
+
### <aname="version-10"></a> Version 1.0
117
117
118
-
The following properties are supported for QuickBooks linked service when apply version 1.0 (Preview):
118
+
The following properties are supported for QuickBooks linked service when apply version 1.0:
119
119
120
120
| Property | Description | Required |
121
121
|:--- |:--- |:--- |
@@ -201,7 +201,7 @@ To copy data from QuickBooks Online, set the source type in the copy activity to
201
201
| Property | Description | Required |
202
202
|:--- |:--- |:--- |
203
203
| type | The type property of the copy activity source must be set to: **QuickBooksSource**| Yes |
204
-
| query | Use the custom SQL query to read data. <br><br>For version 2.0, you can only use QuickBooks native query with limitations. For more information, see [query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries). Note that the `tableName` specified in the query must match the `tableName` in the dataset. <br><br>For version 1.0 (Preview), you can use SQL-92 query. For example: `"SELECT * FROM "Bill" WHERE Id = '123'"`. | No (if "tableName" in dataset is specified) |
204
+
| query | Use the custom SQL query to read data. <br><br>For version 2.0, you can only use QuickBooks native query with limitations. For more information, see [query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries). Note that the `tableName` specified in the query must match the `tableName` in the dataset. <br><br>For version 1.0, you can use SQL-92 query. For example: `"SELECT * FROM "Bill" WHERE Id = '123'"`. | No (if "tableName" in dataset is specified) |
205
205
206
206
**Example:**
207
207
@@ -242,15 +242,15 @@ The Copy Activity in the service cannot copy data directly from Quickbooks Deskt
242
242
243
243
When you copy data from Quickbooks, the following mappings apply from Quickbooks'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).
244
244
245
-
| Quickbooks data type | Interim service data type (for version 2.0) | Interim service data type (for version 1.0 (Preview)) |
245
+
| Quickbooks data type | Interim service data type (for version 2.0) | Interim service data type (for version 1.0) |
246
246
|:--- |:--- |:--- |
247
247
| String | string | string |
248
248
| Boolean | bool | bool |
249
249
| DateTime | datetime | datetime |
250
250
| Decimal | decimal (15,2) | decimal (15, 2) |
251
251
| Enum | string | string |
252
252
| Date | datetime | datetime |
253
-
| BigDecimal | decimal (15,2) |Decimal (15, 2) |
253
+
| BigDecimal | decimal (15,2) |decimal (15, 2) |
254
254
| Integer | int | int |
255
255
256
256
## Lookup activity properties
@@ -263,13 +263,13 @@ The following table shows the release stage and change logs for different versio
263
263
264
264
| Version | Release stage | Change log |
265
265
| :----------- | :------- |:------- |
266
-
| Version 1.0 (Preview) | End of support announced | / |
266
+
| Version 1.0 | End of support announced | / |
267
267
| Version 2.0 | GA version available | • `useEncryptedEndpoints` is not supported. <br><br>• SQL-92 query is not supported. <br><br>• Support Quickbooks native query with limitations. GROUP BY clauses, JOIN clauses and Aggregate Function (Avg, Max, Sum) aren't supported. For more information, see [query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries). <br><br>• The `tableName` specified in the `query` must match the `tableName` in the dataset. |
268
268
269
-
### <aname="upgrade-the-quickbooks-connector-from-version-10-to-version-20"></a> Upgrade the Quickbooks connector from version 1.0 (Preview) to version 2.0
269
+
### <aname="upgrade-the-quickbooks-connector-from-version-10-to-version-20"></a> Upgrade the Quickbooks connector from version 1.0 to version 2.0
270
270
271
271
1. In **Edit linked service** page, select 2.0 for version. For more information, see [linked service version 2.0 properties](#version-20).
272
-
1. If you use SQL query in the copy activity source or the lookup activity that refers to the version 1.0 (Preview) linked service, you need to convert them to the QuickBooks native query. Learn more about native query from [Quickbooks as a source type](#quickbooks-as-source) and [query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries).
272
+
1. If you use SQL query in the copy activity source or the lookup activity that refers to the version 1.0 linked service, you need to convert them to the QuickBooks native query. Learn more about native query from [Quickbooks as a source type](#quickbooks-as-source) and [query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries).
273
273
274
274
## Related content
275
275
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