Compartir vía

Copia de datos de ServiceNow con Azure Data Factory o Synapse Analytics

  • Artículo

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. ¡Obtenga más información sobre cómo iniciar una nueva evaluación gratuita!

En este artículo se resume el uso de la actividad de copia en canalizaciones de Azure Data Factory y Synapse Analytics para copiar datos de ServiceNow. El documento se basa en el artículo de introducción a la actividad de copia que describe información general de la actividad de copia.

Importante

El nuevo conector ServiceNow proporciona compatibilidad nativa mejorada con ServiceNow. Si usas la versión heredada del conector de ServiceNow en la solución, que se admite tal cual solo en el caso de la compatibilidad con versiones anteriores, consulta el artículo Conector de ServiceNow (heredado).

Funcionalidades admitidas

Este conector ServiceNow es compatible con las funcionalidades siguientes:

Funcionalidades admitidas IR
Actividad de copia (origen/-) ① ②
Actividad de búsqueda ① ②

① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado

Para obtener una lista de los almacenes de datos que se admiten como orígenes y receptores, consulte la tabla de almacenes de datos admitidos.

El servicio proporciona un controlador integrado para permitir la conectividad. Por lo tanto, no es necesario instalar manualmente ningún controlador con este conector.

Introducción

Para realizar la actividad de copia con una canalización, puede usar una de los siguientes herramientas o SDK:

Creación de un servicio vinculado a ServiceNow mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado a ServiceNow en la interfaz de usuario de Azure Portal.

  1. Vaya a la pestaña Administrar del área de trabajo de Azure Data Factory o Synapse y seleccione Servicios vinculados; luego haga clic en Nuevo:

  2. Busque ServiceNow y seleccione el conector de ServiceNow.

    Captura de pantalla del conector de ServiceNow.

  3. Configure los detalles del servicio, pruebe la conexión y cree el nuevo servicio vinculado.

    Captura de pantalla de la configuración del servicio vinculado de ServiceNow.

Detalles de configuración del conector

En las secciones siguientes se proporcionan detalles sobre las propiedades que se usan para definir entidades de Data Factory específicas para el conector de ServiceNow.

Propiedades del servicio vinculado

Las siguientes propiedades son compatibles con el servicio vinculado de ServiceNow:

Propiedad Descripción Obligatorio
type La propiedad type debe establecerse en: ServiceNowV2. Sí
endpoint El punto de conexión del servidor de ServiceNow (http://<instance>.service-now.com). Sí
authenticationType Tipo de autenticación que se debe usar.
Los valores permitidos son: Basic y OAuth2		 Sí
username Nombre de usuario utilizado para conectarse al servidor de ServiceNow para la autenticación Basic y OAuth2. Sí
password Contraseña correspondiente al nombre de usuario para la autenticación Basic y OAuth2. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault. Sí
clientId Id. de cliente para la autenticación OAuth2. Sí para la autenticación de OAuth
clientSecret Secreto de cliente para la autenticación OAuth2. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault. Sí para la autenticación de OAuth
grantType Especifica el tipo de flujo de OAuth2.0 que usa la aplicación cliente para acceder al token. El valor predeterminado es la contraseña. Sí para la autenticación de OAuth

Ejemplo:

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

Propiedades del conjunto de datos

Si desea ver una lista completa de las secciones y propiedades disponibles para definir conjuntos de datos, consulte el artículo sobre conjuntos de datos. En esta sección se proporciona una lista de las propiedades compatibles con el conjunto de datos de ServiceNow.

Para copiar datos de ServiceNow, establece la propiedad type del conjunto de datos en ServiceNowV2Object. Se admiten las siguientes propiedades:

Propiedad Descripción Obligatorio
type La propiedad type del conjunto de datos se debe establecer en ServiceNowV2Object. Sí
tableName Nombre de la tabla. Sí

Nota:

En las actividades de copia, tableName del conjunto de datos será el nombre de la tabla en lugar de la etiqueta en ServiceNow.

Ejemplo

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

Propiedades de la actividad de copia

Si desea ver una lista completa de las secciones y propiedades disponibles para definir actividades, consulte el artículo sobre canalizaciones. En esta sección se proporciona una lista de las propiedades compatibles con el origen de ServiceNow.

ServiceNow como origen

Para copiar datos de ServiceNow, establece el tipo de origen de la actividad de copia en ServiceNowV2Source. Se admiten las siguientes propiedades en la sección source de la actividad de copia:

Propiedad Descripción Obligatorio
type La propiedad type del origen de la actividad de copia debe establecerse en ServiceNowV2Source. Sí
expresión Utiliza la expresión para leer datos. Puedes configurar la expresión en Generador de consultas. Tiene el mismo uso que el generador de condiciones en ServiceNow. Para obtener instrucciones sobre cómo usarlo, consulta este artículo. No
En expression
type El tipo de expresión. Los valores pueden ser Constante (valor predeterminado), Unario, Binario y Campo. No
value El valor constante. Sí cuando el tipo de expresión es Constante o Campo.
(operadores) El valor del operador. A fin de obtener más información sobre los operadores, consulta la sección Operadores disponibles para campos de selección que contienen cadenas en este artículo. Sí cuando el tipo de expresión es Unario o Binario.
Operandos Lista de expresiones en las que se aplica el operador. Sí cuando el tipo de expresión es Unario o Binario.

Ejemplo:

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

Propiedades de la actividad de búsqueda

Para obtener información detallada sobre las propiedades, consulte Actividad de búsqueda.

Actualización del servicio vinculado de ServiceNow

Estos son los pasos que te ayudarán a actualizar el servicio vinculado de ServiceNow:

  1. Crea un servicio vinculado haciendo referencia a las propiedades del servicio vinculado.
  2. Consulta en el origen se ha actualizado a Generador de consultas, que tiene el mismo uso que el generador de condiciones en ServiceNow. Descubre cómo configurarlo haciendo referencia a ServiceNow como origen.

Diferencias entre ServiceNow y ServiceNow (heredado)

El conector de ServiceNow ofrece nuevas funciones y es compatible con la mayoría de las características del conector de ServiceNow (heredado). En la tabla siguiente se muestran las diferencias de características entre ServiceNow y ServiceNow (heredado).

ServiceNow ServiceNow (heredado)
useEncryptedEndpoints, useHostVerification y usePeerVerification no se admiten en el servicio vinculado. Admite useEncryptedEndpoints, useHostVerification y usePeerVerification en el servicio vinculado.
Admite el Generador de consultas en el origen. No se admite el Generador de consultas en el origen.
No se admiten consultas basadas en SQL. Se admiten consultas basadas en SQL.
Las consultas sortBy no se admiten en el Generador de consultas. Las consultas sortBy se admiten en Consulta.
Puedes ver el esquema en el conjunto de datos. No puedes ver el esquema en el conjunto de datos.

Contenido relacionado

Para obtener una lista de almacenes de datos que la actividad de copia admite como orígenes y receptores, vea Almacenes de datos que se admiten.