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

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 usa el conector de ServiceNow heredado en la solución, se recomienda actualizar el conector de ServiceNow lo antes posible. Consulte esta sección para más información sobre la diferencia entre la versión heredada y la versión más reciente.

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.

Utilice el valor real en lugar del valor mostrado en ServiceNow.

Requisito previo

Para usar este conector, debe tener un rol con al menos acceso de lectura a las tablas de sys_db_object y sys_dictionary en ServiceNow.

Introducción

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

• La herramienta Copiar datos
• Azure Portal
• El SDK de .NET
• El SDK de Python
• Azure PowerShell
• API REST
• La plantilla de Azure Resource Manager

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:

   Azure Data Factory

   

   Azure Synapse

   

2. Busque ServiceNow y seleccione el conector de ServiceNow.

   

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

   

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í

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. También puede usar parámetros de expresión.	No
En expression
type	El tipo de expresión. Los valores pueden ser Constante (valor predeterminado), Unario, Binario y Operador nº.	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>"
            }
        }
    }
]

Usar parámetros de expresión

Puede configurar el parámetro de expresión en el Generador de consultas seleccionando Agregar contenido dinámico. El tipo de parámetro debe ser de Objeto y el valor debe seguir el formato que se muestra en el ejemplo JSON siguiente:

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

Este es un ejemplo del código JSON de origen mediante el parámetro de expresión:

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

Propiedades de la actividad de búsqueda

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

Actualización del conector de ServiceNow

Estos son los pasos que le ayudarán a actualizar el conector 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.