Ler em inglês

Compartilhar via

Início Rápido: Conectar e consultar um banco de dados com a extensão MSSQL para Visual Studio Code

  • Artigo
  • 21/04/2025

Neste início rápido, você aprenderá a usar a extensão MSSQL para Visual Studio Code para se conectar a um banco de dados, esteja ele em execução localmente, em um contêiner ou na nuvem. Em seguida, você aprenderá a usar instruções T-SQL (Transact-SQL) para criar um banco de dados, definir uma tabela, inserir dados e consultar resultados.

Pré-requisitos

Para concluir este início rápido, você precisa ter:

  • Visual Studio Code: se você não tiver o Visual Studio Code instalado, baixe-o e instale-o no site oficial do Visual Studio Code.

  • Extensão MSSQL para Visual Studio Code: no Visual Studio Code, abra o modo de exibição Extensões selecionando o ícone Extensões na Barra de Atividades na lateral da janela. Pesquise mssql e selecione Instalar para adicionar a extensão.

  • Acesso a um banco de dados: se você não tiver acesso a uma instância de banco de dados, poderá usar uma selecionando uma das seguintes opções:

Observação

Caso não tenha uma assinatura do Azure, crie uma conta gratuita.

Conecte-se a uma instância de banco de dados

  1. Inicie o Visual Studio Code: abra a extensão MSSQL para Visual Studio Code** selecionando o viewlet do servidor no lado esquerdo da janela ou pressionando Ctrl+Alt+D.

    Na primeira vez em que você executa a extensão MSSQL para Visual Studio Code, o botão Habilitar Experiências e Recarregar aparece quando a extensão é carregada pela primeira vez.

  2. Conectar ao banco de dados:

    Este artigo usa o tipo de entrada Parâmetro e o Logon do SQL para o tipo de autenticação.

    Siga os prompts para especificar as propriedades para o novo perfil de conexão. Preencha cada campo da seguinte maneira:

    Propriedades da conexão Valor Descrição
    Nome do Perfil (opcional) Deixe este campo em branco. Digite um nome para o perfil de conexão. como perfil do localhost.
    Nome do servidor Insira o nome do servidor. Por exemplo: localhost Especifique o nome da instância do SQL Server. Use localhost para conectar-se a uma instância do SQL Server em seu computador local. Para conectar-se a um SQL Server remoto, insira o nome do SQL Server de destino ou seu endereço IP. Para conectar-se a um contêiner do SQL Server, especifique o endereço IP do computador host do contêiner. Se você precisar especificar uma porta, use uma vírgula para separá-la do nome. Por exemplo, para um servidor que escuta na porta 1401, insira <servername or IP>,1401.

    Por padrão, a cadeia de conexão usa a porta 1433. Uma instância padrão do SQL Server usa a 1433, a menos que essa opção seja modificada. Se sua instância estiver escutando na 1433, você não precisará especificar a porta.
    Como alternativa, você pode inserir a cadeia de conexão ADO para seu banco de dados aqui.
    Certificado do Servidor de Confiança Verifique este campo. Selecione esta opção para confiar no certificado do servidor.
    Tipo de entrada Parâmetro. Escolha entre Parâmetro, Cadeia de Conexão ou Procurar no Azure.
    Nome do banco de dados (opcional) <Padrão>. O banco de dados que você deseja usar. Para conectar-se ao banco de dados padrão, não especifique um nome de banco de dados aqui.
    Tipo de Autenticação Logon do SQL. Escolha o Logon do SQL, a Autenticação do Windows ou o Microsoft Entra ID.
    Nome de usuário Insira seu <nome de usuário> do SQL Server. Se você tiver selecionado o Logon do SQL, insira o nome de um usuário com acesso a um banco de dados no servidor.
    Senha Insira sua <senha> do SQL Server. Digite a senha para o usuário especificado.
    Salvar Senha Verifique este campo para salvar a senha para conexões futuras. Pressione Enter para selecionar Sim e salvar a senha. Selecione Não para que a senha seja solicitada sempre que o perfil de conexão for usado.
    Encrypt Obrigatório. Escolha entre Sim, Nãoou Obrigatório.

    Depois de inserir todos os valores e selecionar Enter, o Visual Studio Code cria o perfil de conexão e conecta-se ao SQL Server.

    Captura de tela da janela de diálogo de conexão.

Criar um banco de dados

Vamos começar criando um banco de dados chamado Library.

  1. Abra um novo editor de consultas: pressione Ctrl+N para abrir um novo editor de consultas ou clique com o botão direito do mouse no servidor e selecione Nova Consulta.

  2. Crie o banco de dados colando o seguinte snippet no editor de consultas e selecionando Executar:

    IF NOT EXISTS (SELECT name
               FROM sys.databases
               WHERE name = N'Library')
    CREATE DATABASE Library;

    Esse script criará um novo banco de dados chamado Library se ele ainda não existir.

O novo banco de dados Library aparece na lista de bancos de dados. Se você não vê-lo imediatamente, atualize o Pesquisador de Objetos.

Criar uma tabela

Agora, vamos criar a tabela Authors dentro do banco de dados Library.

  1. Abra um novo editor de consultas e verifique se o contexto de conexão está definido para o banco de dados Library.

  2. O código a seguir cria a tabela Authors com uma coluna IDENTITY para a chave primária. Substitua o texto na janela de consulta pelo seguinte snippet e selecione Executar:

    CREATE TABLE dbo.Authors
(
    id INT IDENTITY (1, 1) NOT NULL PRIMARY KEY,
    first_name NVARCHAR (100) NOT NULL,
    middle_name NVARCHAR (100) NULL,
    last_name NVARCHAR (100) NOT NULL
);

Esse script cria a tabela Authors com uma coluna IDENTITY para a id, que gera automaticamente IDs exclusivas.

Inserir linhas

Agora, vamos inserir alguns dados na tabela Authors.

  1. Substitua o texto na janela de consulta pelo seguinte snippet e selecione Executar:

    INSERT INTO dbo.Authors (first_name, middle_name, last_name)
VALUES ('Isaac', 'Yudovick', 'Asimov'),
    ('Arthur', 'Charles', 'Clarke'),
    ('Herbert', 'George', 'Wells'),
    ('Jules', 'Gabriel', 'Verne'),
    ('Philip', 'Kindred', 'Dick');

Como resultado, os dados de exemplo são adicionados à tabela Authors.

Exibir os dados

Para verificar os dados na tabela Authors, execute a seguinte consulta:

SELECT *
FROM dbo.Authors;

Essa consulta retorna todos os registros na tabela Authors, mostrando os dados inseridos.

Conteúdo relacionado