Integração do Fabric (versão prévia)

A extensão MSSQL para Visual Studio Code agora traz o banco de dados SQL no Fabric diretamente para seu fluxo de trabalho de desenvolvimento. Com a nova opção de conectividade do Fabric na caixa de diálogo Conexão, você pode entrar usando Microsoft Entra ID, procurar seus workspaces do Fabric em uma exibição de árvore familiar, pesquisar entre eles e conectar-se a bancos de dados SQL ou pontos de extremidade, tudo sem precisar manipular cadeias de conexão. A experiência foi projetada para parecer nativa para os usuários do Fabric, com logins persistentes, alternância de inquilino e com o fluxo contínuo de "Abrir no MSSQL" através da extensão do Fabric.

Você também pode criar novos bancos de dados SQL no Fabric diretamente do Visual Studio Code. Em vez de deixar o editor para navegar na interface do usuário do Fabric, agora você pode autenticar, selecionar ou criar um workspace, nomear seu banco de dados e conectar-se instantaneamente. O fluxo de provisionamento inclui um indicador de progresso e confirmação de êxito antes da conexão automática. Essa nova experiência elimina a alternância de contexto e reduz o atrito de integração, permitindo que você execute consultas em minutos. Juntas, essas atualizações oferecem uma maneira mais rápida e simples de começar a usar o Microsoft Fabric e tornar mais fácil do que nunca criar soluções nativas de nuvem prontas para IA diretamente do Visual Studio Code.

Conectividade da Infraestrutura (Navegar)

A nova interface de navegação do Fabric na extensão MSSQL permite que os desenvolvedores se conectem perfeitamente aos seus bancos de dados SQL em Fabric ou em pontos de extremidade de análise SQL, sem copiar manualmente cadeias de conexão do portal do Fabric. Com uma única autenticação do Microsoft Entra ID, você pode procurar workspaces disponíveis em uma vista em árvore e conectar-se diretamente de dentro do Visual Studio Code.

Capabilities

• Experiência dedicada do Fabric: fornece uma nova opção na caixa de diálogo Conexão personalizada especificamente para usuários do Fabric, simplificando o processo de conexão focando nos bancos de dados do Fabric.

• Autenticação contínua: utiliza sua conta da Microsoft para entrada segura e persistente, portanto, os usuários só precisam se autenticar uma vez para acessar todos os seus workspaces e bancos de dados do Fabric.

• Navegação no workspace: exibe todos os workspaces do Fabric em uma exibição de árvore hierárquica com recursos carregados sob demanda, facilitando a exploração e o gerenciamento do ambiente do Fabric.

• Pesquisa e descoberta: oferece funcionalidades de pesquisa em tempo real para localizar rapidamente o espaço de trabalho ou banco de dados apropriado sem rolar por longas listas.

• Suporte a extensões cruzadas: permite abrir bancos de dados do Fabric diretamente no MSSQL através da extensão ou do portal do Fabric, fornecendo uma experiência consistente e integrada entre as ferramentas.

Pré-requisitos

• Instale a versão mais recente da extensão MSSQL para Visual Studio Code .
• Permissões de assinatura do Active Fabric e de workspace.
• Uma conta microsoft válida com acesso aos seus workspaces e recursos do Fabric.
• A autenticação usa a ID do Microsoft Entra. Depois de entrar, você pode escolher a conta e o locatário específico para navegar pelo conjunto correto de workspaces e bancos de dados do Fabric.

Introdução

1. Abra a caixa de diálogo Conexão e selecione Procurar Malha.

   

2. Entre com a ID do Microsoft Entra.

   Autenticação pela primeira vez

   • O tipo de autenticação padrão é ID do Microsoft Entra – Universal com suporte para MFA.
   • Se você não estiver conectado, abra a lista suspensa Conta e selecione Adicionar uma conta.
   • Escolha sua conta e conclua o processo de entrada na janela do navegador que é aberta.
   • Retorne ao Visual Studio Code assim que o processo for concluído com êxito.

   Retornando a autenticação do usuário

   • Se você entrar com frequência, as informações da conta aparecerão preenchidas automaticamente.
   • Verifique se a conta correta está selecionada e prossiga.

3. (Opcional) Selecione um locatário.

   • Use a lista suspensa ID do Locatário para escolher o locatário da sua organização.
   • Isso será útil se você tiver acesso a vários ambientes de locatário e precisar procurar recursos em um locatário diferente.

4. Navegue pelos workspaces do Fabric na árvore de workspaces.

5. Use a barra de pesquisa na parte superior da árvore para localizar rapidamente um workspace ou banco de dados.

6. Selecione o banco de dados ou ponto de extremidade de análise desejado na lista.

7. Confirme a autenticação do recurso selecionado, se solicitado.

   

8. Selecione Conectar para adicionar o banco de dados selecionado à sua lista conexões .

9. A nova conexão aparece em Conexões e uma janela de consulta é aberta pronta para uso.

   

Tratamento de erros e casos extremos

Se algo der errado, a interface do usuário exibirá uma mensagem clara e ações recomendadas:

• Sem acesso ao workspace: "Você não tem permissão para visualizar este workspace." — Solicitar acesso ou alternar conta.
• Serviço indisponível ou restrito: "O serviço Fabric está temporariamente indisponível". — Tente novamente ou verifique a saúde do serviço.
• Sessão expirada: "Sua sessão expirou.". — Reautenticar com a ID do Microsoft Entra.
• Restrições de rede: "Conexão bloqueada pela política de rede". — Verifique as configurações corporativas/VPN/firewall.

Limitações conhecidas (versão prévia)

• Há suporte apenas para bancos de dados SQL e pontos de extremidade de análise SQL. Abrir outros tipos de itens do Fabric a partir do MSSQL não está disponível.
• Há suporte para a navegação entre locatários ao alternar entre eles, mas cada conexão de banco de dados deve ser criada separadamente. Não há conexão unificada entre locatários ou entre múltiplos bancos de dados.
• Não há suporte para autenticação offline e fluxos de autenticação por código de dispositivo.

Provisionamento de banco de dados SQL no Fabric

A experiência de provisionamento do banco de dados SQL é integrada à página Implantações da extensão MSSQL, permitindo que os usuários criem e se conectem a novos bancos de dados SQL do Fabric sem sair do Visual Studio Code. Esse fluxo de trabalho simplificado reduz a necessidade de alternar entre portais e simplifica a criação e a conexão do banco de dados.

Capabilities

• Fluxo de trabalho simples: orienta os usuários por meio de autenticação, seleção ou criação de workspace, nomenclatura de banco de dados e provisionamento de tudo dentro da página Implantações, tornando a configuração do banco de dados simples e eficiente.

• Conexão imediata: adiciona automaticamente o banco de dados recém-provisionado à sua lista de conexões, permitindo que você inicie a consulta e o desenvolvimento sem etapas adicionais de configuração.

• Experiência consistente: alinha o fluxo de provisionamento com outros back-ends com suporte, como contêineres locais do SQL Server, garantindo uma experiência familiar e unificada do usuário em diferentes ambientes.

• Reconhecimento de capacidade: indica claramente quando os workspaces são desabilitados devido a restrições de capacidade, fornecendo diretrizes para ajudar os usuários a entender e resolver as limitações de provisionamento.

Pré-requisitos

• Uma assinatura válida do Microsoft Fabric.
• Capacidade suficiente no workspace de destino para provisionar novos bancos de dados SQL.
• Conta ID do Microsoft Entra com as permissões necessárias de espaço de trabalho (Administrador ou Membro).
• Visual Studio Code com a extensão MSSQL instalada.

Introdução

1. Abra a página Implantações e escolha o banco de dados SQL no Fabric.
2. Autenticar com a ID do Microsoft Entra.
3. Selecione ou crie um workspace do Fabric.
4. Insira um nome de banco de dados e selecione Criar.
5. Quando o provisionamento é concluído, o banco de dados é conectado automaticamente e aparece em Conexões, com uma confirmação de êxito.

Dê uma olhada no banco de dados SQL no fluxo de trabalho de provisionamento do Fabric em ação:

Detalhes de conscientização de capacidade

• A conta do Fabric e a capacidade do workspace são validadas durante o fluxo de provisionamento para garantir que o banco de dados possa ser criado com êxito.
• Áreas de trabalho sem capacidade disponível são mostradas como desabilitadas na lista suspensa da área de trabalho, com um tooltip explicando a razão.

Comportamento pós-provisionamento

• A nova conexão adota o Grupo de Conexões selecionado (opcional) para identificação visual rápida.
• Essa experiência pode ser emparelhada com o recurso de navegação do Fabric em outro ambiente do Visual Studio Code, permitindo que você descubra e conecte-se rapidamente ao banco de dados recém-criado sem configuração manual.

Resolução de problemas

• O nome já existe: escolha um nome de banco de dados exclusivo no workspace selecionado.
• Permissões insuficientes: verifique se você tem direitos de Administrador do Workspace/Membro para criar bancos de dados.
• Erros de rede/locatário: Reautentique ou alterne a conta autenticada no menu da conta.
• Tempo limite de provisionamento ou falha: se o assistente não for concluído, repita a operação ou verifique a saúde do serviço Fabric.

Limitações conhecidas (versão prévia)

• O provisionamento é limitado aos bancos de dados SQL no Fabric, outros tipos de item do Fabric estão fora do escopo.
• Há suporte para provisionamento entre locatários quando você seleciona explicitamente um locatário diferente durante a autenticação. No entanto, ainda não há suporte para cenários envolvendo vários locatários simultâneos ou fluxos de trabalho entre locatários automatizados.
• O provisionamento não pode ser colocado em fila quando a capacidade é totalmente utilizada.

Feedback e suporte

Se você tiver ideias, comentários ou quiser se envolver com a comunidade, participe da discussão em https://aka.ms/vscode-mssql-discussions. Para relatar um bug, visite aka.ms/vscode-mssql-bug. Para solicitar um novo recurso, vá para https://aka.ms/vscode-mssql-feature-request.

Conteúdo relacionado

• Início Rápido: conectar e consultar um banco de dados com a extensão MSSQL para Visual Studio Code
• Contêiner local do SQL Server
• Designer de Esquema
• Comparação de esquema