Integração de Fabric (Pré-visualização)

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, pode entrar utilizando o Microsoft Entra ID, navegar nos seus espaços de trabalho do Fabric numa estrutura hierárquica familiar, pesquisar entre eles e conectar-se a bases de dados SQL ou a pontos de extremidade, tudo sem se preocupar com strings de conexão. A experiência foi projetada para parecer nativa para os usuários do Fabric, com entradas persistentes, troca de locatário e um fluxo contínuo de "Abrir no MSSQL" da extensão Fabric.

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

Sugestão

Os recursos de integração de malha estão atualmente em visualização e podem mudar com base nos comentários. Junte-se à nossa comunidade no GitHub Discussions para compartilhar ideias ou relatar problemas.

Conectividade de rede (Explorar)

A nova experiência de navegação do Fabric na extensão MSSQL permite que os desenvolvedores se conectem perfeitamente aos seus bancos de dados SQL no Fabric e nos endpoints de análise SQL sem a necessidade de copiar manualmente as strings de conexão do portal do Fabric. Com uma única autenticação do ID do Microsoft Entra, pode navegar pelos espaços de trabalho disponíveis numa vista de árvore e conectar-se diretamente dentro do Visual Studio Code.

Capabilities

• Experiência de malha dedicada: fornece uma nova opção na caixa de diálogo Conexão adaptada especificamente para usuários de malha, simplificando o processo de conexão concentrando-se em bancos de dados de malha.

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

• Navegação no espaço de trabalho: exibe todos os espaços de trabalho 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 funcionalidade de pesquisa em tempo real para localizar rapidamente o espaço de trabalho ou banco de dados apropriado sem rolar por listas longas.

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

Pré-requisitos

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

Observação

Para essa experiência de conectividade de malha (Procurar), não são necessárias cadeias de conexão ou tokens de acesso pessoal.

Introdução

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

   

2. Entre com o Microsoft Entra ID.

   Autenticação pela primeira vez

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

   Retornando a autenticação do usuário

   • Se iniciar sessão com frequência, as informações da sua conta aparecem pré-preenchidas.
   • Verifique se a conta correta está selecionada e prossiga.

3. (Opcional) Selecione um locatário.

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

4. Navegue pelos espaços de trabalho Fabric na árvore de espaços de trabalho.

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

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

7. Confirme a autenticação para o 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.

   

Sugestão

Você pode usar a Pesquisa na parte superior da árvore para localizar rapidamente um espaço de trabalho ou banco de dados. Os resultados priorizam as correspondências mais próximas e os itens usados recentemente.

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 espaço de trabalho: "Você não tem permissão para exibir este espaço de trabalho." — Solicite acesso ou mude de conta.
• Serviço indisponível ou limitado: 'O serviço de fabric está temporariamente indisponível.' — Tente novamente ou verifique o estado do serviço.
• Sessão expirada: "A sua sessão expirou." — Autentique-se novamente com o Microsoft Entra ID.
• Restrições de rede: "Ligação bloqueada pela política de rede." — verifique as configurações corporativas/VPN/firewall.

Importante

Durante a Pré-visualização, a navegação por grandes inquilinos pode carregar crianças a pedido para manter a árvore responsiva. Você pode notar breves indicadores de carregamento ao expandir nós com muitos itens.

Limitações conhecidas (Pré-visualização)

• Somente bancos de dados SQL e pontos de extremidade de análise SQL são suportados. Abrir outros tipos de item Fabric do MSSQL não está disponível.
• A navegação entre locatários é suportada pela troca de locatários, mas cada conexão de banco de dados deve ser criada separadamente. Não há conexão unificada entre locatários ou com vários bancos de dados.
• Não há suporte para login offline e fluxos de autenticação de código de dispositivo.

Banco de dados SQL na implementação 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 de malha 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 através da autenticação, seleção ou criação de espaço de trabalho, nomeação de banco de dados e provisionamento, 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ê comece a consultar e desenvolver sem etapas de configuração extras.

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

• Reconhecimento de capacidade: indica claramente quando os espaços de trabalho são desativados devido a restrições de capacidade, fornecendo orientação 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 espaço de trabalho de destino para provisionar novos bancos de dados SQL.
• Conta Microsoft Entra ID com as permissões de espaço de trabalho necessárias (Administrador ou Membro).
• Visual Studio Code com a extensão MSSQL instalada.

Introdução

1. Abra a página Implantações e escolha Banco de dados SQL do Fabric.
2. Autentique-se com o Microsoft Entra ID.
3. Selecione ou crie um espaço de trabalho Fabric.
4. Insira um nome de banco de dados e selecione Criar.
5. Quando o provisionamento for concluído, o banco de dados será conectado automaticamente e aparecerá em Conexões, com uma confirmação de êxito.

Sugestão

O fluxo de ponta a ponta normalmente termina em menos de um minuto. Essa nova experiência de provisionamento de banco de dados permite que você comece a prototipar rapidamente sem alternar para o portal do Fabric.

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

Detalhes de gestão de capacidade

• A conta Fabric e a capacidade do espaço de trabalho são validadas durante o fluxo de provisionamento para garantir que o banco de dados possa ser criado com sucesso.
• Os espaços de trabalho sem capacidade disponível são mostrados como desativados na lista suspensa de espaços de trabalho, com um tooltip explicando o motivo.

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 se conecte rapidamente ao banco de dados recém-criado sem a configuração manual.

Solução de problemas

• O nome já existe: escolha um nome de banco de dados exclusivo no espaço de trabalho selecionado.
• Permissões insuficientes: verifique se você tem direitos de administrador/membro do espaço de trabalho para criar bancos de dados.
• Erros de rede/locatário: reautentique ou alterne a conta subscrita no menu da conta.
• Tempo limite ou falha de provisionamento: se o assistente não se concluir, tente repetir a operação ou verifique a integridade do serviço Fabric.

Limitações conhecidas (Pré-visualização)

• O provisionamento é limitado a bancos de dados SQL no Fabric, outros tipos de item do Fabric estão fora do escopo.
• O provisionamento entre locatários é suportado quando você seleciona explicitamente um locatário diferente durante a autenticação. No entanto, cenários envolvendo vários locatários simultâneos ou fluxos de trabalho automatizados entre locatários ainda não são suportados.
• Não é possível enfileirar o provisionamento quando a capacidade está totalmente consumida.

Comentários 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

• Guia de início rápido: conectar-se e consultar um banco de dados com a extensão MSSQL para Visual Studio Code
• Contêiner local do SQL Server
• Designer de Esquemas
• Comparação de esquema