Partilhar via

Tipo de variável de referência de ligação (pré-visualização)

Uma variável de referência de ligação é uma variável de espaço de trabalho que armazena o ID de uma ligação de dados externa (por exemplo, Snowflake, Azure SQL), permitindo que os elementos referenciam recursos externos sem incorporar credenciais ou cadeias de ligação.

Modo de utilização

Uma variável de referência de ligação pode ser usada tal como outras variáveis numa biblioteca de variáveis.

  1. Iniciar sessão no Microsoft Fabric
  2. Navegue até ao seu espaço de trabalho e à biblioteca de variáveis
  3. No topo, selecione + Nova Variável
  4. Forneça um nome para a variável, selecione a referência de ligação para o tipo e depois clique em ... para selecionar um valor

Captura de ecrã dos itens disponíveis para referência de ligação. 5. Uma vez selecionada, a tua referência de ligação deve estar pronta a usar.

Captura de ecrã da referência de ligação.

Se precisares de editar uma referência de ligação ou confirmar o valor, podes clicar com o botão direito no valor para abrir um pop-up com informação sobre a referência da ligação.

Captura de ecrã do pop-up de referência de ligação.

Como funciona

O valor de uma variável de referência de ligação é um ponteiro estático para um objeto de ligação identificado pelo seu ID de ligação. O valor é armazenado como uma cadeia correspondente ao ID da ligação alvo. Por exemplo:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Este ID identifica de forma única a ligação referenciada. A referência estática não se ajusta automaticamente a diferentes ambientes de implementação. Requer que a ligação alvo exista no momento da seleção e permanece apontada para essa ligação específica, a menos que seja alterada manualmente.

Tenha em mente o seguinte ao trabalhar com referências de conexão:

  • Armazena um identificador de ligação pré-definido ao nível do inquilino.
  • As referências de ligação não se vinculam automaticamente durante a implantação. Os seus valores mantêm-se fixos em vários ambientes.
  • Suporta CI/CD e automação ao parametrizar ligações externas para diferentes ambientes (desenvolvimento, teste, produção).
  • Permite a configuração dinâmica de relações externas (por exemplo, trocando fontes de dados ou credenciais por ambiente).
  • Os valores são escolhidos através de um diálogo de interface, não de texto livre, garantindo que apenas ligações autorizadas sejam selecionáveis.
  • Apenas ligações com pelo menos permissões de leitura estão disponíveis para seleção.

Representação em Git e APIs

Uma referência Connection é um tipo avançado de variável cujo esquema de valores armazena o connectionId (e a plataforma resolve/apresenta metadados). A carga útil de autoria inclui:

  • nome: o displayName da variável de referência de ligação
  • nota: opcional, pode ser usado para descrição ou outras notas.
  • tipo: "connectionReference" (tipo avançado)
  • valor: por conjunto de valores, cada valor armazena { "connectionId": "<GUID/ID string>" }

Exemplo: 


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

Permissões necessárias para criar/usar referências de ligação

A utilização de variáveis de referência de ligação envolve duas camadas de permissões:

  • Criar e editar uma variável de referência de ligação: Utilizadores com funções de Colaborador ou superiores no espaço de trabalho podem criar e editar variáveis na biblioteca, enquanto os Visualizadores têm acesso apenas de leitura.
  • Aceder à variável de referência de ligação: Para além dos direitos na Biblioteca de Variáveis, deve ter pelo menos permissão de leitura sobre a variável de referência de ligação que pretende referenciar.

Para mais informações sobre permissões e validação de permissões, veja Permissões da biblioteca de variáveis

Itens suportados

Segue-se uma lista de itens que suportam variáveis de referência de ligação:

Exemplo de código em Python

O exemplo de código seguinte mostra como usar uma referência de ligação num script 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 faz o seguinte:

  • Resolve uma variável de Referência de Conexão a partir de uma Biblioteca de Variáveis Fabric
  • Recupera o objeto de metadados de ligação
  • Extrai o connectionId
  • Imprime o ID para que possa ser usado em chamadas de código ou API.

Limitações

As seguintes limitações aplicam-se às variáveis de referência de ligação:

  • As Ligações Integradas nos Notebooks não são suportadas, pois a connection_id para a ligação ao Notebook não é a mesma.

Conteúdo relacionado

  • Last updated on