Azure Data Factory veya Synapse Analytics kullanarak Square'den veri kopyalama

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Bu makalede, Verileri Kare'den kopyalamak için Azure Data Factory veya Synapse Analytics işlem hattında Kopyalama Etkinliğinin nasıl kullanılacağı özetlenmiştir. Kopyalama etkinliğine genel bir genel bakış sunan kopyalama etkinliğine genel bakış makalesini oluşturur.

Ö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	IR
Kopyalama etkinliği (kaynak/-)	(1) (2)
Arama etkinliği	(1) (2)

(1) Azure tümleştirme çalışma zamanı (2) Şirket içinde 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 makaledeki Windows sürümlerini destekler.

Önkoşullar

Veri deponuz bir şirket içi ağ, Azure sanal ağı veya Amazon Sanal Özel Bulut içinde bulunuyorsa, şirket içinde barındırılan tümleştirme çalışma zamanını buna bağlanmak için 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 Azure Integration Runtime IP'lerini izin verme listesine ekleyebilirsiniz.

Azure Data Factory'deki yönetilen sanal ağ tümleştirme çalışma zamanı özelliğini kullanarak, şirket içi ağa erişmek için kendi barındırılan bir tümleştirme çalışma zamanı yüklemenize veya yapılandırmanıza gerek yoktur.

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:

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

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ızda 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 Synapse

   

2. Kare araması yapın ve Kare 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, 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
• Sürüm 1.0

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
Tür	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
host	Kare örneğinin URL'si. (örn. mystore.mysquare.com)	Yes
clientId	Square uygulamanızla ilişkilendirilmiş istemci kimliği.	Yes
clientSecret	Square uygulamanızla ilişkili istemci gizli dizisi. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli diziye başvurun.	Yes
accessToken	Square'den alınan erişim belirteci. Kimliği doğrulanmış bir kullanıcıdan açık izinler isteyerek Kare hesabına sınırlı erişim verir. 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. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli diziye başvurun. Erişim belirteci türleri hakkında daha fazla bilgi için bkz. Erişim belirteci türleri.	Yes
refreshToken	Kare'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. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyinFactory veya Azure Key Vault'ta depolanan bir gizli diziye başvurun.	Hayır
connectVia	Veri deposuna bağlanmak için kullanılacak Integration Runtime. Belirtilmezse, varsayılan Azure Integration Runtime'ı kullanır. Şirket içinde 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
Tür	tür özelliği şu şekilde ayarlanmalıdır: Kare	Yes
connectionProperties	Square'e bağlanmayı tanımlayan bir özellik grubu.	Yes
altında connectionProperties:
host	Kare örneğinin URL'si. (örn. mystore.mysquare.com)	Yes
clientId	Square uygulamanızla ilişkilendirilmiş istemci kimliği.	Yes
clientSecret	Square uygulamanızla ilişkili istemci gizli dizisi. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli diziye başvurun.	Yes
accessToken	Square'den alınan erişim belirteci. Kimliği doğrulanmış bir kullanıcıdan açık izinler isteyerek Kare hesabına sınırlı erişim verir. 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. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli diziye başvurun. Erişim belirteci türleri hakkında daha fazla bilgi için bkz. Erişim belirteci türleri.	Yes
refreshToken	Kare'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. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyinFactory veya Azure Key Vault'ta depolanan bir gizli diziye başvurun.	Hayır
useEncryptedEndpoints	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ğlanırken sunucunun sertifikasındaki ana bilgisayar adının sunucunun ana bilgisayar adıyla eşleşip eşleşmeymeyeceğini belirtir. Varsayılan değer doğru'dur.	Hayır
usePeerVerification	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

Kare, 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ı gerçekleştirmek için kapsamlı MERCHANT_PROFILE_READ bir OAuth erişim belirteci almak gerekir. Diğer tablolara erişim izinleri için bkz . Square OAuth İzinleri Başvurusu.

Kişisel erişim belirteci aracılığıyla kimlik doğrulaması yalnızca gerektirirkenaccessToken, OAuth ile kimlik doğrulaması ve accessTokengerektirirrefreshToken. 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
Tür	Veri kümesinin tür özelliği şu şekilde ayarlanmalıdır: SquareObject	Yes
tableName	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ğinin özellikleri

Etkinlikleri tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için İşlem hatları makalesine bakın. Bu bölüm, Kare 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
Tür	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.
Uzaklık ile 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	• Şirket içinde barındırılan tümleştirme çalışma zamanı sürümü 5.56.0.0 veya üzeri olmalıdır. • Uzaklıklı Tarih, Zaman Damgası ve Zaman Damgası Dize 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ümlerle şirket içinde barındırılan 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ı.