Azure Data Factory veya Synapse Analytics kullanarak Square'den 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.

Bu makalede, verileri Square'den kopyalamak için bir Azure Data Factory veya Synapse Analytics işlem hattında Kopyalama Etkinliğinin nasıl kullanılacağı özetlenmiştir. Kopyalama etkinliğine genel bakış makalesine dayanır ve bu makale, kopyalama etkinliğine genel bir bakış sunar.

Önemli

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

Desteklenen özellikler

Bu Kare 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.

Önkoşullar

Veri deponuz bir yerel ağ, Azure sanal ağ veya Amazon Sanal Özel Bulut içinde bulunuyorsa, ona bağlanmak için kendinden barındırılan bir tümleştirme çalışma zamanı yapılandırmanız gerekir.

Veri deponuz yönetilen bir bulut veri hizmetiyse Azure Integration Runtime kullanabilirsiniz. Erişim, güvenlik duvarı kurallarında onaylanan IP'ler ile sınırlıysa, izin verme listesine Azure Integration Runtime IP ekleyebilirsiniz.

Şirket içi ağa erişmek için, şirket içinde barındırılan tümleştirme çalışma zamanı yüklemeden ve yapılandırmadan Azure Data Factory yönetilen sanal ağ tümleştirme çalışma zamanı özelliğini de kullanabilirsiniz.

Data Factory tarafından desteklenen ağ güvenlik mekanizmaları ve seçenekleri hakkında daha fazla bilgi için bkz. Veri erişim stratejileri.

Not

Sürüm 2.0, yerel tümleştirme çalışma zamanı sürüm 5.56.0.0 veya üstü ile desteklenir.

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:

Kullanıcı arabirimini kullanarak Square'e bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde Square'e 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 UI ile yeni bir bağlı hizmet oluşturma ekranının ekran görüntüsü.

  2. Square araması yapın ve Square bağlayıcısını seçin.

    Kare konnektörünün ekran görüntüsü.

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

    Square için bağlı hizmet yapılandırmasının ekran görüntüsü.

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

Aşağıdaki bölümlerde, Kare 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

Square bağlayıcısı artık 2.0 sürümünü destekliyor. Square bağlayıcı 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

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

Özellik Açıklama Gerekli
Tip tür özelliği şu şekilde ayarlanmalıdır: Kare Yes
version Belirttiğiniz sürüm. Bu durumda değer 2.0 olur. Yes
sunucu Kare örneğinin URL'si. (ör. mystore.mysquare.com) Yes
clientId Square uygulamanızla ilişkilendirilmiş istemci kimliği. Yes
clientSecret Square uygulamanızla ilişkili istemci sırrı. 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
accessToken Square'den alınan erişim belirteci. Kimliği doğrulanmış bir kullanıcıdan açık izinler isteyerek Square hesabına sınırlı erişim sağlar. OAuth erişim belirteçlerinin süresi verildikten 30 gün sonra dolar, ancak yenileme belirteçlerinin süresi dolmaz. Erişim belirteçleri yenileme belirteci ile yenilenebilir.
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. Erişim belirteci türleri hakkında daha fazla bilgi için bkz. Erişim belirteci türleri.		 Yes
Yenileme Jetonu (refreshToken) Square'den alınan yenileme belirteci. Geçerli erişim belirteçlerinin süresi dolduğunda yeni erişim belirteçleri almak için kullanılır.
Bu alanı güvenli bir şekilde depolamak için SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli bilgiye referans verin.		 Hayır
connectVia Veri deposuna bağlanmak için kullanılacak Integration Runtime. Belirtilmezse, varsayılan Azure Integration Runtime kullanır. Kendi kendine barındırılan tümleştirme çalışma zamanını kullanabilirsiniz ve sürümü 5.56.0.0 veya üzeri olmalıdır. Hayır

Örnek:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "version": "2.0",
        "typeProperties": {
            "host": "<e.g. mystore.mysquare.com>", 
            "clientId": "<client ID>", 
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            }, 
            "accessToken": {
                "type": "SecureString",
                "value": "<access token>"
            }, 
            "refreshToken": {
                "type": "SecureString",
                "value": "<refresh token>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Sürüm 1.0

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

Özellik Açıklama Gerekli
Tip tür özelliği şu şekilde ayarlanmalıdır: Kare Yes
bağlantıÖzellikleri Square'e bağlanmayı tanımlayan bir özellik grubu. Yes
altında connectionProperties:
sunucu Kare örneğinin URL'si. (ör. mystore.mysquare.com) Yes
clientId Square uygulamanızla ilişkilendirilmiş istemci kimliği. Yes
clientSecret Square uygulamanızla ilişkili istemci sırrı. 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
accessToken Square'den alınan erişim belirteci. Kimliği doğrulanmış bir kullanıcıdan açık izinler isteyerek Square hesabına sınırlı erişim sağlar. OAuth erişim belirteçlerinin süresi verildikten 30 gün sonra dolar, ancak yenileme belirteçlerinin süresi dolmaz. Erişim belirteçleri yenileme belirteci ile yenilenebilir.
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. Erişim belirteci türleri hakkında daha fazla bilgi için bkz. Erişim belirteci türleri.		 Yes
Yenileme Jetonu (refreshToken) Square'den alınan yenileme belirteci. Geçerli erişim belirteçlerinin süresi dolduğunda yeni erişim belirteçleri almak için kullanılır.
Bu alanı güvenli bir şekilde depolamak için SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli bilgiye referans verin.		 Hayır
Ş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
connectVia Veri deposuna bağlanmak için kullanılacak Integration Runtime. Belirtilmezse, varsayılan Azure Integration Runtime kullanır. Hayır

Örnek:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "typeProperties": {
            "connectionProperties": {
                "host": "<e.g. mystore.mysquare.com>", 
                "clientId": "<client ID>", 
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<clientSecret>"
                }, 
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refresh token>"
                }, 
                "useEncryptedEndpoints": true, 
                "useHostVerification": true, 
                "usePeerVerification": true 
            }
        }
    }
}

Erişim belirteci türleri

Square, iki tür erişim belirteci destekler: kişisel ve OAuth.

  • Kişisel erişim belirteçleri, kendi Square hesabınızdaki kaynaklara sınırsız Connect API erişimi elde etmek için kullanılır.

  • OAuth erişim belirteçleri, herhangi bir Square hesabına kimliği doğrulanmış ve kapsamlı Connect API erişimi almak için kullanılır. Uygulamanız hesap sahipleri adına diğer Square hesaplarındaki kaynaklara eriştiğinde bunları kullanın. OAuth erişim belirteçleri kendi Square hesabınızdaki kaynaklara erişmek için de kullanılabilir.

    Önemli

    Bağlı hizmette Test bağlantısını gerçekleştirmek için, kapsamlı bir OAuth erişim belirteci almak MERCHANT_PROFILE_READ gerekir. Diğer tablolara erişim izinleri için bkz. Square OAuth İzinleri Referansı.

Kişisel erişim belirteci aracılığıyla kimlik doğrulama yalnızca accessToken gerektirirken, OAuth ile kimlik doğrulama accessToken ve refreshToken gerektirir. Buradan erişim belirtecini almayı öğrenin.

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 Kare veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

Verileri Square'den kopyalamak için veri kümesinin type özelliğini SquareObject olarak ayarlayın. Aşağıdaki özellikler desteklenir:

Özellik Açıklama Gerekli
Tip Veri kümesinin tür özelliği şu şekilde ayarlanmalıdır: SquareObject Yes
tabloAdı Tablonun adı. Sürüm 2.0 için evet.
Sürüm 1.0 için hayır (etkinlik kaynağında "sorgu" belirtilirse)

Örnek

{
    "name": "SquareDataset",
    "properties": {
        "type": "SquareObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Square 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üm, Square kaynağı tarafından desteklenen özelliklerin listesini sağlar.

Kaynak olarak kare

Verileri Square'den kopyalamak için kopyalama etkinliğindeki kaynak türünü SquareSource 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: SquareSource Yes
query Verileri okumak için özel SQL sorgusunu kullanın. Örneğin: "SELECT * FROM Business". Hayır (veri kümesinde "tableName" belirtilirse)

Not

query sürüm 2.0'da desteklenmez.

Örnek:

"activities":[
    {
        "name": "CopyFromSquare",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Square input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SquareSource",
                "query": "SELECT * FROM Business"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Kare için veri türü eşlemesi

Verileri Square'den kopyaladığınızda, aşağıdaki eşlemeler Square'in 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.

Kare 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)
String String String
Integer Int32 Int32
Long Int64 Int64
Boolean Boolean Boolean
Date String Desteklenmiyor.
Zaman Damgası String Desteklenmiyor.
Ofsetli zaman damgası String Desteklenmiyor.
Süre (tam) String String
Süre (yalnızca saat) String String
Money Int64 Int64

Arama etkinliği özellikleri

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

Kare bağlayıcı yaşam döngüsü ve yükseltme

Aşağıdaki tabloda Square bağlayıcısının farklı sürümleri için yayın 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 • Kendinden barındırılan tümleştirme çalışma zamanı sürümü 5.56.0.0 veya üzeri olmalıdır.

• Tarih, Zaman Damgası ve Ofsetli Zaman Damgası, String veri türü olarak okunur.

• useEncryptedEndpoints, , useHostVerificationbağlı usePeerVerification hizmette desteklenmez.

• query desteklenmez.

Square 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. Square bağlı hizmet sürümü 2.0 için veri türü eşlemesi, sürüm 1.0'dan farklıdır. En son veri türü eşlemesini öğrenmek için bkz. Kare için veri türü eşleme.

  3. 5.56.0.0 veya üzeri sürümlerde kendinden barındırılan bir tümleştirme çalışma zamanı uygulayın.

  4. query yalnızca sürüm 1.0'da desteklenir. tableName öğesini query yerine 2.0 sürümünde kullanmanız gerekir.

İlgili içerik

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

  • Last updated on