Guia de início rápido: criar um ambiente de desenvolvimento local para o Banco de Dados SQL do Azure

Artigo
07/31/2023

Aplica-se a:Banco de Dados SQL do Azure

A experiência de desenvolvimento local do Banco de Dados SQL do Azure fornece uma maneira de projetar, editar, criar/validar, publicar e executar esquemas de banco de dados em um emulador local do Banco de Dados SQL do Azure. Com o recurso Projetos de Banco de Dados, os desenvolvedores podem publicar facilmente Projetos de Banco de Dados no serviço público do Banco de Dados SQL do Azure a partir de seu ambiente local, bem como gerenciar todo o ciclo de vida de seus bancos de dados (por exemplo, gerenciar desvios de esquema e tal). Este Guia de início rápido ensina todo o fluxo de trabalho que aproveita a experiência de desenvolvimento local do Banco de Dados SQL do Azure.

Pré-requisitos

Para concluir este Guia de início rápido, você deve primeiro Configurar um ambiente de desenvolvimento local para o Banco de Dados SQL do Azure.

Criar um projeto em branco

Para começar, crie um projeto de banco de dados em branco ou abra um projeto existente. As etapas nesta seção ajudam a criar um novo projeto em branco, mas você também pode:

Abra um projeto existente indo para a visualização Projetos de Banco de Dados ou procurando por Projetos de Banco de Dados: Abrir Existente na paleta de comandos.
Inicie a partir de um banco de dados existente selecionando Criar projeto do banco de dados na paleta de comandos ou no menu de contexto do banco de dados .
Inicie a partir de uma especificação OpenAPI/Swagger usando o comando Database Projects: Generate SQL Project from OpenAPI/Swagger spec (Preview) na paleta de comandos.

As etapas para criar um novo projeto usando o Visual Studio Code ou o Azure Data Studio são as mesmas. Para criar um projeto em branco, execute estas etapas:

Abra a ferramenta de desenvolvedor escolhida, Azure Data Studio ou Visual Studio Code.
Selecione Projetos e, em seguida, escolha criar um novo Projeto de Banco de Dados. Como alternativa, procure por Projetos de Banco de Dados: Novo na paleta de comandos.
Escolha Banco de dados SQL como seu tipo de projeto.
Forneça um nome para o novo projeto de banco de dados SQL.
Selecione o projeto de projeto de banco de dados SQL no estilo SDK. (O projeto SQL no estilo SDK é recomendado por ser mais conciso e gerenciável ao trabalhar com vários desenvolvedores no repositório de uma equipe.)
Para definir a plataforma de destino para seu projeto, clique com o botão direito do mouse no nome do projeto de banco de dados e escolha Alterar plataforma de destino. Selecione o Banco de Dados SQL do Azure como a plataforma de destino para seu projeto.

A definição da plataforma de destino fornece suporte a edição e tempo de compilação para seus objetos e scripts do Projeto do Banco de Dados SQL. Depois de selecionar sua plataforma de destino, o Visual Studio Code destaca problemas de sintaxe ou indica que a plataforma selecionada está usando recursos sem suporte.

Opcionalmente, os arquivos de projeto do Banco de dados SQL podem ser colocados sob controle do código-fonte junto com seus projetos de aplicativo.
Adicione objetos ao seu projeto de banco de dados. Você pode criar ou alterar objetos de banco de dados, como tabelas, exibições, procedimentos armazenados e scripts. Por exemplo, clique com o botão direito do mouse no nome do Projeto de Banco de Dados e selecione Adicionar Tabela para adicionar uma tabela.
Crie seu projeto de banco de dados para validar que ele funcionará na plataforma Banco de dados SQL do Azure. Para criar seu projeto, clique com o botão direito do mouse no nome do projeto de banco de dados e selecione Compilar.
Quando o projeto de banco de dados estiver pronto para ser testado, publique-o em um destino. Para iniciar o processo de publicação, clique com o botão direito do mouse no nome do seu projeto de banco de dados e selecione Publicar.
Ao publicar, você pode optar por publicar em um servidor novo ou existente. Neste exemplo, escolhemos Publicar em um novo emulador do Banco de Dados SQL do Azure.
Ao publicar em um novo emulador do Banco de Dados SQL do Azure, você será solicitado a escolher entre imagens Lite e Completas. A imagem Lite tem compatibilidade com a maioria dos recursos do Banco de Dados SQL do Azure e é uma imagem leve que leva menos para baixar e instanciar. A imagem completa dá-lhe acesso a funcionalidades avançadas, como tabelas otimizadas na memória, tipos de dados geoespaciais e muito mais, mas requer mais recursos.

Você pode criar quantas instâncias locais forem necessárias com base nos recursos disponíveis e gerenciar seu ciclo de vida por meio dos comandos Visual Studio Code Docker Extension ou CLI.
Depois que as instâncias de seus Projetos de Banco de Dados estiverem em execução, você poderá se conectar a partir da extensão mssql do Visual Studio Code e testar seus scripts e consultas, como qualquer banco de dados regular no Banco de Dados SQL do Azure.
Reconstrua e implante seu projeto de banco de dados em uma das instâncias em contêiner em execução em sua máquina local a cada iteração de adição ou modificação de objetos em seu projeto de banco de dados, até que esteja pronto.
A etapa final do ciclo de vida do Projeto de Banco de Dados é publicar o artefato concluído em um banco de dados novo ou existente no Banco de Dados SQL do Azure usando a extensão mssql. Clique com o botão direito do mouse no nome do projeto de banco de dados e escolha Publicar. Em seguida, selecione o destino onde você deseja publicar seu projeto, como um servidor lógico novo ou existente no Azure.