Azure Data Factory veya Synapse Analytics kullanarak ServiceNow V1'den veri kopyalama

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

Bu makalede, ServiceNow'dan veri kopyalamak için Azure Data Factory ve Synapse Analytics işlem hatları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.

Desteklenen özellikler

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

(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 ServiceNow'a bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde ServiceNow'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ı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. ServiceNow araması yapın ve ServiceNow 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, ServiceNow 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

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

Örnek:

{
    "name": "ServiceNowLinkedService",
    "properties": {
        "type": "ServiceNow",
        "typeProperties": {
            "endpoint" : "http://<instance>.service-now.com",
            "authenticationType" : "Basic",
            "username" : "<username>",
            "password": {
                 "type": "SecureString",
                 "value": "<password>"
            }
        }
    }
}

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

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

Örnek

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ServiceNow 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ümde ServiceNow kaynağı tarafından desteklenen özelliklerin listesi sağlanır.

Kaynak olarak ServiceNow

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

Sorguda ServiceNow için şema ve sütun belirtirken aşağıdakilere dikkat edin ve kopyalama performansı üzerindeki performans ipuçlarınabakın.

• Şema: ServiceNow sorgusunda, ServiceNow REST API'lerini çağırırken parametresi olarak true veya false olarak sysparm_display_value bakabileceğiniz şemayı ActualDisplay veya olarak belirtin. 
• Sütun: şema altındaki Actual gerçek değerin sütun adı olurken [column name]_value, şemanın altındaki Display görüntüleme değeri ise şeklindedir [column name]_display_value. Sütun adının sorguda kullanılan şemayla eşlenmesini gerektiğini unutmayın.

Örnek sorgu:SELECT col_value FROM Actual.alm_asset VEYA SELECT col_display_value FROM Display.alm_asset

Örnek:

"activities":[
    {
        "name": "CopyFromServiceNow",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<ServiceNow input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ServiceNowSource",
                "query": "SELECT * FROM Actual.alm_asset"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Performans ipuçları

Kullanılacak şema

ServiceNow'un 2 farklı şeması vardır, biri gerçek verileri döndüren "Gerçek" , diğeri de verilerin görüntüleme değerlerini döndüren "Görüntü" dür.

Sorgunuzda bir filtre varsa, daha iyi kopyalama performansına sahip "Gerçek" şemayı kullanın. "Gerçek" şemayı sorgularken ServiceNow, yalnızca filtrelenmiş sonuç kümesini döndürmek için verileri getirirken filtreyi yerel olarak desteklerken, "Görüntü" şeması sorgulanırken ADF tüm verileri alır ve filtreyi dahili olarak uygular.

Dizin oluşturma

ServiceNow tablo dizini sorgu performansını artırmaya yardımcı olabilir. Bkz . Tablo dizini oluşturma.

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ı.