Início rápido: Faça a sua primeira consulta com a extensão MSSQL para Visual Studio Code

Neste quickstart, usas a extensão MSSQL para Visual Studio Code para executar as tuas primeiras instruções Transact-SQL (T-SQL) contra uma base de dados. Use uma base de dados de desenvolvimento existente ou crie uma, defina uma tabela, insira dados de exemplo e consulte os resultados.

Pré-requisitos

Para concluir este arranque rápido, necessita de:

Se já tens uma base de dados de desenvolvimento, reutiliza-a. Caso contrário, escolha um caminho de configuração:

Ligar à sua base de dados

Antes de executar uma consulta, ligue-se à base de dados a partir do Object Explorer. O Diálogo de Ligação guia-o na introdução de um nome de servidor, na escolha de um tipo de autenticação e (opcionalmente) na seleção de uma base de dados. Para um guia completo dos tipos de entrada, métodos de autenticação e gestão de ligações, veja Ligar a uma base de dados com a extensão MSSQL para Visual Studio Code.

Depois de te ligares, o teu servidor aparece no Object Explorer e podes começar a fazer consultas.

Utilizar uma base de dados existente

Se já aprovisionaste uma base de dados gratuita do Base de Dados SQL do Azure, liga-te diretamente a essa base de dados. No Diálogo de Ligação, selecione ou insira o nome da base de dados no campo Base de Dados em vez de deixar a base de dados padrão selecionada. Também pode usar este caminho para outra base de dados de desenvolvimento existente, incluindo uma base de dados SQL no Fabric.

  1. Abra um novo editor de consultas ligado à base de dados escolhida.

  2. Execute esta consulta para verificar a base de dados ativa do editor:

    SELECT DB_NAME() AS current_database;

  3. Confirme que o resultado corresponde à base de dados que pretende usar. Se isso não acontecer, selecione a ligação correta à base de dados e verifique novamente antes de executar quaisquer instruções de exemplo.

  4. Saltar a etapa Criar uma base de dados e continuar com Criar uma tabela. Mantém a mesma ligação à base de dados para os passos restantes.

Importante

A seguinte CREATE DATABASE Library declaração não aprovisiona uma base de dados no escalão gratuito do Base de Dados SQL do Azure. Não o executes para o caminho do plano gratuito. Cria a tabela do tutorial dentro da base de dados gratuita que já provisionaste; não restaures nem importes outra base de dados.

Criar uma base de dados

Se precisar de uma nova base de dados no SQL Server ou no Azure SQL Managed Instance, crie uma base de dados com o nome Library. Se já tens uma base de dados de desenvolvimento, usa Usar uma base de dados existente em vez disso.

Importante

Este passo cria uma base de dados genérica, não uma base de dados do escalão gratuito. Adicionar outra base de dados na nuvem pode gerar custos. Revise os preços do serviço e as 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 no seu servidor e selecione Nova Consulta.

  2. Cria a base de dados. Cole o seguinte trecho no editor de consultas e selecione Executar:

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

    Esse script cria 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 da sua base de dados de desenvolvimento existente ou da Library base de dados que criou.

Importante

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

  1. Certifica-te de que o editor de consultas está ligado à base de dados escolhida. Para o caminho do tier livre, use o nome da base de dados livre, não Library nem master. Executa SELECT DB_NAME() AS current_database; novamente se abrires outro editor ou alterares as ligações.

  2. Cria a tabela. Substitua o texto na janela de consulta pelo seguinte trecho 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
);

Este script cria a tabela Authors com uma coluna IDENTITY para o id, que gera automaticamente IDs exclusivos.

Inserir linhas

De seguida, insira os dados na Authors tabela.

  1. Substitua o texto na janela de consulta pelo seguinte trecho 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 amostra são adicionados à Authors tabela.

Ver 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 nome do meio sobrenome
1 Isaac Yudovick Asimov
2 Artur Charles Clarke
3 Herbert George Wells
4 Jules Gabriel Verne
5 Philip Kindred Dick

Limpeza de recursos

Remove apenas a tabela de exemplo que criaste neste quickstart.

  1. Executa SELECT DB_NAME() AS current_database; e confirma que estás ligado à base de dados onde criaste a tabela.

  2. Confirme que criou dbo.Authors durante este guia e que já não precisa dos seus dados de amostra. Não continue se a criação da tabela falhou ou se a tabela pertence a outro projeto.

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

    DROP TABLE dbo.Authors;

Não elimine uma base de dados existente, incluindo a base de dados do nível gratuito que provisionou, como parte desta limpeza de exemplo.

Se usares o nível gratuito, regista o teu limite restante e revê o comportamento de pausa e de excesso de utilização. Desligue os editores de consultas e a ligação do Object Explorer quando terminar. As sessões abertas podem impedir a pausa automática por inatividade; desconectar-se não restaura os segundos de vCore já consumidos. Uma consulta bem-sucedida não estabelece compatibilidade de carga de trabalho nem garante que o uso futuro se mantenha dentro da quota gratuita.

Conteúdo relacionado

  • Última atualização a