Azure Data Factory veya Synapse Analytics kullanarak Shopify'dan veri kopyalama

ŞUNLARA UYGULANIR: Azure Data Factory Azure Synapse Analytics

İpucu

Microsoft Fabric'daki Data Factory, daha basit bir mimariye, yerleşik yapay zekaya ve yeni özelliklere sahip yeni nesil Azure Data Factory. Veri tümleştirmeyi yeni kullanmaya başladıysanız Fabric Data Factory ile başlayın. Mevcut ADF iş yükleri veri bilimi, gerçek zamanlı analiz ve raporlama genelinde yeni özelliklere erişmek için Fabric yükseltebilir.

• Fabric ücretsiz deneme başlatın.
• Azure Data Factory'den Data Factory'ye Microsoft Fabric'te Upgrade yapın.

Bu makalede, Shopify'dan veri kopyalamak için Azure Data Factory veya Synapse Analytics işlem hattında Kopyalama Etkinliğinin nasıl kullanılacağı açıklanmıştır. Kopyalama etkinliğine genel bakış makalesine dayanır ve bu makale, kopyalama etkinliğine genel bir bakış sunar.

Önemli

Shopify bağlayıcısı sürüm 1.0 kaldırma aşamasındadır. Shopify bağlayıcısını sürüm 1.0'dan 2.0'a yükseltmeniz önerilir.

Desteklenen özellikler

Bu Shopify bağlayıcısı aşağıdaki özellikler için desteklenir:

Desteklenen özellikler	Kızılötesi
Kopyalama etkinliği (kaynak/-)	(1) (2)
Arama etkinliği	(1) (2)

(1) Azure tümleştirme çalışma zamanı (2) Yerel barındırılan tümleştirme çalışma zamanı

Kaynak/havuz olarak desteklenen veri depolarının listesi için Desteklenen veri depoları tablosuna bakın.

Hizmet, bağlantıyı etkinleştirmek için yerleşik bir sürücü sağlar, bu nedenle bu bağlayıcıyı kullanarak herhangi bir sürücüyü el ile yüklemeniz gerekmez.

Bağlayıcı, bu article Windows sürümlerini destekler.

billing_on sütun özelliği, Shopify'ın billing_on alanını resmi olarak kullanımdan kaldırması nedeniyle Recurring_Application_Charges ve UsageCharge tablolarından kaldırıldı.

Uyarı

Sürüm 2.0 için sütun adları Shopify GraphQL yapısını (gibi) data.customers.edges.node.createdAtkorur. Sürüm 1.0 için sütun adları basitleştirilmiş adlar (örneğin, Created_At) kullanır.

Başlarken

Kopyalama etkinliğini bir işlem hattıyla gerçekleştirmek için aşağıdaki araçlardan veya SDK'lardan birini kullanabilirsiniz:

• Veri Kopyalama aracı
• Azure portalı
• .NET SDK
• Python SDK'sı
• Azure PowerShell
• REST API'si
• Azure Resource Manager şablonu

Kullanıcı arabirimini kullanarak Shopify'a bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde Shopify'a bağlı bir hizmet oluşturmak için aşağıdaki adımları kullanın.

1. Azure Data Factory veya Synapse çalışma alanınızdaki Yönet sekmesine göz atın ve Bağlı Hizmetler'i seçin, ardından Yeni'ye tıklayın:

   Azure Data Factory

   Azure Data Factory UI ile yeni bir bağlı hizmet oluşturma ekranının ekran görüntüsü.

   Azure Synapse

   

2. Shopify'ı arayın ve Shopify bağlayıcısını seçin.

   

3. Hizmet ayrıntılarını yapılandırın, bağlantıyı test edin ve yeni bağlı hizmeti oluşturun.

   

Bağlayıcı yapılandırma ayrıntıları

Aşağıdaki bölümlerde, Shopify bağlayıcısına özgü Data Factory varlıklarını tanımlamak için kullanılan özelliklerle ilgili ayrıntılar sağlanır.

Bağlı hizmet özellikleri

Shopify bağlayıcısı artık 2.0 sürümünü destekliyor. Shopify bağlayıcısı sürümünüzü sürüm 1.0'dan yükseltmek için bu bölüme bakın. Özellik ayrıntıları için ilgili bölümlere bakın.

• Sürüm 2.0
• Sürüm 1.0

Sürüm 2.0

Shopify bağlı hizmeti, 2.0 sürümünü uygularken aşağıdaki özellikleri destekler:

Özellik	Açıklama	Gerekli
Tip	Type özelliği şu şekilde ayarlanmalıdır: Shopify	Yes
version	Belirttiğiniz sürüm. Bu durumda değer 2.0 olur.	Yes
sunucu	Shopify sunucusunun uç noktası. (yani, mystore.myshopify.com)	Yes
accessToken	Shopify'ın verilerine erişmek için kullanılabilecek API erişim belirteci. Belirtecin süresi çevrimdışı moddaysa dolmaz. Bu alanı güvenli bir şekilde depolamak için SecureString olarak işaretleyin veya Azure Key Vault içinde depolanan bir gizli anahtara referans verin.	Yes

Örnek:

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

Sürüm 1.0

Shopify bağlı hizmeti, 1.0 sürümünü uygularken aşağıdaki özellikleri destekler:

Özellik	Açıklama	Gerekli
Tip	Type özelliği şu şekilde ayarlanmalıdır: Shopify	Yes
sunucu	Shopify sunucusunun uç noktası. (yani, mystore.myshopify.com)	Yes
accessToken	Shopify'ın verilerine erişmek için kullanılabilecek API erişim belirteci. Belirtecin süresi çevrimdışı moddaysa dolmaz. Bu alanı güvenli bir şekilde depolamak için SecureString olarak işaretleyin veya Azure Key Vault içinde depolanan bir gizli anahtara referans verin.	Yes
ŞifrelenmişUçNoktalarıKullan	Veri kaynağı uç noktalarının HTTPS kullanılarak şifrelenip şifrelenmediğini belirtir. Varsayılan değer doğru'dur.	Hayır
useHostVerification	TLS üzerinden bağlantı kurarken, sunucu sertifikasındaki ana bilgisayar adının sunucu ana bilgisayar adıyla eşleşmesinin gerekip gerekmediğini belirtir. Varsayılan değer doğru'dur.	Hayır
eş doğrulaması kullan	TLS üzerinden bağlanırken sunucunun kimliğinin doğrulanıp doğrulanmayacağını belirtir. Varsayılan değer doğru'dur.	Hayır

Örnek:

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

Veri kümesi özellikleri

Veri kümelerini tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için veri kümeleri makalesine bakın. Bu bölümde Shopify veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

Shopify'dan veri kopyalamak için veri kümesinin tür özelliğini ShopifyObject olarak ayarlayın. Aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tip	Veri kümesinin type özelliği şu şekilde ayarlanmalıdır: ShopifyObject	Yes
tabloAdı	Tablonun adı. Sürüm 2.0 için tablo adları Shopify GraphQL yapısını korur, örneğin customers. Sürüm 1.0 için, tablo adları önekleriyle basitleştirilmiş adlar kullanır; örneğin, "Shopify"."Customers".	Hayır (etkinlik kaynağında "sorgu" belirtilirse)

Uyarı

Etiketler sütunu, veri kümesinde tableName belirttiğinizde okunamıyor. Bu sütunu okumak için kullanın query.

Örnek

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

Kopyalama etkinliği özellikleri

Etkinlikleri tanımlamak için kullanılabilecek tüm bölümlerin ve özelliklerin listesi için Yapılandırma Hatları makalesine bakın. Bu bölümde Shopify kaynağı tarafından desteklenen özelliklerin listesi sağlanır.

Shopify kaynağı olarak

Shopify'dan veri kopyalamak için kopyalama etkinliğindeki kaynak türünü ShopifySource olarak ayarlayın. Kopyalama etkinliği kaynağı bölümünde aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tip	Kopyalama etkinliği kaynağının type özelliği şu şekilde ayarlanmalıdır: ShopifySource	Yes
query	Sürüm 2.0'da, verileri okumak için GraphQL sorgusunu kullanın. Bu sorgu hakkında daha fazla bilgi edinmek için bu makaleye bakın. Sayfalandırmanın yalnızca dış tablolar için desteklendiğini ve dış tablodaki her kaydın en fazla 250 iç tablo kaydı içerebileceğini unutmayın. Buna ek olarak, iç içe tablolar için sayfalandırma desteklenmez. Sürüm 1.0 için verileri okumak için özel SQL sorgusunu kullanın. Örneğin: "SELECT * FROM "Products" WHERE Product_Id = '123'".	Hayır (veri kümesinde "tableName" belirtilirse)

Örnek:

"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 için veri türü eşlemesi

Shopify'dan veri kopyaladığınızda, Aşağıdaki eşlemeler Shopify'ın veri türlerinden hizmet tarafından kullanılan iç veri türlerine uygulanır. Kopyalama etkinliğinin kaynak şemayı ve veri türünü havuza nasıl eşlediğini öğrenmek için bkz . Şema ve veri türü eşlemeleri.

Shopify veri türü	Ara hizmet veri türü (sürüm 2.0 için)	Ara hizmet veri türü (sürüm 1.0 için)
Boolean	Boolean	Boolean
Int	Int	Int
UnsignedInt64	UInt64	UInt64
Decimal	Decimal	Decimal
Yüzmek	Double	Double
String	String	String
Date	Date	Date
DateTime	DateTime	DateTime
Kimlik	String	String
URL	String	String
Ülke Kodu	String	String
Diğer özel veri türleri	String	String

Arama etkinliği özellikleri

Özellikler hakkında ayrıntılı bilgi edinmek için Arama etkinliği'ne bakın.

Shopify bağlayıcı yaşam döngüsü ve yükseltmesi

Aşağıdaki tabloda Shopify bağlayıcısının farklı sürümleri için sürüm aşaması ve değişiklik günlükleri gösterilmektedir:

Sürüm	Yayın aşaması	Değişiklik Kaydı
Sürüm 1.0	Removed	Uygulanamaz.
Sürüm 2.0	Genel kullanılabilirlik	• Tablo ve sütun adları Shopify GraphQL yapısını korur. • Yalnızca GraphQL sorgusunu destekleyin. • useEncryptedEndpoints, , useHostVerificationbağlı usePeerVerification hizmette desteklenmez.

Shopify bağlayıcısını sürüm 1.0'dan sürüm 2.0'a yükseltme

1. Bağlı hizmeti düzenle sayfasında sürüm için 2.0'ı seçin. Daha fazla bilgi için bkz. bağlı hizmet 2.0 sürümü özellikleri.
2. Sürüm 2.0 için tablo ve sütun adlarının Shopify GraphQL yapısını koruduğunu unutmayın.
3. Kopyalama etkinliği kaynağında veya sürüm 1.0 bağlı hizmetine başvuran arama etkinliğinde SQL sorgusu kullanıyorsanız, bunları GraphQL sorgusuna dönüştürmeniz gerekir. Bu sorgu hakkında daha fazla bilgi edinmek için bu makaleye bakın

İlgili içerik

Kopyalama etkinliği tarafından kaynak ve havuz olarak desteklenen veri depolarının listesi için bkz . desteklenen veri depoları.