Azure Data Factory veya Synapse Analytics kullanarak Square'den veri kopyalama (Önizleme)

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

Bahşiş

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

Bu bağlayıcı şu anda önizleme aşamasındadır. Bunu deneyebilir ve bize geri bildirim gönderebilirsiniz. Çözümünüzde bir önizleme bağlayıcısı bağımlılığı olmasını istiyorsanız lütfen Azure desteğine başvurun.

Dekont

Şu anda bu bağlayıcı korumalı alan hesaplarını desteklemez.

Desteklenen özellikler

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

Desteklenen özellikler	IR
Kopyalama etkinliği (kaynak/-)	① ②
Arama etkinliği	① ②

(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şlarken

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

• Veri Kopyalama aracı
• Azure portal
• .NET SDK'sı
• Python SDK'sı
• Azure PowerShell
• The 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ğlan veya 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

Aşağıdaki özellikler Square bağlı hizmeti için desteklenir:

Özellik	Açıklama	Gerekli
type	tür özelliği şu şekilde ayarlanmalıdır: Kare	Evet
Connectionproperties	Square'e bağlanmayı tanımlayan bir özellik grubu.	Evet
altında connectionProperties:
host	Kare örneğinin URL'si. (örn. mystore.mysquare.com)	Evet
clientId	Square uygulamanızla ilişkilendirilmiş istemci kimliği.	Evet
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.	Evet
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.	Evet
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.	No
useEncryptedEndpoints	Veri kaynağı uç noktalarının HTTPS kullanılarak şifrelenip şifrelenmediğini belirtir. Varsayılan değer doğru'dur.	No
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.	No
usePeerVerification	TLS üzerinden bağlanırken sunucunun kimliğinin doğrulanıp doğrulanmayacağını belirtir. Varsayılan değer doğru'dur.	No

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 Bağlan 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ı Bağlan 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 refreshTokengerektiriraccessToken. Buradan erişim belirtecini almayı öğrenin.

Örnek:

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

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
type	Veri kümesinin tür özelliği şu şekilde ayarlanmalıdır: SquareObject	Evet
tableName	Tablonun adı.	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
type	Kopyalama etkinliği kaynağının type özelliği şu şekilde ayarlanmalıdır: SquareSource	Evet
query	Verileri okumak için özel SQL sorgusunu kullanın. Örneğin: "SELECT * FROM Business".	Hayır (veri kümesinde "tableName" belirtilirse)

Ö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>"
            }
        }
    }
]

Arama etkinliği özellikleri

Özellikler hakkında ayrıntılı bilgi edinmek için Arama etkinliği'ne 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ı.