Início Rápido: Usar o Visual Studio Code para se conectar e consultar um Banco de Dados SQL do Azure ou uma Instância Gerenciada de SQL do Azure

Aplica-se a:Banco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

O Visual Studio Code é um editor de código gráfico para Linux, macOS e Windows. Ele suporta extensões, incluindo a extensão MSSQL para consulta ao SQL Server, Banco de Dados SQL do Azure, Instância Gerenciada de SQL do Azure, banco de dados SQL no Microsoft Fabric e outras plataformas. Neste início rápido, você usará o Visual Studio Code para se conectar a um Banco de Dados SQL do Azure ou a uma Instância Gerenciada de SQL do Azure e, em seguida, executará instruções Transact-SQL para consultar, inserir, atualizar e excluir dados.

Pré-requisitos

Instalar o Visual Studio Code

Verifique se instalou o Visual Studio Code mais recente. Para obter diretrizes de instalação, consulte Instalar o Visual Studio Code.

Configurar o Visual Studio Code

Para configurar o Visual Studio Code para se conectar ao Banco de Dados SQL do Azure ou à Instância Gerenciada de SQL do Azure, é necessário instalar as extensões e dependências necessárias com base em seu sistema operacional. Siga as etapas abaixo do seu SO específico para começar.

Windows

Carregue a extensão MSSQL seguindo estes passos:

  1. Abra o Visual Studio Code.
  2. Abra o painel Extensões (ou Ctrl + Shift + X).
  3. Procure sql e instale a extensão do SQL Server (mssql).

Para orientações adicionais sobre instalação, veja a extensão MSSQL para Visual Studio Code.

macOS

Para macOS, você precisa instalar o OpenSSL, que é um pré-requisito para o .NET Core que a extensão MSSQL usa. Abra seu terminal e digite os seguintes comandos para instalar o brew e o OpenSSL.

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew update
brew install openssl
mkdir -p /usr/local/lib
ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/

Linux (Ubuntu)

Carregue a extensão MSSQL seguindo estes passos:

  1. Abra o Visual Studio Code.
  2. Abra o painel Extensões (ou Ctrl + Shift + X).
  3. Procure sql e instale a extensão do SQL Server (mssql).

Para orientações adicionais sobre instalação, veja a extensão MSSQL para Visual Studio Code.

Obter informações de conexão do servidor

Obtenha as informações de conexão necessárias para se conectar ao Banco de Dados SQL do Azure. Você precisará do nome totalmente qualificado do servidor ou do host, do nome do banco de dados e das informações de logon nos próximos procedimentos.

  1. Entre no portal do Azure.

  2. Navegue até a página bancos de dados SQL ou Instâncias Gerenciadas de SQL.

  3. Na página Visão geral, examine o nome do servidor totalmente qualificado próximo do Nome do servidor para o Banco de Dados SQL ou o nome do servidor totalmente qualificado próximo ao Host para uma Instância Gerenciada de SQL. Para copiar o nome do servidor ou o nome do host, passe o mouse sobre ele e selecione o ícone Copiar.

Definir o modo de linguagem para SQL

No Visual Studio Code, defina o modo de linguagem como SQL para permitir comandos mssql e T-SQL IntelliSense.

  1. Abra uma nova janela do Visual Studio Code.

  2. Pressione Ctrl + N. Um novo arquivo de texto sem formatação é aberto.

  3. Selecione Texto sem Formatação no canto inferior direito da barra de status.

  4. Na lista suspensa Selecionar modo de linguagem que é aberta, selecione SQL.

Conectar-se ao seu banco de dados

Use o Visual Studio Code para estabelecer uma conexão com seu servidor.

Importante

Antes de continuar, verifique se o servidor e as informações de entrada estão prontos. Depois de começar a inserir as informações do perfil de conexão, se você mudar o foco para fora do Visual Studio Code, terá que reiniciar a criação do perfil.

  1. No Visual Studio Code, pressione CTRL + Shift + P (ou F1) para abrir a Paleta de Comandos.

  2. Digite connect e escolha MS SQL:Connect.

  3. Selecione + Criar perfil de conexão.

  4. Siga os prompts para especificar as propriedades de conexão do novo perfil. Depois de especificar cada valor, pressione Enter para continuar.

    Property Valor sugerido Description
    Nome do servidor O nome do servidor totalmente qualificado Algo como: <Contoso-server-name>.database.windows.net.
    Nome do banco de dados Seu nome de banco de dados Para o caminho da camada gratuita, insira o nome do banco de dados gratuito que você já provisionou. Para o caminho Adventure Works, insira o banco de dados que contém as tabelas de exemplo, como mySampleDatabase.
    Autenticação Logon do SQL Este tutorial usa a autenticação do SQL.
    Nome de usuário Nome de usuário O nome de usuário da conta do administrador de servidor usada para criar o servidor.
    Senha (Logon do SQL) Senha A senha de usuário da conta do administrador de servidor usada para criar o servidor.
    Salvar senha? Sim ou não Selecione Sim se você não quiser inserir a senha a cada vez.
    Inserir um nome para este perfil Um nome do perfil, como mySampleProfile Um perfil salvo acelera sua conexão nos logons subsequentes.

    Se for bem-sucedido, uma notificação será exibida informando que seu perfil foi criado e está conectado.

Consultar um banco de dados existente da camada gratuita

Use este caminho se você se conectou a um novo banco de dados vazio da camada gratuita do Banco de Dados SQL do Azure.

  1. Execute esta consulta no editor:

    SELECT DB_NAME() AS current_database;
    
  2. Confirme se o resultado é o nome do banco de dados gratuito que você provisionou, e não master ou outro banco de dados. Se não bater, reconecte-se ao banco de dados pretendido antes de continuar.

  3. Siga as instruções em Criar uma tabela, Insira linhas e Visualize os dados no guia de início rápido da primeira consulta do MSSQL. Esses passos criam dbo.Authors e consultam as cinco linhas de exemplo dele no seu banco de dados existente. Você precisa de permissão para criar a tabela e modificar seus dados. Pule a etapa genérica de Criar um banco de dados daquele quickstart; CREATE DATABASE Library não provisiona um banco de dados de nível gratuito.

  4. Siga as instruções de Limpar recursos desse quickstart para remover apenas a tabela de exemplo que você criou, após verificar o banco de dados e a propriedade da tabela. Não descarte seu banco de dados gratuito.

  5. Acompanhe sua franquia restante e revise o comportamento de pausa e consumo excedente. Desconecte os editores de consultas e o Pesquisador de Objetos quando terminar. Conexões abertas podem evitar a pausa automática por inatividade; desconectar não restaura o uso já consumido.

Você pode continuar construindo no mesmo banco de dados. A conclusão de consultas não estabelece compatibilidade de carga de trabalho nem garante que o uso futuro permaneça dentro da cota gratuita. Não execute os exemplos a seguir do Adventure Works, a menos que você tenha escolhido separadamente a opção de banco de dados de exemplo e tenha suas tabelas obrigatórias.

Consultar dados

Os demais exemplos de consulta, inserção, atualização e exclusão usam Adventure Works, não o caminho do banco de dados vazio da camada gratuita.

Execute a instrução Transact-SQL SELECT a seguir para consultar os 20 principais produtos por categoria.

  1. Na janela do editor, cole a seguinte consulta SQL.

    SELECT pc.Name AS CategoryName,
        p.name AS ProductName
    FROM [SalesLT].[ProductCategory] pc
    INNER JOIN [SalesLT].[Product] p
        ON pc.ProductCategoryId = p.ProductCategoryId;
    
  2. Pressione Ctrl + Shift + E para executar a consulta e exibir os resultados das tabelas Product e ProductCategory.

    Captura de tela da consulta para recuperar dados de duas tabelas.

Inserir dados

Execute a instrução Transact-SQL INSERT a seguir para adicionar um novo produto à tabela SalesLT.Product.

  1. Substitua a consulta anterior por esta.

    INSERT INTO [SalesLT].[Product] (
        [Name],
        [ProductNumber],
        [Color],
        [ProductCategoryID],
        [StandardCost],
        [ListPrice],
        [SellStartDate]
     )
     VALUES (
        'myNewProduct',
        123456789,
        'NewColor',
        1,
        100,
        100,
        GETDATE()
     );
    
  2. Pressione Ctrl + Shift + E para inserir uma nova linha na tabela Product.

Atualizar dados

Execute a instrução Transact-SQL UPDATE a seguir para atualizar o produto adicionado.

  1. Substitua a consulta anterior por esta:

    UPDATE [SalesLT].[Product]
    SET [ListPrice] = 125
    WHERE Name = 'myNewProduct';
    
  2. Pressione Ctrl + Shift + E para atualizar a linha especificada na tabela Product.

Excluir dados

Execute a instrução Transact-SQL DELETE a seguir para remover o novo produto.

  1. Substitua a consulta anterior por esta:

    DELETE FROM [SalesLT].[Product]
    WHERE Name = 'myNewProduct';
    
  2. Pressione Ctrl + Shift + E para excluir a linha especificada na tabela Product.