Integração da malha

A extensão MSSQL para Visual Studio Code dá suporte à conexão ao banco de dados SQL no Microsoft Fabric. A caixa de diálogo Conexão inclui uma opção de conectividade do Fabric que você usa para fazer login usando Microsoft Entra ID. Você pode procurar workspaces da malha em um modo de exibição de árvore, pesquisar entre workspaces e conectar-se a pontos de extremidade ou bancos de dados SQL sem configurar cadeias de caracteres manualmente. A extensão aceita logon persistente, troca de locatário e um fluxo integrado Open em MSSQL na extensão da malha.

Você pode criar novos bancos de dados SQL no Fabric diretamente do Visual Studio Code. Autentique, selecione ou crie um workspace, especifique um nome de banco de dados e conecte-se após a conclusão do provisionamento. Um indicador mantém você atualizado sobre o andamento.

Conectividade da malha (Procurar)

Use a experiência de navegação da malha na extensão MSSQL para se conectar ao seu banco de dados SQL na malha ou aos pontos de extremidade de análise do SQL na malha sem copiar manualmente cadeias de caracteres de conexão do portal da malha.

Capabilities

  • Experiência dedicada do Fabric: uma opção específica do Fabric na caixa de diálogo Conexão para se conectar aos bancos de dados do Fabric.

  • Logon único: usa o conta Microsoft para entrar. Você se autentica uma vez para acessar todos os seus workspaces e bancos de dados do Fabric.

  • Navegação de workspaces: apresenta todos os workspaces da malha em uma visualização em árvore hierárquica com os recursos carregados sob demanda.

  • Pesquisa e descoberta: busca em tempo real para encontrar workspaces ou bancos de dados, sem precisar rolar por listas extensas.

  • Suporte a extensões cruzadas: abra bancos de dados do Fabric na extensão MSSQL, a partir da extensão ou do portal do Fabric.

Pré-requisitos

  • Instale a versão mais recente da extensão MSSQL para Visual Studio Code.
  • Permissões de assinatura ativas da malha e de workspace.
  • Uma conta microsoft válida com acesso aos seus workspaces e recursos do Fabric.
  • ID do Microsoft Entra para autenticação. 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.

Observação

Para esta experiência de conectividade da malha (Procurar), você não precisa de cadeias de caracteres de conexão nem tokens de acesso pessoal.

Introdução

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

    Captura de tela da conectividade do Fabric na extensão MSSQL para Visual Studio Code.

  2. Entre com a ID do Microsoft Entra.

    Autenticação pela primeira vez

    • O tipo de autenticação usa como padrão a ID do Microsoft Entra – Universal com suporte de 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.
    • Essa seleção 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.

    Captura de tela da conexão com o Fabric por meio da experiência de navegação do Fabric.

  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.

    Captura de tela da nova conexão do Fabric no Pesquisador de Objetos.

Dica

Use Pesquisa na parte superior da árvore para localizar rapidamente um workspace ou banco de dados. Os resultados priorizam as correspondências mais próximas e os itens usados recentemente.

Erros e casos extremos

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

Tipo Message Ação recomendada
Sem acesso à área de trabalho You do not have permission to view this workspace. Solicitar acesso ou alternar conta.
Serviço indisponível ou limitado Fabric service is temporarily unavailable. Tente novamente ou verifique a integridade do serviço.
Sessão expirada Your session has expired. Reautenticar com a ID do Microsoft Entra.
Restrições de rede Connection blocked by network policy. Verifique as configurações corporativas, VPN ou firewall.

Importante

Para manter a árvore responsiva, ao navegar por locatários grandes, os itens filhos podem ser carregados sob demanda. Você pode observar indicadores de carregamento breves ao expandir nós com muitos itens.

Limitações conhecidas

  • Há suporte apenas para bancos de dados SQL e pontos de extremidade de análise SQL. Você não pode abrir outros tipos de itens Fabric a partir da extensão MSSQL.
  • Você pode navegar entre locatários alternando-os, mas é necessário criar cada conexão de banco de dados 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.

Provisionar um 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. Você pode criar e se conectar a novos bancos de dados SQL do Fabric sem sair do Visual Studio Code.

Capabilities

  • Fluxo de trabalho guiado: orienta você pela autenticação, seleção ou criação do espaço de trabalho, nomenclatura de banco de dados e provisionamento a partir da página Implantações.

  • Conexão imediata: adiciona automaticamente o banco de dados provisionado recentemente à sua lista de conexões.

  • Experiência consistente: segue o mesmo fluxo de provisionamento que outros back-ends com suporte, como contêineres locais do SQL Server.

  • Reconhecimento de capacidade: indica quando as restrições de capacidade desabilitam workspaces, com dicas de ferramenta explicando o motivo.

Pré-requisitos

  • Uma assinatura válida do Microsoft Fabric.
  • Capacidade suficiente no workspace de destino para provisionar novos bancos de dados SQL.
  • Conta do Microsoft Entra ID com as permissões necessárias de workspace (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. Autenticação com o Microsoft Entra ID.
  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.

Dica

O fluxo de ponta a ponta normalmente termina em menos de um minuto.

A animação a seguir mostra o banco de dados SQL no fluxo de trabalho de provisionamento do Fabric em ação:

Captura de tela da animação mostrando o banco de dados SQL de ponta a ponta no fluxo de provisionamento do Fabric.

Detalhes de conscientização de capacidade

  • O fluxo de provisionamento valida a capacidade da conta do Fabric e do workspace para garantir que o banco de dados possa ser criado com êxito.
  • A lista suspensa de workspaces mostra workspaces sem capacidade disponível como desabilitados, com uma dica de ferramenta explicando o motivo.

Captura de tela do menu suspenso mostrando workspaces desabilitados devido a limitações de capacidade.

Comportamento pós-provisionamento

  • A nova conexão adota o Grupo de Conexões selecionado (opcional) para identificação visual rápida.
  • Você pode emparelhar essa experiência com o recurso de navegação do Fabric para descobrir e conectar-se ao banco de dados recém-criado de outro ambiente do Visual Studio Code.

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 ou locatário: autentique novamente ou alterne a conta conectada 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 integridade do serviço da malha.

Limitações conhecidas

  • Você só pode provisionar bancos de dados SQL no Fabric. Não há suporte para outros tipos de item do Fabric.
  • Você pode provisionar entre diferentes locatários quando você selecionar explicitamente um locatário diferente durante a autenticação. No entanto, o Visual Studio Code ainda não dá suporte a cenários que envolvem vários locatários simultâneos ou fluxos de trabalho automatizados entre locatários.
  • Não é possível fazer o provisionamento de filas quando a capacidade é totalmente consumida.

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 https://aka.ms/vscode-mssql-bug. Para solicitar um novo recurso, vá para https://aka.ms/vscode-mssql-feature-request.

Conteúdo relacionado

  • Last updated on