使用 Azure 数据工厂或 Synapse Analytics（预览版）从 Shopify 复制数据

适用于： Azure 数据工厂 Azure Synapse Analytics

本文概述如何在 Azure 数据工厂或 Synapse Analytics 管道中使用复制活动从 Shopify 复制数据。 它是基于概述复制活动总体的复制活动概述一文。

支持的功能

此 Shopify 连接器支持以下功能：

① Azure 集成运行时 ② 自承载集成运行时

如需可以用作源/接收器的数据存储的列表，请参阅支持的数据存储表。

该服务提供用于启用连接的内置驱动程序，因此使用此连接器无需手动安装任何驱动程序。

连接器支持此文章中的 Windows 版本。

由于 Shopify 官方弃用了 billing_on 字段，billing_on 列属性已从 Recurring_Application_Charges 和 UsageCharge 表中移除。

入门

若要使用管道执行复制活动，可以使用以下工具或 SDK 之一：

• 复制数据工具
• Azure 门户
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager 模板

使用 UI 创建到 Shopify 的链接服务

使用以下步骤在 Azure 门户 UI 中创建一个到 Shopify 的链接服务。

1. 浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡并选择“链接服务”，然后单击“新建”：

   • Azure 数据工厂
   • Azure Synapse

   

2. 搜索“Shopify”并选择 Shopify 连接器。

   

3. 配置服务详细信息，测试连接，然后创建新的链接服务。

   

连接器配置详细信息

对于特定于 Shopify 连接器的数据工厂实体，以下部分提供有关用于定义这些实体的属性的详细信息。

链接服务属性

Shopify 连接器现在支持 2.0 版（预览版）。 请参阅此部分，了解如何从 1.0 版升级 Shopify 连接器版本。 关于属性详情，请参阅对应部分。

• 版本 2.0（预览版）
• 版本 1.0

版本 2.0（预览版）

应用 2.0 版（预览版）时，Shopify 链接服务支持以下属性：

示例：

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "version": "2.0",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

版本 1.0

应用 1.0 版时，Shopify 链接服务支持以下属性：

示例：

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

数据集属性

有关可用于定义数据集的各部分和属性的完整列表，请参阅数据集一文。 本部分提供 Shopify 数据集支持的属性列表。

要从 Shopify 复制数据，请将数据集的 type 属性设置为“ShopifyObject”。 支持以下属性：

示例

{
    "name": "ShopifyDataset",
    "properties": {
        "type": "ShopifyObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Shopify linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

复制活动属性

有关可用于定义活动的各部分和属性的完整列表，请参阅管道一文。 本部分提供 Shopify 数据源支持的属性列表。

Shopify 作为源

要从 Shopify 复制数据，请将复制活动中的源类型设置为“ShopifySource”。 复制活动源部分支持以下属性：

示例：

"activities":[
    {
        "name": "CopyFromShopify",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Shopify input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ShopifySource",
                "query": "SELECT * FROM \"Products\" WHERE Product_Id = '123'"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Shopify 的数据类型映射

从 Shopify 复制数据时，将应用下列从 Shopify 的数据类型到服务使用的内部数据类型的映射。 若要了解复制活动如何将源架构和数据类型映射到接收器，请参阅架构和数据类型映射。

“查找”活动属性

若要详细了解这些属性，请查看“查找”活动。

Shopify 连接器生命周期和升级

下表显示了不同版本的 Shopify 连接器的发布阶段和更改日志：

将 Shopify 连接器从 1.0 版升级到 2.0 版（预览版）

1. 在“编辑链接服务”页中，选择“2.0 (预览版)”作为版本。 有关详细信息，请参阅链接服务 2.0 版（预览版）属性。
2. 对于 2.0 版（预览版），请注意，表名和列名保留 Shopify GraphQL 结构。
3. query 仅在版本 1.0 中受支持。 在版本 2.0（预览版）中应使用 tableName 而非 query。

相关内容

有关复制活动支持作为源和接收器的数据存储的列表，请参阅支持的数据存储。