Копирование данных из ServiceNow V2 с помощью Azure Data Factory или Synapse Analytics

ПРИМЕНЯЕТСЯ К: Azure Data Factory Azure Synapse Analytics

В этой статье описывается, как с помощью действия копирования в конвейерах Фабрики данных Azure и Synapse Analytics копируются данные из ServiceNow. Статья обзор действий копирования содержит общие сведения о действиях копирования и является основой для этого материала.

Поддерживаемые возможности

Этот соединитель ServiceNow поддерживается для следующих возможностей:

(1) Среда выполнения интеграции Azure (2) Локальная среда выполнения интеграции

Список хранилищ данных, поддерживаемых в качестве источников и приемников, см. в таблице поддерживаемых хранилищ данных .

В службе предоставляется встроенный драйвер, который обеспечивает подключение. Поэтому не нужно вручную устанавливать драйвер для использования этого соединителя.

Предварительные требования

Чтобы использовать этот соединитель, необходимо иметь роль с по крайней мере доступом на чтение к sys_db_objectи sys_dictionary таблицам в ServiceNow.

Начало работы

Чтобы выполнить действие копирования с конвейером, можно воспользоваться одним из приведенных ниже средств или пакетов SDK:

• Средство копирования данных
• Портал Azure
• Пакет SDK для .NET
• Пакет SDK для Python
• Azure PowerShell
• The REST API
• Шаблон Azure Resource Manager

Создание связанной службы для ServiceNow с помощью пользовательского интерфейса

Выполните приведенные ниже действия, чтобы создать связанную службу для ServiceNow с помощью пользовательского интерфейса на портале Azure.

1. Перейдите на вкладку "Управление" в рабочей области Фабрики данных Azure или Synapse и выберите "Связанные службы", после чего нажмите "Создать":

   • Фабрика данных Azure
   • Azure Synapse

   

2. Найдите ServiceNow и выберите соединитель ServiceNow.

   

3. Настройте сведения о службе, проверьте подключение и создайте связанную службу.

   

Сведения о конфигурации соединителя

Следующие разделы содержат сведения о свойствах, которые используются для определения сущностей фабрики данных, относящихся к соединителю ServiceNow.

Свойства связанной службы

Для связанной службы ServiceNow поддерживаются следующие свойства:

Пример:

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

Свойства набора данных

Полный список разделов и свойств, доступных для определения наборов данных, см. в статье о наборах данных . Этот раздел содержит список свойств, поддерживаемых набором данных ServiceNow.

Чтобы скопировать данные из ServiceNow, задайте для свойства типа набора данных значение ServiceNowV2Object. Поддерживаются следующие свойства:

Пример

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowV2Object",
        "typeProperties": {
            "tableName": "<table name>",
            "valueType": "actual"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ServiceNow linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Свойства операции копирования

Полный список разделов и свойств, доступных для определения действий, см. в статье "Конвейеры ". Этот раздел содержит список свойств, поддерживаемых источником ServiceNow.

ServiceNow в качестве источника

Чтобы скопировать данные из ServiceNow, задайте тип источника в действии копирования ServiceNowV2Source. Следующие свойства поддерживаются в разделе источник действия копирования.

Пример:

"activities": [
    {
        "name": "CopyFromServiceNow",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<ServiceNow input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ServiceNowV2Source",
                "expression": {
                    "type": "Nary",
                    "operators": [
                        "<"
                    ],
                    "operands": [
                        {
                            "type": "Field",
                            "value": "u_founded"
                        },
                        {
                            "type": "Constant",
                            "value": "2000"
                        }
                    ]
                },
                "pageSize": 300
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Использование параметров выражения

Параметр выражения можно настроить в построителе запросов , выбрав "Добавить динамическое содержимое". Тип параметра должен быть Object, и значение должно соответствовать формату, показанном в примере JSON ниже:

 {
	"type": "Nary",
	"operators": [
		"="
	],
	"operands": [
		{
			"type": "Field",
			"value": "col"
		},
		{
			"type": "Constant",
			"value": "val"
		}
	]
}

Ниже приведен пример исходного JSON с помощью параметра выражения:

"activities": [
    {
        "name": "CopyFromServiceNow",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<ServiceNow input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ServiceNowV2Source",
                "expression": {
                    "type": "Expression",
                    "value": "@pipeline().parameters.expressionParameter"
                }
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Свойства поисковой операции

Чтобы узнать подробности о свойствах, проверьте действие поиска.

Обновление соединителя ServiceNow

Ниже приведены действия, которые помогут вам обновить соединитель ServiceNow:

1. Создайте связанную службу, ссылаясь на свойства связанной службы.
2. Запрос в источнике обновляется до построителя запросов, который имеет то же использование, что и построитель условий в ServiceNow. Узнайте, как настроить его, ссылаясь на ServiceNow в качестве источника.

Различия между ServiceNow V2 и V1

Соединитель ServiceNow версии 2 предлагает новые функциональные возможности и совместим с большинством функций соединителя ServiceNow V1. В таблице ниже показаны различия функций между версиями 2 и V1.

Связанный контент

Список хранилищ данных, поддерживаемых в качестве источников и приемников действием копирования, см. поддерживаемые хранилища данных.