Uso de parámetros públicos en Dataflow Gen2

Los parámetros de Dataflow Gen2 permiten controlar y personalizar dinámicamente los flujos de datos, lo que hace que sean más flexibles y reutilizables habilitando diferentes entradas y escenarios sin modificar el propio flujo de datos. Ayuda a mantener las cosas organizadas reduciendo la necesidad de varios flujos de datos y centralizando el control dentro de un único flujo de datos con parámetros.

Los parámetros públicos de Dataflow Gen2 son un nuevo modo en el que puede permitir que el flujo de datos se ejecute pasando valores de parámetro fuera del editor de Power Query a través de la API REST de Fabric o a través de experiencias nativas de Fabric. Permite tener una experiencia más dinámica con el flujo de datos donde cada ejecución se puede invocar con distintos parámetros que afectan a la forma en que se ejecuta el flujo de datos.

Prerrequisitos

• Un flujo de datos Gen2 con compatibilidad con CI/CD
• Los parámetros deben establecerse en el flujo de datos.Obtenga más información sobre cómo establecer parámetros de consulta en Flujo de datos.

Habilitación del modo de parámetro público

Como propietario del flujo de datos, abra el flujo de datos. Dentro de la pestaña Inicio de la cinta de opciones, seleccione el botón Opciones .

Al seleccionar el botón se abre un nuevo cuadro de diálogo Opciones . En el menú vertical, seleccione la opción con la etiqueta Parámetros dentro del grupo de flujo de datos . En la sección Parámetros, puede habilitar la opción que lee "Habilitar parámetros que se detectarán e invalidarán para su ejecución" para habilitar el modo de parámetros públicos.

Seleccione el botón Aceptar para confirmar estos cambios.

Cuando este modo está habilitado, recibirá una notificación en el cuadro de diálogo Administrar parámetros que lee "El modo de parámetro público está habilitado" en la parte superior del cuadro de diálogo.

Una vez habilitado el modo de parámetro público, puede guardar el flujo de datos.

Pasar valores de parámetros personalizados para ejecuciones de Dataflow

El modo de parámetro público sigue la definición de los parámetros dentro del flujo de datos donde hay una distinción entre los parámetros requeridos y no solicitados.

• Parámetros necesarios: si se establece un parámetro según sea necesario, para ejecutar el flujo de datos, es necesario pasar un valor al trabajo de ejecución. Se produce un error en la ejecución si no se pasa ningún valor para un parámetro establecido en obligatorio.
• Parámetros no obligatorios: también se denominan parámetros opcionales y no es necesario pasar ningún valor para que se desencadene una ejecución. Si no se pasa ningún valor, se usa el valor actual definido en el parámetro para su ejecución.

Utilice la actividad de flujo de datos dentro de las canalizaciones

Al crear una canalización en Fabric, puede usar la actividad de flujo de datos para desencadenar la ejecución de un flujo de datos Gen2 con compatibilidad con CI/CD que tenga habilitado el modo de parámetros públicos.

Puede seleccionar el flujo de datos que desea usar y establecer los parámetros que desea usar en la sección Parámetros de flujo de datos.

En la sección Parámetros de flujo de datos , podrá ver todos los parámetros disponibles en el flujo de datos y el valor predeterminado de cada uno dentro de la sección value.

Los parámetros necesarios tienen un asterisco junto a su nombre, mientras que los parámetros opcionales no. Al mismo tiempo, los parámetros opcionales se pueden quitar de la cuadrícula, mientras que los parámetros necesarios no se pueden eliminar y se debe pasar un valor para que se ejecute el flujo de datos.

Puede seleccionar el botón Actualizar para solicitar la información de parámetro más reciente del flujo de datos.

Tipos de parámetros admitidos

En la tabla siguiente se muestran los tipos de parámetros admitidos actualmente y el vínculo a la definición de la API REST para que comprenda cuáles son los valores esperados por la API REST.

Consideraciones y limitaciones

A continuación se muestra una lista de todas las consideraciones y limitaciones al usar el modo de parámetros públicos en Dataflow Gen2 con CI/CD:

• Programación y desencadenamiento manual: los flujos de datos con parámetros públicos no se pueden programar ni desencadenar manualmente a través de Fabric, a menos que no se establezcan parámetros necesarios.
• Parametrización no admitida: no se admiten parámetros que modifiquen rutas de acceso de recursos para orígenes o destinos. Las conexiones se fijan en la trayectoria definida por el autor.
• Actualización incremental: no compatible con el modo de parámetros públicos.
• Modificación de lógica: los parámetros públicos permiten a los usuarios que tengan acceso a anular valores, lo que podría cambiar la salida del flujo del dato.
• Centro de supervisión: el centro de supervisión no muestra los valores de parámetro que se usan durante la ejecución.
• Comportamiento de almacenamiento provisional: solo se almacena la ejecución más reciente en Staging Lakehouse. Use destinos definidos para conservar los datos.
• Solicitudes duplicadas: si los mismos valores de parámetro se envían varias veces, solo se acepta la primera solicitud hasta que se completa.
• Asignación de esquemas: los parámetros no pueden modificar las asignaciones de esquema de destino. Todos los mapeos siguen la configuración definida. Consulte el artículo para obtener más información sobre los destinos de datos y la configuración administrada en Dataflow Gen2.