Azure Data Factory kullanarak Marketo'dan veri kopyalama (Önizleme)

Uygulama hedefi: Azure SYNAPSE Analytics 'i Azure Data Factory

Bu makalede Marketo'dan veri kopyalamak için Azure Data Factory Kopyalama Etkinliğinin nasıl kullanılası açıklanmıştır. Kopyalama etkinliğine genel bir genel bakış sunan kopyalama etkinliğine genel bakış makalesinde yer almaktadır.

Önemli

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

Desteklenen özellikler

Bu Marketo bağlayıcısı aşağıdaki etkinlikler için de kullanılabilir:

Marketo'dan desteklenen herhangi bir havuz veri deposuna veri kopyaabilirsiniz. Kopyalama etkinliği tarafından kaynak/havuz olarak desteklenen veri depolarının listesi için Desteklenen veri depoları tablosuna bakın.

Şu anda dış CRM ile tümleştirilmiş Olan Marketo örneği desteklenmiyor.

Not

Bu Marketo bağlayıcısı Marketo bağlayıcısı üzerinde REST API. Marketo'nun hizmet tarafında eşzamanlı istek sınırına sahip olduğunu da farkında olmak. "REST API kullanmaya çalışırken hata: '100' hız sınırı '20' sn (606)" ile aşıldı" veya "REST API kullanmaya çalışırken hata oluştu: Eş zamanlı erişim sınırı '10' sınırına ulaşıldı (615)" hatasını alırsanız, hizmete yönelik istek sayısını azaltmak için eşzamanlı kopyalama etkinliği çalıştırmalarını azaltmayı göz önünde bulundurabilirsiniz.

Kullanmaya başlama

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

Aşağıdaki bölümlerde Marketo bağlayıcıya özgü varlıkları tanımlamak Data Factory özellikleri hakkında ayrıntılar velanmaktadır.

Bağlı hizmet özellikleri

Marketo bağlı hizmeti için aşağıdaki özellikler de kullanılabilir:

Özellik Açıklama Gerekli
tür type özelliği şu şekilde ayarlı: Marketo Yes
endpoint Marketo sunucusunun uç noktası. (örn. 123-ABC-321.mktorest.com) Yes
clientId Marketo hizmetinizin istemci kimliği. Yes
clientSecret Marketo hizmetinizin istemci gizli anahtarı. Data Factory güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin veya Azure Key Vault depolanan bir gizli dizi başvurusuyapın. Yes
useEncryptedEndpoints Veri kaynağı uç noktalarının HTTPS kullanılarak şifrelenip şifrelenmediğini belirtir. Varsayılan değer true şeklindedir. No
Usehostdoğrulaması Sunucu sertifikasında, TLS üzerinden bağlanırken sunucunun ana bilgisayar adıyla eşleşecek şekilde, ana bilgisayar adının istenip istenmeyeceğini belirtir. Varsayılan değer true şeklindedir. No
Usepeerdoğrulaması TLS üzerinden bağlanılırken sunucu kimliğinin doğrulanıp doğrulanmayacağını belirtir. Varsayılan değer true şeklindedir. No

Örnek:

{
    "name": "MarketoLinkedService",
    "properties": {
        "type": "Marketo",
        "typeProperties": {
            "endpoint" : "123-ABC-321.mktorest.com",
            "clientId" : "<clientId>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            }
        }
    }
}

Veri kümesi özellikleri

Veri kümelerini tanımlamaya yönelik bölümlerin ve özelliklerin tam listesi için bkz. veri kümeleri makalesi. Bu bölüm, Marketo veri kümesi tarafından desteklenen özelliklerin bir listesini sağlar.

Marketo 'dan veri kopyalamak için, veri kümesinin Type özelliğini menkul ToObject olarak ayarlayın. Aşağıdaki özellikler desteklenir:

Özellik Açıklama Gerekli
tür Veri kümesinin Type özelliği şu şekilde ayarlanmalıdır: menkul, ToObject Yes
tableName Tablonun adı. Hayır (etkinlik kaynağı içinde "sorgu" belirtilmişse)

Örnek

{
    "name": "MarketoDataset",
    "properties": {
        "type": "MarketoObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Marketo linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Kopyalama etkinliğinin özellikleri

Etkinlikleri tanımlamaya yönelik bölümlerin ve özelliklerin tam listesi için bkz. işlem hatları makalesi. Bu bölüm Marketo kaynağı tarafından desteklenen özelliklerin bir listesini sağlar.

Kaynak olarak Marketo

Marketo'dan veri kopyalamak için kopyalama etkinliğinde kaynak türünü MarketoSource olarak ayarlayın. Kopyalama etkinliği kaynağı bölümünde aşağıdaki özellikler de kullanılabilir:

Özellik Açıklama Gerekli
tür Kopyalama etkinliği kaynağının type özelliği şu şekilde ayar olmalıdır: MarketoSource Yes
sorgu Verileri okumak için özel SQL sorgusunu kullanın. Örneğin: "SELECT * FROM Activitiy_Types". Hayır (veri kümesinde "tableName" belirtilirse)

Örnek:

"activities":[
    {
        "name": "CopyFromMarketo",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Marketo input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "MarketoSource",
                "query": "SELECT top 1000 * FROM Activitiy_Types"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Arama etkinliği özellikleri

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

Sonraki adımlar

Azure Data Factory'de kopyalama etkinliği tarafından kaynak ve havuz olarak desteklenen veri depolarının listesi için bkz. desteklenen veri depoları.