Compartir vía

Tipo de variable de referencia de conexión (versión preliminar)

Una variable de referencia de conexión es una variable de área de trabajo que almacena el identificador de una conexión de datos externa (por ejemplo, Snowflake, Azure SQL), lo que permite que los elementos hagan referencia a recursos externos sin insertar credenciales ni cadenas de conexión.

Cómo usar

Una variable de referencia de conexión se puede usar igual que otras variables de una biblioteca de variables.

  1. Iniciar sesión en Microsoft Fabric
  2. Vaya al área de trabajo y a la biblioteca de variables.
  3. En la parte superior, seleccione + Nueva variable.
  4. Proporcione un nombre para la variable, seleccione la referencia de conexión para el tipo y, a continuación, haga clic en ... para seleccionar un valor.

Captura de pantalla de los elementos disponibles para la referencia de conexión. 5. Una vez seleccionado, la referencia de conexión debe estar lista para usarse.

Captura de pantalla de la referencia de conexión.

Si necesita editar una referencia de conexión o debe comprobar el valor, puede hacer clic con el botón derecho en el valor para abrir un elemento emergente con información sobre la referencia de conexión.

Captura de pantalla del pop-up de referencia de conexión.

Cómo funciona

El valor de una variable de referencia de conexión es un puntero estático a un objeto de conexión identificado por su identificador de conexión. El valor se almacena como una cadena correspondiente al identificador de la conexión de destino. Por ejemplo:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Este identificador identifica de forma única la conexión a la que se hace referencia. La referencia estática no se ajusta automáticamente a diferentes entornos de implementación. Requiere que la conexión de destino exista en el momento de la selección y siga apuntando a esa conexión específica a menos que se cambie manualmente.

Tenga en cuenta lo siguiente cuando trabaje con referencias de conexión:

  • Almacena un identificador de conexión predefinido en el nivel de inquilino.
  • Las referencias de conexión no se enlazan automáticamente durante la implementación. Sus valores permanecen fijos en todos los entornos.
  • Admite CI/CD y automatización mediante la parametrización de conexiones externas para distintos entornos (desarrollo, prueba, prod).
  • Habilita la configuración dinámica de relaciones externas (por ejemplo, cambiar orígenes de datos o credenciales por entorno).
  • Los valores se eligen a través de un cuadro de diálogo de interfaz de usuario, no texto libre, lo que garantiza que solo se puedan seleccionar las conexiones autorizadas.
  • Solo están disponibles las conexiones con al menos permisos de lectura para la selección.

Representación en Git y API

Una referencia de conexión es un tipo de variable avanzada cuyo esquema de valor almacena el "connectionId" (y la plataforma resuelve y muestra metadatos). La carga de creación incluye:

  • nombre: el nombre para mostrar de la variable de referencia de conexión
  • nota: opcional, se puede usar para la descripción u otras notas.
  • type: "connectionReference" (tipo avanzado)
  • value: por conjunto de valores, cada valor almacena { "connectionId": "<cadena de GUID/ID>" }

Ejemplo:


  {
   "name": "PrimaryDb",
   "note": "",
   "type": "connectionReference",
   "value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
  }

Permisos necesarios para crear o usar referencias de conexión

El uso de variables de referencia de conexión implica dos capas de permisos:

  • Crear y editar una variable de referencia de conexión: los usuarios con roles de colaborador o superior en el área de trabajo pueden crear y editar variables en la biblioteca, mientras que los visores son de solo lectura.
  • Acceso a la variable de referencia de conexión: además de tener derechos en la biblioteca de variables, debe tener al menos permiso de lectura sobre la variable de referencia de conexión que desea hacer referencia.

Para obtener más información sobre los permisos y la validación de permisos, consulte Permisos de biblioteca de variables.

Elementos admitidos

A continuación se muestra una lista de elementos que admiten variables de referencia de conexión:

Ejemplo de código de Python

En el ejemplo de código siguiente se muestra cómo usar una referencia de conexión en un script de Python.

var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)

Este código hace lo siguiente:

  • Resuelve una variable de referencia de conexión de una biblioteca de variables de Fabric
  • Recupera el objeto de metadatos de conexión.
  • Extrae el valor de connectionId.
  • Imprime el identificador para que se pueda usar en el código o las llamadas API.

Limitaciones

Las siguientes limitaciones se aplican a las variables de referencia de conexión:

  • No se admiten conexiones integradas en Notebooks, ya que el connection_id para la conexión de Notebook no es el mismo.

Contenido relacionado

  • Last updated on