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 Azure Instância Gerenciada de SQL do Azure

O Visual Studio Code é um editor de código gráfico para Linux, macOS e Windows. Dá suporte a extensões, inclusive a extensão mssql para consultar o SQL Server, a Banco de dados SQL do Azure, a Instância gerenciada de SQL do Azure e um banco de dados no Azure Synapse Analytics. 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

• Um banco de dados no Banco de Dados SQL do Azure ou na Instância Gerenciada de SQL do Azure. Você pode usar um destes guias de início rápido para criar e, em seguida, configurar um banco de dados no Banco de Dados SQL do Azure:

  Ação	Banco de Dados SQL do Azure	Instância Gerenciada do Azure SQL
  Criar	Portal	Portal
  	CLI	CLI
  	PowerShell	PowerShell
  Configurar	Regra de firewall de IP no nível do servidor	Conectividade em uma VM (máquina virtual)
  		Conectividade do local
  Carregar dados	Importadores do mundo inteiro carregados por início rápido	Restaurar o Wide World Importers
  		Restaurar ou importar o Adventure Works de um arquivo BACPAC do GitHub

  Importante

  Os scripts deste artigo são escritos para usar o banco de dados do Adventure Works. Com uma Instância Gerenciada de SQL, importe o banco de dados Adventure Works para um banco de dados de instância ou altere os scripts deste artigo para usar o banco de dados da Wide World Importers.

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 estas etapas:

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 obter diretrizes de instalação adicionais, consulte mssql para Visual Studio Code.

macOS

Para o macOS, é necessário instalar o OpenSSL, que é um pré-requisito do .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 estas etapas:

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 obter diretrizes de instalação adicionais, consulte 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 de perfil da conexão, se você mudar o foco 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.

   Propriedade	Valor sugerido	Descrição
   Nome do servidor	O nome do servidor totalmente qualificado	Algo como: mynewserver20170313.database.windows.net.
   Nome do banco de dados	mySampleDatabase	O banco de dados ao qual se conectar.
   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 dados

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.

   

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.

Conteúdo relacionado

• Guia de início rápido: usar o SQL Server Management Studio para se conectar a um banco de dados no Banco de Dados SQL do Azure e consultar dados
• Usar o editor SQL Query no portal do Azure para conectar e consultar dados
• Criar um IDE de banco de dados com postagem de blog de extensão MSSQL