Поделиться через


Копирование данных из ServiceNow с помощью Фабрики данных Azure или Synapse Analytics

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

Совет

Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !

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

Внимание

Новый соединитель ServiceNow обеспечивает улучшенную встроенную поддержку ServiceNow. Если вы используете устаревший соединитель ServiceNow в решении, рекомендуется обновить соединитель ServiceNow в ближайшее время. Дополнительные сведения о различиях между устаревшей и последней версией см. в этом разделе .

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

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

Поддерживаемые возможности IR
Действие копирования (источник/-) (1) (2)
Действие поиска (1) (2)

① Среда выполнения интеграции Azure ② Локальная среда выполнения интеграции

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

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

Используйте фактическое значение вместо отображаемого значения в ServiceNow.

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

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

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

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

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

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

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

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

    Снимок экрана: соединитель ServiceNow.

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

    Снимок экрана: конфигурация связанной службы для ServiceNow.

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

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

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

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

Свойство Описание: Обязательное поле
type Свойство type должно иметь значение: ServiceNowV2 Да
конечная точка Конечная точка сервера ServiceNow (http://<instance>.service-now.com). Да
authenticationType Тип проверки подлинности.
Допустимые значения: Basic, OAuth2.
Да
username Имя пользователя, используемое для подключения к серверу ServiceNow для обычной проверки подлинности и OAuth2. Да
password Пароль, соответствующий имени пользователя для обычной проверки подлинности и OAuth2. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault. Да
clientId Идентификатор клиента для проверки подлинности OAuth2. Да для проверки подлинности OAuth
clientSecret Секрет клиента для проверки подлинности OAuth2. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault. Да для проверки подлинности OAuth
grantType Указывает тип потока OAuth2.0, используемый клиентским приложением для доступа к маркеру. Значением по умолчанию является пароль. Да для проверки подлинности OAuth

Пример:

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

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

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

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

Свойство Описание: Обязательное поле
type Свойство type набора данных должно иметь значение : ServiceNowV2Object Да
tableName Имя таблицы. Да

Пример

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

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

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

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

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

Свойство Описание: Обязательное поле
type Свойство type источника действия копирования должно иметь значение : ServiceNowV2Source Да
выражение Используйте выражение для чтения данных. Выражение можно настроить в построителе запросов. Он имеет то же использование, что и построитель условий в ServiceNow. Инструкции по использованию см. в этой статье. No
Группа: expression
type Тип выражения. Значения могут быть константами (по умолчанию), унарными, двоичными и полями. No
значение Значение константы. Да, если тип выражения является константой или полем
операторы Значение оператора. Дополнительные сведения об операторах см. в разделе "Операторы", доступные для полей выбора, содержащих строки в этой статье. Да, если тип выражения является унарным или двоичным
Операндов Список выражений, к которым применяется оператор. Да, если тип выражения является унарным или двоичным

Пример:

"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"
                        }
                    ]
                }
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Свойства действия поиска

Подробные сведения об этих свойствах см. в разделе Действие поиска.

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

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

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

Различия между ServiceNow и ServiceNow (устаревшая версия)

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

ServiceNow ServiceNow (устаревшая версия)
useEncryptedEndpoints, useHostVerification и usePeerVerification не поддерживаются в связанной службе. Поддержка использованияEncryptedEndpoints, useHostVerification и usePeerVerification в связанной службе.
Поддержка построителя запросов в источнике. Построитель запросов не поддерживается в источнике.
Запросы на основе SQL не поддерживаются. Поддержка запросов на основе SQL.
Запросы sortBy не поддерживаются в построителе запросов. Поддержка запросов sortBy в запросе.
Схему можно просмотреть в наборе данных. Невозможно просмотреть схему в наборе данных.

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