Azure Data Factory または Synapse Analytics を使用して Shopify からデータをコピーする (プレビュー)

適用対象: Azure Data Factory Azure Synapse Analytics

この記事では、Azure Data Factory または Synapse Analytics パイプラインでコピー アクティビティを使用して、Shopify からデータをコピーする方法について説明します。 この記事は、コピー アクティビティの概要を示しているコピー アクティビティの概要に関する記事に基づいています。

サポートされる機能

この Shopify コネクタは、次の機能でサポートされます。

① Azure 統合ランタイム ② セルフホステッド統合ランタイム

ソースおよびシンクとしてサポートされているデータ ストアの一覧については、「サポートされているデータ ストア」の表を参照してください。

このサービスでは接続を有効にする組み込みのドライバーが提供されるので、このコネクタを使用してドライバーを手動でインストールする必要はありません。

コネクタは、この記事の Windows バージョンをサポートしています。

billing_on 列のプロパティは、Shopify が公式に billing_on フィールドを廃止したため、Recurring_Application_Charges および UsageCharge テーブルから削除されました。

作業の開始

パイプラインでコピー アクティビティを実行するには、次のいずれかのツールまたは SDK を使用します。

• データ コピー ツール
• Azure ポータル
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager テンプレート

UI を使用して Shopify のリンク サービスを作成する

次の手順を使用して、Azure portal UI で Shopify のリンク サービスを作成します。

1. Azure Data Factory または Synapse ワークスペースの [管理] タブに移動し、[リンク サービス] を選択して、[新規] をクリックします。

   • Azureデータファクトリー
   • Azure Synapse

   

2. Shopify を検索し、Shopify コネクタを選択します。

   

3. サービスの詳細を構成し、接続をテストして、新しいリンク サービスを作成します。

   

コネクタの構成の詳細

次のセクションでは、Shopify コネクタに固有の Data Factory エンティティの定義に使用されるプロパティについて詳しく説明します。

リンクされたサービスのプロパティ

Shopify コネクタでバージョン 2.0 (プレビュー) がサポートされるようになりました。 Shopifyコネクタのバージョンをバージョン1.0からアップグレードするには、この セクション を参照してください。 プロパティの詳細については、対応するセクションを参照してください。

• バージョン 2.0 (プレビュー)
• バージョン 1.0

バージョン 2.0 (プレビュー)

Shopify のリンクされたサービスでは、バージョン 2.0 (プレビュー) を適用すると、次のプロパティがサポートされます。

例:

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

バージョン 1.0

Shopify のリンクされたサービスでは、バージョン 1.0 を適用すると、次のプロパティがサポートされます。

例:

{
    "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 に設定します。 コピー アクティビティの source セクションでは、次のプロパティがサポートされます。

例:

"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 のデータ型からサービスで使用される内部データ型へのマッピングが次のように適用されます。 コピー アクティビティでソースのスキーマとデータ型がシンクにマッピングされるしくみについては、スキーマとデータ型のマッピングに関する記事を参照してください。

Lookup アクティビティのプロパティ

プロパティの詳細については、Lookup アクティビティに関するページを参照してください。

Shopify コネクタのライフサイクルとアップグレード

次の表は、Shopify コネクタのさまざまなバージョンのリリース ステージと変更ログを示しています。

Shopify コネクタをバージョン 1.0 からバージョン 2.0 (プレビュー) にアップグレードする

1. [ リンクされたサービスの編集] ページで、バージョンとして 2.0 (プレビュー) を選択します。 詳細については、 リンクされたサービス バージョン 2.0 (プレビュー) のプロパティを参照してください。
2. バージョン 2.0 (プレビュー) の場合、列名には、 data.customers.edges.node.xxなどの Shopify GraphQL 構造が保持されることに注意してください。 バージョン 1.0 では、列名は簡略化された名前を使用します。
3. query はバージョン 1.0 でのみサポートされています。 バージョン 2.0 (プレビュー) でtableNameするのではなく、queryを使用する必要があります。

関連コンテンツ

Copy アクティビティでソースおよびシンクとしてサポートされるデータ ストアの一覧については、サポートされるデータ ストアに関するセクションを参照してください。