Skip to content

Commit 575026b

Browse files
authored
Merge pull request #304112 from Lucky-Wang16/0812-Update_Shopify_V2
Update Shopify V2
2 parents cec475f + b03468e commit 575026b

File tree

3 files changed

+86
-3
lines changed

3 files changed

+86
-3
lines changed

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,9 @@ For comprehensive details on support levels and recommended usage at each stage,
7878
| [Salesforce Service Cloud V1](connector-salesforce-service-cloud-legacy.md) | / | End of support | June 30, 2025 | September 30, 2025 |
7979
| [ServiceNow V2](connector-servicenow.md) | / | GA | / | / |
8080
| [ServiceNow V1](connector-servicenow-legacy.md) | / | End of support | June 30, 2025 | September 30, 2025 |
81+
| [Shopify (Preview)](connector-shopify.md) | version 2.0 | Public Preview | / |/
82+
| | version 1.0 | End of support announced | October 22, 2025 | November 22, 2025 |
83+
| [Salesforce V2](connector-salesforce.md) | / |
8184
| [Snowflake V2](connector-snowflake.md) | version 1.1 | GA | / | / |
8285
| | version 1.0 | GA | / | / |
8386
| [Snowflake V1](connector-snowflake-legacy.md) | / | End of support | June 30, 2025 | September 30, 2025 |

articles/data-factory/connector-shopify.md

Lines changed: 83 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: jianleishen
77
ms.subservice: data-movement
88
ms.topic: conceptual
99
ms.custom: synapse
10-
ms.date: 11/05/2024
10+
ms.date: 08/12/2025
1111
---
1212

1313
# Copy data from Shopify using Azure Data Factory or Synapse Analytics (Preview)
@@ -18,6 +18,9 @@ This article outlines how to use the Copy Activity in an Azure Data Factory or S
1818
> [!IMPORTANT]
1919
> This connector 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/).
2020
21+
> [!IMPORTANT]
22+
> The Shopify connector version 2.0 (Preview) provides improved native Shopify support. If you are using Shopify connector version 1.0 in your solution, please [upgrade the Shopify connector](#upgrade-the-shopify-connector-from-version-10-to-version-20) before **October 22, 2025**. Refer to this [section](#shopify-connector-lifecycle-and-upgrade) for details on the difference between version 2.0 (Preview) and version 1.0.
23+
2124
## Supported capabilities
2225

2326
This Shopify connector is supported for the following capabilities:
@@ -37,6 +40,9 @@ The connector supports the Windows versions in this [article](create-self-hosted
3740

3841
The billing_on column property was removed from the Recurring_Application_Charges and UsageCharge tables due to Shopify's official deprecation of billing_on field.
3942

43+
> [!Note]
44+
> For version 2.0 (Preview), column names retain the Shopify GraphQL structure, such as `data.customers.edges.node.xx`. For version 1.0, column names use simplified names.
45+
4046
## Getting started
4147

4248
[!INCLUDE [data-factory-v2-connector-get-started](includes/data-factory-v2-connector-get-started.md)]
@@ -70,7 +76,44 @@ The following sections provide details about properties that are used to define
7076

7177
## Linked service properties
7278

73-
The following properties are supported for Shopify linked service:
79+
The Shopify connector now supports version 2.0 (Preview). Refer to this [section](#upgrade-the-shopify-connector-from-version-10-to-version-20) to upgrade your Shopify connector version from version 1.0. For the property details, see the corresponding sections.
80+
81+
- [Version 2.0 (Preview)](#version-20)
82+
- [Version 1.0](#version-10)
83+
84+
### <a name="version-20"></a>Version 2.0 (Preview)
85+
86+
The Shopify linked service supports the following properties when apply version 2.0 (Preview):
87+
88+
| Property | Description | Required |
89+
|:--- |:--- |:--- |
90+
| type | The type property must be set to: **Shopify** | Yes |
91+
| version | The version that you specify. The value is `2.0`. | Yes |
92+
| host | The endpoint of the Shopify server. (that is, mystore.myshopify.com) | Yes |
93+
| accessToken | The API access token that can be used to access Shopify’s data. The token does not expire if it is offline mode. Mark this field as a SecureString to store it securely, or [reference a secret stored in Azure Key Vault](store-credentials-in-key-vault.md). | Yes |
94+
95+
**Example:**
96+
97+
```json
98+
{
99+
"name": "ShopifyLinkedService",
100+
"properties": {
101+
"type": "Shopify",
102+
"version": "2.0",
103+
"typeProperties": {
104+
"host" : "mystore.myshopify.com",
105+
"accessToken": {
106+
"type": "SecureString",
107+
"value": "<accessToken>"
108+
}
109+
}
110+
}
111+
}
112+
```
113+
114+
### Version 1.0
115+
116+
The Shopify linked service supports the following properties when apply version 1.0:
74117

75118
| Property | Description | Required |
76119
|:--- |:--- |:--- |
@@ -108,7 +151,7 @@ To copy data from Shopify, set the type property of the dataset to **ShopifyObje
108151
| Property | Description | Required |
109152
|:--- |:--- |:--- |
110153
| type | The type property of the dataset must be set to: **ShopifyObject** | Yes |
111-
| tableName | Name of the table. | No (if "query" in activity source is specified) |
154+
| tableName | Name of the table. | Yes for version 2.0 (Preview).<br> No for version 1.0 (if "query" in activity source is specified) |
112155

113156
**Example**
114157

@@ -140,6 +183,9 @@ To copy data from Shopify, set the source type in the copy activity to **Shopify
140183
| type | The type property of the copy activity source must be set to: **ShopifySource** | Yes |
141184
| query | Use the custom SQL query to read data. For example: `"SELECT * FROM "Products" WHERE Product_Id = '123'"`. | No (if "tableName" in dataset is specified) |
142185

186+
> [!Note]
187+
> `query` is not supported in version 2.0 (Preview).
188+
143189
**Example:**
144190

145191
```json
@@ -172,10 +218,44 @@ To copy data from Shopify, set the source type in the copy activity to **Shopify
172218
]
173219
```
174220

221+
## Data type mapping for Shopify
222+
223+
When you copy data from Shopify, the following mappings apply from Shopify'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).
224+
225+
| Shopify data type | Interim service data type (for version 2.0 (Preview)) | Interim service data type (for version 1.0) |
226+
|------------------|----------------------------------|----------------------|
227+
| Boolean | Boolean | Boolean |
228+
| Int | Int | Int |
229+
| UnsignedInt64 | UInt64 | UInt64 |
230+
| Decimal | Decimal | Decimal |
231+
| Float | Double | Double |
232+
| String | String | String |
233+
| Date | Date | Date |
234+
| DateTime | DateTime | DateTime |
235+
| ID | String | String |
236+
| URL | String | String |
237+
| CountryCode | String | String |
238+
| Other custom datatypes | String | String |
239+
240+
175241
## Lookup activity properties
176242

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

245+
## Shopify connector lifecycle and upgrade
246+
247+
The following table shows the release stage and change logs for different versions of the Shopify connector:
248+
249+
| Version | Release stage | Change log |
250+
| :----------- | :------- |:------- |
251+
| Version 1.0 | End of support announced | / |
252+
| Version 2.0 | Public Preview | • Column names retain the Shopify GraphQL structure, such as `data.customers.edges.node.xx`. <br><br> • `useEncryptedEndpoints`, `useHostVerification`, `usePeerVerification` are not supported in the linked service. <br><br> • `query` is not supported. |
253+
254+
### <a name="upgrade-the-shopify-connector-from-version-10-to-version-20"></a> Upgrade the Shopify connector from version 1.0 to version 2.0 (Preview)
255+
256+
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).
257+
1. For version 2.0 (Preview), note that column names retain the Shopify GraphQL structure, such as `data.customers.edges.node.xx`. For version 1.0, column names use simplified names.
258+
1. `query` is only supported in version 1.0. You should use the `tableName` instead of `query` in version 2.0 (Preview).
179259

180260
## Related content
181261
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).
595 Bytes
Loading

0 commit comments

Comments
 (0)