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
+19-18Lines changed: 19 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -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 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.
22
+
> The QuickBooks connector version 2.0 (Preview) 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 (Preview) and version 1.0.
23
23
24
24
## Supported capabilities
25
25
@@ -69,14 +69,14 @@ 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. For the property details, see the corresponding sections.
72
+
The QuickBooks connector now supports version 2.0 (Preview). 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
-
-[Version 2.0](#version-20)
74
+
-[Version 2.0 (Preview)](#version-20)
75
75
-[Version 1.0](#version-10)
76
76
77
-
### Version 2.0
77
+
### Version 2.0 (Preview)
78
78
79
-
The QuickBooks linked service supports the following properties when apply version 2.0:
79
+
The QuickBooks linked service supports the following properties when apply version 2.0 (Preview):
80
80
81
81
| Property | Description | Required |
82
82
|:--- |:--- |:--- |
@@ -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, 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 (Preview), 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,16 +242,16 @@ 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) |
245
+
| Quickbooks data type | Interim service data type (for version 2.0 (Preview)) | Interim service data type (for version 1.0) |
246
246
|:--- |:--- |:--- |
247
-
| String| string| string|
248
-
| Boolean| bool| bool|
249
-
| DateTime| datetime| datetime|
250
-
| Decimal| decimal (15,2)| decimal (15, 2)|
251
-
| Enum| string| string |
252
-
| Date|datetime | datetime|
253
-
| BigDecimal | decimal (15,2)| decimal (15, 2)|
254
-
| Integer| int| int|
247
+
| String| string| string |
248
+
| Boolean | bool | bool |
249
+
| DateTime | datetime | datetime |
250
+
| Decimal | decimal (15,2)| decimal (15, 2) |
251
+
| Enum | string | string |
252
+
| Date |date| datetime |
253
+
| BigDecimal | decimal (15,2) | decimal (15, 2) |
254
+
| Integer | int | int |
255
255
256
256
## Lookup activity properties
257
257
@@ -264,12 +264,13 @@ The following table shows the release stage and change logs for different versio
264
264
| Version | Release stage | Change log |
265
265
| :----------- | :------- |:------- |
266
266
| Version 1.0 | End of support announced | / |
267
-
| Version 2.0 |GA version available | • 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. <br><br>• `useEncryptedEndpoints` is not supported. <br><br>• SQL-92 query is not supported. |
267
+
| Version 2.0 |Public Preview | • 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. <br><br>• Date is read as date data type. <br><br>• SQL-92 query is not supported. <br><br>• `useEncryptedEndpoints` is not supported. |
268
268
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
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 (Preview)
270
270
271
-
1. In **Edit linked service** page, select 2.0 for version. For more information, see [linked service version 2.0 properties](#version-20).
271
+
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).
272
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
+
1. The data type mapping for the Quickbooks 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 Quickbooks](#data-type-mapping-for-quickbooks).
273
274
274
275
## Related content
275
276
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