适用于:
Azure 数据工厂
Azure Synapse Analytics
本文概述如何在 Azure 数据工厂或 Synapse Analytics 管道中使用复制活动从 Shopify 复制数据。 它是基于概述复制活动总体的复制活动概述一文。
重要
Shopify 连接器版本 1.0 处于 删除阶段。 建议将 Shopify 连接器 从版本 1.0 升级到 2.0。
支持的功能
此 Shopify 连接器支持以下功能:
| 支持的功能 | IR |
|---|---|
| 复制活动(源/-) | (1) (2) |
| Lookup 活动 | (1) (2) |
① Azure 集成运行时 ② 自承载集成运行时
如需可以用作源/接收器的数据存储的列表,请参阅支持的数据存储表。
该服务提供内置的驱动程序用于启用连接,因此使用此连接器无需手动安装任何驱动程序。
连接器支持此文章中的 Windows 版本。
由于 Shopify 官方弃用了 billing_on 字段,billing_on 列属性已从 Recurring_Application_Charges 和 UsageCharge 表中移除。
注释
对于版本 2.0,列名称保留 Shopify GraphQL 结构,例如 data.customers.edges.node.createdAt。 对于版本 1.0,列名使用简化的名称, Created_At例如。
入门
若要使用管道执行复制活动,可以使用以下工具或 SDK 之一:
使用 UI 创建到 Shopify 的链接服务
使用以下步骤在 Azure 门户 UI 中创建一个到 Shopify 的链接服务。
浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡,并选择“链接服务”,然后单击“新建”:
搜索“Shopify”并选择 Shopify 连接器。
配置服务详细信息、测试连接并创建新的链接服务。
连接器配置详细信息
对于特定于 Shopify 连接器的数据工厂实体,以下部分提供有关用于定义这些实体的属性的详细信息。
链接服务属性
Shopify 连接器现在支持版本 2.0。 请参阅本 部分 ,从版本 1.0 升级 Shopify 连接器版本。 关于属性详情,请参阅对应部分。
版本 2.0
应用版本 2.0 时,Shopify 链接服务支持以下属性:
| 属性 | 描述 | 必需 |
|---|---|---|
| 类型 | type 属性必须设置为:“Shopify” | 是 |
| 版本 | 指定的版本。 该值为 2.0。 |
是 |
| 主持人 | Shopify 服务器的终结点。 (即,mystore.myshopify.com) | 是 |
| accessToken | 可用于访问 Shopify 的数据的 API 访问令牌。 如果处于脱机模式,该令牌不会过期。 将此字段标记为 SecureString 以安全地存储它,或引用存储在 Azure Key Vault 中的机密。 | 是 |
示例:
{
"name": "ShopifyLinkedService",
"properties": {
"type": "Shopify",
"version": "2.0",
"typeProperties": {
"host" : "mystore.myshopify.com",
"accessToken": {
"type": "SecureString",
"value": "<accessToken>"
}
}
}
}
版本 1.0
应用版本 1.0 时,Shopify 链接服务支持以下属性:
| 属性 | 描述 | 必需 |
|---|---|---|
| 类型 | type 属性必须设置为:“Shopify” | 是 |
| 主持人 | Shopify 服务器的终结点。 (即,mystore.myshopify.com) | 是 |
| accessToken | 可用于访问 Shopify 的数据的 API 访问令牌。 如果处于脱机模式,该令牌不会过期。 将此字段标记为 SecureString 以安全地存储它,或引用存储在 Azure Key Vault 中的机密。 | 是 |
| useEncryptedEndpoints | 指定是否使用 HTTPS 加密数据源终结点。 默认值为 true。 | 否 |
| useHostVerification | 指定通过 TLS 进行连接时是否要求服务器证书中的主机名与服务器的主机名匹配。 默认值为 true。 | 否 |
| usePeerVerification | 指定通过 TLS 进行连接时是否要验证服务器的标识。 默认值为 true。 | 否 |
示例:
{
"name": "ShopifyLinkedService",
"properties": {
"type": "Shopify",
"typeProperties": {
"host" : "mystore.myshopify.com",
"accessToken": {
"type": "SecureString",
"value": "<accessToken>"
}
}
}
}
数据集属性
有关可用于定义数据集的各部分和属性的完整列表,请参阅数据集一文。 本部分提供 Shopify 数据集支持的属性列表。
要从 Shopify 复制数据,请将数据集的 type 属性设置为“ShopifyObject” 。 支持以下属性:
| 属性 | 描述 | 必需 |
|---|---|---|
| 类型 | 数据集的 type 属性必须设置为:“ShopifyObject” | 是 |
| tableName | 表的名称。 对于版本 2.0,表名称保留 Shopify GraphQL 结构,例如 customers。 对于版本 1.0,表名使用带前缀的简化名称, "Shopify"."Customers"例如。 |
否(如果指定了活动源中的“query”) |
注释
在数据集中指定时,无法读取tableName列。 若要读取此列, 请使用 query。
示例
{
"name": "ShopifyDataset",
"properties": {
"type": "ShopifyObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<Shopify linked service name>",
"type": "LinkedServiceReference"
}
}
}
复制活动属性
有关可用于定义活动的各部分和属性的完整列表,请参阅管道一文。 本部分提供 Shopify 数据源支持的属性列表。
Shopify 作为源
要从 Shopify 复制数据,请将复制活动中的源类型设置为“ShopifySource” 。 复制活动source部分支持以下属性:
| 属性 | 描述 | 必需 |
|---|---|---|
| 类型 | 复制活动 source 的 type 属性必须设置为:“ShopifySource” | 是 |
| 查询 | 对于版本 2.0,请使用 GraphQL 查询读取数据。 若要了解有关此查询的详细信息,请参阅 本文。 请注意,仅外部表支持分页查询,外部表中的每个记录最多可以包含 250 条内部表记录。 对于版本 1.0,请使用自定义 SQL 查询读取数据。 例如: "SELECT * FROM "Products" WHERE Product_Id = '123'"。 |
否(如果指定了数据集中的“tableName”) |
示例:
"activities":[
{
"name": "CopyFromShopify",
"type": "Copy",
"inputs": [
{
"referenceName": "<Shopify input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "ShopifySource"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Shopify 的数据类型映射
从 Shopify 复制数据时,以下映射适用于从 Shopify 的数据类型到服务使用的内部数据类型。 若要了解复制活动如何将源架构和数据类型映射到接收器,请参阅架构和数据类型映射。
| Shopify 数据类型 | 临时服务数据类型(适用于版本 2.0) | 临时服务数据类型(适用于版本 1.0) |
|---|---|---|
| 布尔 | 布尔 | 布尔 |
| int (整数) | int (整数) | int (整数) |
| UnsignedInt64 | UInt64 | UInt64 |
| Decimal | Decimal | Decimal |
| 漂浮 | Double | Double |
| String | String | String |
| 日期 | 日期 | 日期 |
| 日期时间 | 日期时间 | 日期时间 |
| ID | String | String |
| URL | String | String |
| 国家代码 | String | String |
| 其他自定义数据类型 | String | String |
查找活动属性
若要了解有关属性的详细信息,请查看 Lookup 活动。
Shopify 连接器生命周期和升级
下表显示了不同版本的 Shopify 连接器的发布阶段和更改日志:
| 版本 | 发布阶段 | 更改日志 |
|---|---|---|
| 版本 1.0 | Removed | 不適用。 |
| 版本 2.0 | 正式发布时间 | • 表名和列名保留 Shopify GraphQL 结构。 • 仅支持 GraphQL 查询。 • 链接服务中不支持 useEncryptedEndpoints、useHostVerification、usePeerVerification。 |
将 Shopify 连接器从版本 1.0 升级到版本 2.0
- 在 “编辑链接服务 ”页中,为版本选择 2.0。 有关详细信息,请参阅 链接服务版本 2.0 属性。
- 对于版本 2.0,请注意表和列名称保留 Shopify GraphQL 结构。
- 如果在复制活动源或引用版本 1.0 链接服务的查找活动中使用了 SQL 查询,则需要将其转换为 GraphQL 查询。 若要了解有关此查询的详细信息,请参阅 本文
相关内容
有关复制活动支持作为源和接收器的数据存储的列表,请参阅支持的数据存储。