Transformación de datos en Smartsheet (versión preliminar) mediante Data Factory o Synapse Analytics

Artículo
01/05/2024

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 información sobre cómo iniciar una nueva evaluación gratuita.

En este artículo se indica cómo usar Data Flow para transformar datos en Smartsheet (versión preliminar). Para obtener más información, lea el artículo de introducción para Azure Data Factory o Azure Synapse Analytics.

Importante

Este conector está actualmente en versión preliminar. Puede probarlo y enviarnos sus comentarios. Si desea depender de los conectores de versión preliminar en la solución, póngase en contacto con el soporte técnico de Azure.

Funcionalidades admitidas

Este conector Smartsheet es compatible con las funcionalidades siguientes:

Funcionalidades admitidas	IR
Flujo de datos de asignación (origen/-)	6

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

Creación de un servicio vinculado de Smartsheet mediante la interfaz de usuario

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

Vaya a la pestaña Administrar de su área de trabajo de Azure Data Factory o Synapse, y seleccione Servicios vinculados; a continuación, seleccione Nuevo:
- Azure Data Factory
- Azure Synapse
Busque Smartsheet (versión preliminar) y seleccione el conector Smartsheet (versión preliminar).
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 proporciona información acerca de las propiedades que se usan para definir entidades de canalización de Data Factory y Synapse específicas para Smartsheet.

Propiedades del servicio vinculado

Se admiten las siguientes propiedades para el servicio vinculado de Smartsheet:

Propiedad	Descripción	Obligatorio
type	La propiedad type debe establecerse en Smartsheet.	Sí
apiToken	Especifique un token de API para Smartsheet. Marque este campo como SecureString para almacenarlo de forma segura. O bien puede hacer referencia a un secreto almacenado en Azure Key Vault.	Sí

Ejemplo:

{
    "name": "SmartsheetLinkedService",
    "properties": {
        "type": "Smartsheet",
        "typeProperties": {
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

Propiedades de Asignación de instancias de Data Flow

Al transformar datos en el flujo de datos de asignación, puede leer tablas de Smartsheet. Para más información, consulte la transformación de origen en el flujo de datos de asignación. Solo puede usar un conjunto de datos insertado como tipo de origen.

Transformación de origen

En la tabla siguiente se enumeran las propiedades que admite cualquier origen de Smartsheet. Puede editar estas propiedades en la pestaña Source options (Opciones de origen).

Nombre	Descripción	Obligatorio	Valores permitidos	Propiedad de script de flujo de datos
Tipo de entidad	Tipo del recurso de datos en Smartsheet.	Sí cuando se usa el modo alineado	`sheets` `reports`	entityType
Nombre de entidad	Nombre de una hoja o informe en Smartsheet.	Sí cuando se usa el modo alineado	String	entityId

Ejemplos de script de origen de Smartsheet

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'smartsheet',
	format: 'rest',
	entityId: 'Sheet1',
	entityType: 'sheets') ~> SmartsheetSource

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.