Início Rápido: Executar sua primeira consulta com a extensão MSSQL para Visual Studio Code

Neste início rápido, você usa a extensão MSSQL para Visual Studio Code para executar suas primeiras instruções Transact-SQL (T-SQL) em um banco de dados. Use um banco de dados de desenvolvimento existente ou crie um, defina uma tabela, insira dados de exemplo e consulte os resultados.

Pré-requisitos

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

Se você já tem um banco de dados de desenvolvimento, reutilize-o. Caso contrário, escolha um caminho de configuração:

Conectar-se ao seu banco de dados

Antes de executar uma consulta, conecte-se ao banco de dados do Pesquisador de Objetos. A caixa de diálogo Conexão orienta você a inserir um nome de servidor, escolher um tipo de autenticação e (opcionalmente) selecionar um banco de dados. Para obter um passo a passo completo de tipos de entrada, métodos de autenticação e gerenciamento de conexões, consulte Conectar-se a um banco de dados com a extensão MSSQL para Visual Studio Code.

Depois de se conectar, o servidor aparece no Pesquisador de Objetos e você pode começar a executar consultas.

Usar um banco de dados existente

Se você já provisionou um banco de dados da camada gratuita do Banco de Dados SQL do Azure, conecte-se diretamente a esse banco de dados. No Diálogo de Conexão, selecione ou insira o nome dela no campo Banco de Dados , em vez de deixar o banco de dados padrão selecionado. Você também pode usar esse caminho para outro banco de dados de desenvolvimento existente, incluindo um banco de dados SQL no Fabric.

  1. Abra um novo editor de consultas conectado ao banco de dados escolhido.

  2. Execute esta consulta para verificar o banco de dados ativo do editor:

    SELECT DB_NAME() AS current_database;

  3. Confirme se o resultado corresponde ao banco de dados que você pretende usar. Se isso não acontecer, selecione a conexão correta ao banco de dados e verifique novamente antes de executar qualquer instrução de exemplo.

  4. Pule Criar um banco de dados e continue com Criar uma tabela. Mantenha a mesma conexão com o banco de dados para os passos restantes.

Importante

A seguinte CREATE DATABASE Library declaração não provisiona um banco de dados na camada gratuita do Banco de Dados SQL do Azure. Não execute isso no caminho da camada gratuita. Crie a tabela do tutorial dentro do banco de dados gratuito que você já provisionou; não restaure nem importe outro banco de dados.

Criar um banco de dados

Se você precisar de um novo banco de dados no SQL Server ou Instância Gerenciada de SQL do Azure, crie um banco de dados chamado Library. Se você já tem um banco de dados de desenvolvimento, use Usar um banco de dados existente em vez disso.

Importante

Essa etapa cria um banco de dados genérico, não um banco de dados da camada gratuita. Adicionar outro banco de dados em nuvem pode gerar cobranças. Revise o preço do serviço e suas permissões antes de continuar.

  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. Cole o snippet a seguir no editor de consultas e clique em 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

Crie a Authors tabela dentro do seu banco de dados de desenvolvimento existente ou do Library banco de dados que você criou.

Importante

Execute cada etapa separadamente e pare se uma instrução falhar. Se dbo.Authors já existir, não use nem apague para este quickstart. Escolha um banco de dados de desenvolvimento diferente ou mude o nome da tabela de forma consistente em todas as instruções de exemplo antes de continuar.

  1. Certifique-se de que o editor de consultas esteja conectado ao banco de dados escolhido. Para o caminho da camada gratuita, use o nome do banco de dados gratuito, não Library ou master. Execute SELECT DB_NAME() AS current_database; novamente se abrir outro editor ou mudar de conexões.

  2. Crie a tabela. 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

Em seguida, insira dados na Authors tabela.

  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');

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
ORDER BY id;

Após uma inserção bem-sucedida na nova tabela, espere cinco linhas nesta ordem:

ID primeiro_nome middle_name sobrenome
1 Isaac Yudovick Asimov
2 Artur Charles Clarke
3 Herbert George Poços
4 Jules Gabriel Verne
5 Philip Kindred Dick

Limpar os recursos

Remova apenas a tabela de exemplo que você criou neste quickstart.

  1. Execute SELECT DB_NAME() AS current_database; e confirme que você está conectado ao banco de dados onde criou a tabela.

  2. Confirme que você criou dbo.Authors durante este guia e não precisa mais dos dados de amostra. Não continue se a criação da tabela falhou ou se a tabela pertencer a outro projeto.

  3. Execute a seguinte instrução para remover essa tabela:

    DROP TABLE dbo.Authors;

Não descarte um banco de dados existente, incluindo o banco de dados gratuito que você provisionou, como parte desta limpeza de exemplo.

Se você usar o nível gratuito, acompanhe sua cota restante e revise o comportamento de pausa e excedente. Desconecte os editores de consultas e a conexão do Pesquisador de Objetos quando terminar. Sessões abertas podem evitar pausas automáticas ociosas; desconectar não restaura os segundos vCore já consumidos. Uma consulta bem-sucedida não estabelece compatibilidade de carga de trabalho nem garante que o uso futuro permaneça dentro da franquia gratuita.

Conteúdo relacionado

  • Última atualização em