Partilhar via


Guia de início rápido: usar um arquivo Bicep para criar um Banco de Dados do Azure para PostgreSQL - instância do Servidor Flexível

APLICA-SE A: Banco de Dados do Azure para PostgreSQL - Servidor Flexível

Neste início rápido, você aprenderá a usar um arquivo Bicep para criar um Banco de Dados do Azure para instância de servidor flexível do PostgreSQL.

O servidor flexível do Banco de Dados do Azure para PostgreSQL é um serviço gerenciado que você usa para executar, gerenciar e dimensionar bancos de dados PostgreSQL altamente disponíveis na nuvem. Você pode usar o Bicep para provisionar uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL para implantar vários servidores ou vários bancos de dados em um servidor.

O Bicep é uma linguagem específica do domínio que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipos fiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie um gratuitamente.

Reveja o Bíceps

Uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL é o recurso pai para um ou mais bancos de dados dentro de uma região. Ele fornece o escopo para políticas de gerenciamento que se aplicam a seus bancos de dados: login, firewall, usuários, funções e configurações.

Crie um arquivo main.bicep e copie o seguinte Bicep para ele.

param administratorLogin string

@secure()
param administratorLoginPassword string
param location string = resourceGroup().location
param serverName string
param serverEdition string = 'GeneralPurpose'
param skuSizeGB int = 128
param dbInstanceType string = 'Standard_D4ds_v4'
param haMode string = 'ZoneRedundant'
param availabilityZone string = '1'
param version string = '12'
param virtualNetworkExternalId string = ''
param subnetName string = ''
param privateDnsZoneArmResourceId string = ''

resource serverName_resource 'Microsoft.DBforPostgreSQL/flexibleServers@2021-06-01' = {
  name: serverName
  location: location
  sku: {
    name: dbInstanceType
    tier: serverEdition
  }
  properties: {
    version: version
    administratorLogin: administratorLogin
    administratorLoginPassword: administratorLoginPassword
    network: {
      delegatedSubnetResourceId: (empty(virtualNetworkExternalId) ? json('null') : json('\'${virtualNetworkExternalId}/subnets/${subnetName}\''))
      privateDnsZoneArmResourceId: (empty(virtualNetworkExternalId) ? json('null') : privateDnsZoneArmResourceId)
    }
    highAvailability: {
      mode: haMode
    }
    storage: {
      storageSizeGB: skuSizeGB
    }
    backup: {
      backupRetentionDays: 7
      geoRedundantBackup: 'Disabled'
    }
    availabilityZone: availabilityZone
  }
}

Esses recursos são definidos no arquivo Bicep:

Implantar o arquivo Bicep

Use a CLI do Azure ou o Azure PowerShell para implantar o arquivo Bicep.

az group create --name exampleRG --location centralus
az deployment group create --resource-group exampleRG --template-file main.bicep

Você será solicitado a inserir estes valores:

  • serverName: insira um nome exclusivo que identifique seu Banco de Dados do Azure para instância de servidor flexível do PostgreSQL. Por exemplo, mydemoserver-pg. O nome postgres.database.azure.com de domínio é anexado ao nome do servidor fornecido. O servidor só pode conter letras minúsculas, números e o caráter de hífen (-). Tem de conter, pelo menos, 3 a 63 carateres.
  • administratorLogin: insira sua própria conta de login para usar quando você se conectar ao servidor. Por exemplo, myadmin. O nome de login do administrador não pode ser azure_superuser, azure_pg_admin, admin, administrator, guestroot, ou public. Não pode começar com pg_.
  • administratorLoginPassword: insira uma nova senha para a conta de administrador do servidor. Tem de conter entre 8 e 128 carateres. A sua palavra-passe tem de conter carateres de três das categorias seguintes: letras em maiúscula inglesas, letras em minúscula inglesas, números (0 a 9) e carateres não alfanuméricos (!, $, #, %, etc.).

Rever os recursos implementados

Use o portal do Azure, a CLI do Azure ou o Azure PowerShell para validar a implantação e revisar os recursos implantados.

az resource list --resource-group exampleRG

Clean up resources (Limpar recursos)

Mantenha esse grupo de recursos, servidor e banco de dados único se quiser ir para o Conteúdo relacionado. A referência mostra como conectar e consultar seu banco de dados usando métodos diferentes.

Para eliminar o grupo de recursos:

az group delete --name exampleRG