Uso de bibliotecas de variables de Fabric en Dataflow Gen2

Nota:

Para obtener más información sobre cómo aprovechar esta funcionalidad en escenarios de integración continua o implementación continua (CI/CD), asegúrese de leer el artículo sobre arquitecturas de soluciones DE CI/CD y ALM para Dataflow Gen2 y el tutorial de un extremo a otro sobre referencias de variables en un flujo de datos.

Las bibliotecas de variables de Fabric ofrecen una manera centralizada de administrar los valores de configuración en las cargas de trabajo de Microsoft Fabric. Con la nueva integración en Dataflow Gen2, puede hacer referencia a estas variables directamente en el flujo de datos, lo que permite el comportamiento dinámico entre entornos y simplifica los flujos de trabajo de CI/CD.

Prerrequisitos

Para usar bibliotecas de variables de Fabric en Dataflow Gen2, asegúrese de lo siguiente:

Referenciar variables utilizando widgets de entrada

Los cuadros de diálogo de Dataflow Gen2 incluyen un widget de entrada que le permite elegir cómo escribir un valor de campo. En los cuadros de diálogo admitidos, puede seleccionar variables mediante este widget.

Captura de pantalla del widget de entrada dentro de un cuadro de diálogo de filas de filtro que muestra las varias opciones disponibles para la entrada.

Nota:

Para usar el widget de entrada, en la pestaña Ver de la cinta de opciones, en el grupo Parámetros , seleccione Permitir siempre. Captura de pantalla de la casilla Permitir siempre en la pestaña Ver de la cinta de opciones para habilitar el widget de entrada.

Algunos diálogos admiten la experiencia del widget de entrada y las bibliotecas de variables de Fabric, entre las que se incluyen:

Al seleccionar la opción variable en el widget de entrada, aparece el cuadro de diálogo selector de variables. En este cuadro de diálogo, puede examinar las bibliotecas de variables y las variables que contienen.

Captura de pantalla del cuadro de diálogo seleccionar variable que muestra todas las bibliotecas y variables disponibles en el área de trabajo actual.

Después de seleccionar una variable, el cuadro de diálogo muestra la biblioteca y el nombre de la variable para que pueda confirmar la selección antes de confirmar.

Captura de pantalla de una variable con el nombre Ceiling de la biblioteca Mi biblioteca se muestra como seleccionada en el cuadro de diálogo Filtrar filas.

Nota:

No todas las experiencias de flujo de datos admiten el widget de entrada. Para experiencias no soportadas o escenarios personalizados, utilice las funciones de variable de manera manual.

Funciones variables

Dentro de Dataflow Gen2, puede hacer referencia a una variable mediante cualquiera de las funciones siguientes:

El identificador que se pasa a cualquiera de las funciones debe usar el siguiente formato:

$(/**/LibraryName/VariableName)

En los ejemplos siguientes se supone que una biblioteca de variables denominada My Library y una variable de cadena denominada My Variable:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

El uso de un valor predeterminado a través Variable.ValueOrDefault de ayuda a garantizar que la fórmula se resuelva incluso cuando se copia o mueve la solución a otro entorno que no tiene la biblioteca de variables a la que se hace referencia.

Sugerencia

Almacene cada variable como una consulta independiente que no requiera almacenamiento provisional. Este enfoque le permite usar estos valores en diálogos que admiten la entrada de consulta y ayuda a mantener una vista organizada de las variables en el flujo de datos.

Consideraciones y limitaciones

En la lista siguiente se describen las restricciones y comportamientos importantes que se deben tener en cuenta al usar bibliotecas de variables de Fabric con Dataflow Gen2. Estas limitaciones afectan a cómo se hace referencia a las variables, se evalúan y se aplican durante el diseño y el tiempo de ejecución.

  • Ámbito del espacio de trabajo: las bibliotecas de variables deben residir en el mismo área de trabajo que Dataflow Gen2 con CI/CD.

  • Ubicación de referencia: las variables solo se pueden usar dentro del archivo mashup.pq de un flujo de datos Gen2 con CI/CD.

  • Comportamiento durante la ejecución: los valores de las variables se recuperan al inicio de la ejecución y se conservan durante toda la operación. Los cambios en una biblioteca durante una ejecución de flujo de datos no se detienen ni afectan a esa ejecución.

  • Usar un valor predeterminado: cuando se usa un valor predeterminado a través de la función Variable.ValueOrDefault, asegúrese de que el tipo de datos del valor predeterminado coincide con el tipo de datos de la variable a la que se hace referencia.

  • Tipos admitidos: solo se admiten variables de tipos básicos (boolean, datetime, guidinteger, , numbery string).

  • Conexiones fijas: las variables no pueden modificar la información de conexión. Las conexiones permanecen unidas a las configuraciones de ruta de acceso de recursos definidas.

  • Riesgo de sobrescritura: los usuarios con acceso para modificar bibliotecas de variables pueden sobrescribir los valores de las variables, lo que podría afectar al resultado del flujo de datos.

  • Asignación de esquemas: las variables no pueden modificar las asignaciones de esquema de destino; las asignaciones siguen la configuración original.

  • Visibilidad del linaje: las vistas de linaje no muestran vínculos entre Dataflow Gen2 y las bibliotecas de variables a las que hace referencia.

  • Last updated on