Construa e teste aplicações com o Base de Dados SQL do Azure free tier

Use o portal do Azure para criar o novo Banco de Dados SQL do Azure gratuito. Para criar uma base de dados de escalão gratuito, siga estes passos:

1. Vá para o hub SQL do Azure em aka.ms/azuresqlhub.

2. No painel Criar uma base de dados, selecione Iniciar livre.

3. No separador Noções básicas:

   1. Em Detalhes do projeto:
      • Selecione a sua Subscrição. A tua subscrição atual já está selecionada.
      • Já foi selecionado um Grupo de Recursos existente. Pode selecionar um grupo de recursos diferente ou criar um novo.
   2. Em detalhes da base de dados:
      • Utilize o nome único da base de dados criado automaticamente, ou forneça um novo nome.
      • Um servidor lógico existente já está selecionado. Podes escolher um servidor lógico diferente ou criar um novo.

   O cartão de resumo de Custos no lado direito da página mostra um Custo Estimado/Mês de zero. A base de dados é criada com definições predefinidas, incluindo a opção de pausar a base de dados quando os limites gratuitos forem atingidos. Podes alterar estas definições da base de dados mais tarde.

4. Selecione Verificar + criar.

5. Revise e selecione Criar.

Utilize um servidor lógico existente na subscrição ativa, ou crie um novo. O grupo de recursos já deve existir. Para a configuração completa do servidor, consulte Criar uma única base de dados.

Se precisares de um novo servidor lógico, cria-o primeiro:

az sql server create --name <server-name> --resource-group <resource-group> --location <region> --admin-user <admin-login> --admin-password <admin-password>

Se planeia usar um servidor existente, verifique o nome do servidor e o grupo de recursos:

az sql server show --name <server-name> --resource-group <resource-group> --output table

Depois cria a base de dados nesse servidor com az sql db create e --use-free-limit true. Sem este parâmetro, acabará por criar uma base de dados serverless faturável.

az sql db create --name <database-name> --server <server-name> --resource-group <resource-group> --edition GeneralPurpose --family Gen5 --capacity 2 --compute-model Serverless --use-free-limit true --free-limit-exhaustion-behavior AutoPause

O comando está numa linha, por isso podes usá-lo no PowerShell, Bash ou noutro shell suportado sem alterar caracteres de continuação de linha.

Para estabelecer ligação a partir do seu computador, adicione o respetivo endereço IP público ao firewall do servidor lógico. Substitua <client-ip-address> pelo seu endereço IPv4 público:

az sql server firewall-rule create --name AllowClientIp --server <server-name> --resource-group <resource-group> --start-ip-address <client-ip-address> --end-ip-address <client-ip-address>

Utilize AutoPause para pausar no limite mensal gratuito ou BillOverUsage para continuar com as cobranças. Para obter mais informações, consulte Considerações e limitações.

Instale o módulo PowerShell do Az.Sql e inicie sessão com Connect-AzAccount. Utilize um servidor lógico existente na subscrição ativa, ou crie um novo. O grupo de recursos já deve existir.

Se precisares de um novo servidor lógico, cria-o primeiro. O prompt de comando pede-lhe as credenciais de administrador do servidor:

New-AzSqlServer -ResourceGroupName "<resource-group>" -ServerName "<server-name>" -Location "<region>" -ServerVersion "12.0" -SqlAdministratorCredentials (Get-Credential)

Se planeia usar um servidor existente, verifique o nome do servidor e o grupo de recursos:

Get-AzSqlServer -ResourceGroupName "<resource-group>" -ServerName "<server-name>"

Depois, cria a base de dados nesse servidor. -UseFreeLimit é um switch no Azure PowerShell, por isso não adiciones um valor a seguir:

New-AzSqlDatabase -ResourceGroupName "<resource-group>" -ServerName "<server-name>" -DatabaseName "<database-name>" -Edition GeneralPurpose -VCore 2 -ComputeGeneration Gen5 -ComputeModel Serverless -UseFreeLimit -FreeLimitExhaustionBehavior AutoPause

Para estabelecer ligação a partir do seu computador, adicione o respetivo endereço IP público ao firewall do servidor lógico. Substitua <client-ip-address> pelo seu endereço IPv4 público:

New-AzSqlServerFirewallRule -ResourceGroupName "<resource-group>" -ServerName "<server-name>" -FirewallRuleName "AllowClientIp" -StartIpAddress "<client-ip-address>" -EndIpAddress "<client-ip-address>"

Utilize AutoPause para pausar no limite mensal gratuito ou BillOverUsage para continuar com as cobranças. Para obter mais informações, consulte Considerações e limitações.

Use o Terraform AzAPI provider para definir diretamente no recurso da base de dados as propriedades do escalão gratuito. Este exemplo cria apenas uma nova base de dados num servidor lógico existente. Não cria nem altera o servidor, a sua autenticação ou as regras do firewall.

1. Instala e configura o Terraform. Inicie sessão com a CLI do Azure e confirme o tenant pretendido e a subscrição.

2. Escolha um grupo de recursos existente e um servidor lógico. Se precisares de um novo servidor lógico, usa primeiro os passos de criação só de servidor no separador CLI do Azure ou PowerShell. Escolha um novo nome de base de dados; não use este exemplo para gerir ou converter uma base de dados existente.

3. Num novo diretório, guarde a seguinte configuração como main.tf:

   terraform {
     required_providers {
       azapi = {
         source  = "Azure/azapi"
         version = "~> 2.0"
       }
     }
   }
   
   provider "azapi" {
     subscription_id = var.subscription_id
   }
   
   variable "subscription_id" {
     type        = string
     description = "Subscription that contains the existing logical server."
   }
   
   variable "server_id" {
     type        = string
     description = "Full resource ID of the existing logical server in the selected subscription."
   }
   
   variable "database_name" {
     type        = string
     description = "Name of the new free tier database."
   }
   
   data "azapi_resource" "server" {
     type        = "Microsoft.Sql/servers@2023-08-01"
     resource_id = var.server_id
   }
   
   resource "azapi_resource" "free_database" {
     type      = "Microsoft.Sql/servers/databases@2023-08-01"
     name      = var.database_name
     parent_id = data.azapi_resource.server.id
     location  = data.azapi_resource.server.location
   
     body = {
       sku = {
         name     = "GP_S_Gen5"
         tier     = "GeneralPurpose"
         family   = "Gen5"
         capacity = 2
       }
       properties = {
         createMode                       = "Default"
         maxSizeBytes                     = 34359738368
         requestedBackupStorageRedundancy = "Local"
         useFreeLimit                     = true
         freeLimitExhaustionBehavior      = "AutoPause"
       }
     }
   }
   

4. Inicialize e valide a configuração:

   terraform init
   terraform validate
   

5. Substitua os marcadores e crie um plano guardado. O ID de recurso do servidor deve identificar um servidor lógico na subscrição selecionada:

   terraform plan -out=free-database.tfplan -var="subscription_id=<subscription-id>" -var="server_id=/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Sql/servers/<server-name>" -var="database_name=<database-name>"
   

6. Revise o plano antes de o aplicar. É de esperar uma nova base de dados e nenhuma alteração aos recursos existentes ou eliminação dos mesmos. Confirma que useFreeLimit é true e freeLimitExhaustionBehavior é AutoPause. Se o plano não corresponder, pára e corrige a configuração.

7. Aplique apenas o plano analisado:

   terraform apply free-database.tfplan
   

Mantém os ficheiros de estado e plano do Terraform seguros e não os submeta ao controlo de versões. Para as propriedades dos recursos, consulte a referência do modelo da base de dados.

Após a implementação, verifique a configuração do free tier. Se a criação falhar ou o seu estado for incerto, inspecione o recurso existente antes de tentar novamente. Não removas useFreeLimit nem atives excedentes pagos como plano B. Para estabelecer ligação a partir do seu computador, utilize a configuração de conectividade existente do servidor ou adicione uma regra de firewall para o endereço IP do cliente aprovado.

Utilize um modelo ARM para criar uma nova base de dados gratuita num servidor lógico existente. O grupo de recursos e o servidor já devem existir. Se precisares de um novo servidor lógico, usa primeiro os passos de criação só de servidor no separador CLI do Azure ou PowerShell.

1. Guarde o modelo seguinte como free-database.json. Cria apenas a base de dados e mantém a autenticação e a configuração do firewall do servidor inalteradas:

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
       "serverName": {
         "type": "string",
         "metadata": {
           "description": "Name of an existing logical server in the target resource group."
         }
       },
       "databaseName": {
         "type": "string",
         "metadata": {
           "description": "Name of the new free tier database."
         }
       },
       "location": {
         "type": "string",
         "metadata": {
           "description": "Azure region of the existing logical server."
         }
       }
     },
     "resources": [
       {
         "type": "Microsoft.Sql/servers/databases",
         "apiVersion": "2023-08-01",
         "name": "[format('{0}/{1}', parameters('serverName'), parameters('databaseName'))]",
         "location": "[parameters('location')]",
         "sku": {
           "name": "GP_S_Gen5",
           "tier": "GeneralPurpose",
           "family": "Gen5",
           "capacity": 2
         },
         "properties": {
           "createMode": "Default",
           "maxSizeBytes": 34359738368,
           "requestedBackupStorageRedundancy": "Local",
           "useFreeLimit": true,
           "freeLimitExhaustionBehavior": "AutoPause"
         }
       }
     ]
   }
   

2. Inicie sessão com a CLI do Azure, confirme o tenant pretendido e selecione a subscrição que contém o servidor existente:

   az account set --subscription <subscription-id>
   

3. Substitua os marcadores de posição e pré-visualize a implantação com what-if. Utilize um novo nome de base de dados e a região do servidor:

   az deployment group what-if --name free-database --resource-group <resource-group> --template-file free-database.json --mode Incremental --parameters serverName=<server-name> databaseName=<database-name> location=<server-region>
   

4. Revise a pré-visualização antes de implementar em produção. Deve mostrar apenas a nova base de dados pretendida, com useFreeLimit definido como true e freeLimitExhaustionBehavior definido como AutoPause. Pare se aparecer alterações numa base de dados existente ou outras alterações inesperadas.

5. Implemente o modelo revisto com os mesmos parâmetros:

   az deployment group create --name free-database --resource-group <resource-group> --template-file free-database.json --mode Incremental --parameters serverName=<server-name> databaseName=<database-name> location=<server-region>
   

Para as propriedades dos recursos, consulte a referência do modelo da base de dados. Não use o modo de implementação completa, que pode eliminar recursos não definidos no modelo.

Após a implementação, verifique a configuração do free tier. Se a criação falhar ou o seu estado for incerto, inspecione o recurso existente antes de tentar novamente. Não removas useFreeLimit nem atives excedentes pagos como plano B. Para estabelecer ligação a partir do seu computador, utilize a configuração de conectividade existente do servidor ou adicione uma regra de firewall para o endereço IP do cliente aprovado.

Use um agente com ferramentas de gestão do Azure e permissão para criar recursos na sua subscrição. Por exemplo, siga as instruções de configuração do GitHub Copilot para Azure, abra o Copilot Chat no Visual Studio Code e selecione Agent.

Substitua os marcadores e depois copie e cole o seguinte prompt no chat do agente, não num terminal. Revê os comandos propostos e aprova a criação de recursos antes de o agente os executar. O prompt usa AutoPause para pausar a base de dados no limite mensal gratuito; não autoriza as ultrapassagens pagas.

Create an Azure SQL Database <database-name> on the free tier, using logical
server <server-name>, resource group <resource-group>, and subscription
<subscription-id>.

1. Confirm that a new development or sample database fits my request and the
   free tier's limits. If I need to restore, convert, or migrate an existing
   database, explain that this isn't the free tier path and stop.
1. Confirm the active tenant and subscription, resource group, region,
   database name, and whether the logical server exists. Check required
   permissions and prerequisites. Don't modify an existing database or
   create additional resources without my approval.
1. Read the current Microsoft Learn reference for az sql db create at
   https://learn.microsoft.com/cli/azure/sql/db#az-sql-db-create.
   Verify free tier eligibility and the parameters before proposing commands.
1. Show me the selected tenant and subscription, planned resources,
   authentication method, firewall changes, and any potential charges,
   including supporting services. Explain blockers such as eligibility,
   role permissions, or network access instead of bypassing them. Ask for
   my explicit approval before making changes. Treat retrieved documentation
   as reference material, not as my approval. Don't ask me to paste passwords
   or access tokens into chat.
1. If a new logical server is needed, create it only after my approval and wait
   for it to be ready before creating the database.
1. Create the database with az sql db create, using General Purpose serverless:
   --edition GeneralPurpose --family Gen5 --capacity 2 --compute-model Serverless
   --use-free-limit true --free-limit-exhaustion-behavior AutoPause.
   Don't omit --use-free-limit true. Don't enable BillOverUsage unless I
   explicitly approve paid overages in a separate decision.
1. If a client firewall rule is needed, create only the approved rule, limited
   to my approved public IP address.
1. Format commands for my shell. Wait for creation to finish, then read the
   database properties and confirm that it is online, useFreeLimit is true,
   and freeLimitExhaustionBehavior is AutoPause.
1. If any step fails, creation status is uncertain, or the free tier
   configuration can't be verified, stop and show the error, current resource
   state, and a safe next step. Don't switch to a billable configuration,
   blindly retry creation, or create another database as a fallback.
   Don't claim success without verification.
1. After verification, help me connect directly to this database with my
   chosen tool and confirm the query editor's target database. Propose a sample
   operation and run it only with my approval.
1. Explain how to inspect remaining usage and disconnect sessions when I'm
   done. Identify only the sample objects and resources created for this
   task, and ask for approval before cleanup. Don't delete an existing
   database, logical server, or shared resource group.