Compartilhar via

Tipo de variável de referência de conexão (versão prévia)

Uma variável de referência de conexão é uma variável de workspace que armazena a ID de uma conexão de dados externa (por exemplo, Snowflake, SQL do Azure), permitindo que os itens façam referência a recursos externos sem inserir credenciais ou cadeias de conexão.

Como usar

Uma variável de referência de conexão pode ser usada da mesma forma que outras variáveis em uma biblioteca de variáveis.

  1. Fazer login no Microsoft Fabric
  2. Navegue até o seu espaço de trabalho e a biblioteca de variáveis
  3. Na parte superior, selecione + Nova Variável
  4. Forneça um nome para a variável, selecione referência de conexão para o tipo e clique em ... para selecionar um valor

Captura de tela dos itens disponíveis para a referência de conexão. 5. Depois de selecionada, sua referência de conexão deve estar pronta para uso.

Captura de tela da referência de conexão.

Se você precisar editar uma referência de conexão ou precisar verificar o valor duas vezes, clique com o botão direito do mouse no valor para abrir um pop-up com informações sobre a referência de conexão.

Captura de tela do pop-up de referência de conexão.

Como funciona

O valor de uma variável de referência de conexão é um ponteiro estático para um objeto de conexão identificado por sua ID de conexão. O valor é armazenado como uma cadeia de caracteres correspondente à ID da conexão de destino. Por exemplo:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Essa ID identifica exclusivamente a conexão referenciada. A referência estática não se ajusta automaticamente a ambientes de implantação diferentes. Ele requer que a conexão de destino exista no momento da seleção e permanece apontada para essa conexã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 conexão predefinido no nível do locatário.
  • As referências de conexão não se associam automaticamente durante a implantação. Seus valores permanecem fixos entre ambientes.
  • Dá suporte a CI/CD e automação parametrizando conexões externas para ambientes diferentes (desenvolvimento, teste, prod).
  • Habilita a configuração dinâmica de relações externas (por exemplo, alternar fontes de dados ou credenciais por ambiente).
  • Os valores são escolhidos por meio de uma caixa de diálogo da interface do usuário, não texto gratuito, garantindo que somente conexões autorizadas sejam selecionáveis.
  • Somente conexões com pelo menos permissões de leitura estão disponíveis para seleção.

Representação em Git e APIs

Uma referência de conexão é um tipo de variável avançada cujo esquema de valor armazena a connectionId (e a plataforma resolve/exibe metadados). O conteúdo de criação inclui:

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

Exemplo:


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

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

O uso de variáveis de referência de conexão envolve duas camadas de permissões:

  • Criar e editar uma variável de referência de conexão: usuários com funções de Colaborador ou superior no workspace podem criar e editar variáveis na biblioteca, enquanto Visualizadores somente têm permissão de leitura.
  • Acessando a variável de referência de conexão: além dos direitos na Biblioteca de Variáveis, você deve ter pelo menos permissão de leitura na variável de referência de conexão que você pretende referenciar.

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

Itens com suporte

Veja a seguir uma lista de itens que dão suporte a variáveis de referência de conexão:

Exemplo de código do Python

O exemplo de código a seguir mostra como usar uma referência de conexão em um script python.

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

Esse código faz o seguinte:

  • Resolve uma variável de referência de conexão de uma Biblioteca de Variáveis do Fabric
  • Recupera o objeto de metadados de conexão
  • Extrai a conexãoId
  • Imprime o ID para que ele possa ser utilizado em chamadas de código ou API.

Limitações

As seguintes limitações se aplicam a variáveis de referência de conexão:

  • Não há suporte para conexões embutidas em notebooks, pois o connection_id para a conexão do notebook não é o mesmo.

Conteúdo relacionado

  • Last updated on