Compartir por


Inicio rápido: Creación de una instancia de Servidor flexible de Azure Database for PostgreSQL mediante la CLI de Azure

SE APLICA A: Azure Database for PostgreSQL con servidor flexible

En este inicio rápido se muestra cómo usar los comandos de la CLI de Azure en Azure Cloud Shell para crear una instancia de Azure Database for PostgreSQL con la opción Servidor flexible en cinco minutos. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Inicio de Azure Cloud Shell

Azure Cloud Shell es un shell interactivo gratuito que puede usar para ejecutar los pasos de este artículo. Tiene las herramientas comunes de Azure preinstaladas y configuradas para usarlas en la cuenta.

Para abrir Cloud Shell, seleccione Pruébelo en la esquina superior derecha de un bloque de código. También puede abrir Cloud Shell en una pestaña independiente acudiendo a https://shell.azure.com/bash. Seleccione Copiar para copiar los bloques de código, péguelos en Cloud Shell y, después, seleccione Entrar para ejecutarlos.

Si prefiere instalar y usar la CLI de forma local, en este inicio rápido se requiere la versión 2.0 o posterior de la CLI de Azure. Ejecute az --version para encontrar la versión. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.

Requisitos previos

Es preciso que inicie sesión en su cuenta mediante el comando az login. Tenga en cuenta la propiedad de salida id, que hace referencia al id. de suscripción de su cuenta de Azure.

az login

Seleccione la suscripción específica en su cuenta mediante el comando az account set. Use el valor de id de la salida de az login para usarlo como valor del argumento subscription del comando. Si tiene varias suscripciones, elija la suscripción adecuada en la que se debe facturar el recurso. Para obtener todas las suscripciones, use az account list.

az account set --subscription <subscription id>

Creación de un servidor flexible

Cree un grupo de recursos de Azure mediante el comando az group create y, a continuación, cree la instancia de servidor flexible de Azure Database for PostgreSQL dentro de este grupo de recursos. Debe proporcionar un nombre único. En el ejemplo siguiente, se crea un grupo de recursos denominado myresourcegroup en la ubicación eastus.

az group create --name myresourcegroup --location eastus

Cree una instancia de servidor flexible de Azure Database for PostgreSQL con el comando az postgres flexible-server create. Un servidor puede contener varias bases de datos. El comando siguiente crea un servidor en el grupo de recursos que acaba de crear:

az postgres flexible-server create --name mydemoserver --resource-group myresourcegroup

Dado que el método de conectividad predeterminado es acceso público (direcciones IP permitidas), el comando le pedirá que confirme si desea agregar la dirección IP o todas las direcciones IP (intervalo que abarca 0.0.0.0 a 255.255.255.255) a la lista de direcciones permitidas.

El servidor creado tiene los siguientes atributos:

  • La misma ubicación que el grupo de recursos
  • Nombre de usuario de administrador generado automáticamente y contraseña de administrador (que debe guardar en un lugar seguro)
  • Una base de datos predeterminada denominada "flexibleserverdb"
  • Valores predeterminados de servicio para las configuraciones de servidor restantes: nivel de proceso (De uso general), tamaño de proceso/SKU (Standard_D2s_v3 - 2 núcleos virtuales y 8 GB de RAM), período de retención de copia de seguridad (7 días) y versión de PostgreSQL (13)

Nota:

El método de conectividad no se puede cambiar después de crear el servidor. Por ejemplo, si seleccionó acceso privado (integración con red virtual) durante la creación, no puede cambiarlo a acceso público (direcciones IP permitidas) después de la creación. Se recomienda encarecidamente crear un servidor con acceso privado para acceder de forma segura a su servidor mediante la integración con la red virtual. Obtenga más información sobre el acceso privado en el artículo de conceptos.

Si quiere cambiar los valores predeterminados, consulte la referencia de la CLI de Azure de creación del servidor flexible de postgres.

Nota:

Las conexiones con el servidor flexible de Azure Database for PostgreSQL se comunican a través del puerto 5432. Si intenta conectarse desde una red corporativa, es posible que no se permita el tráfico saliente a través del puerto 5432. En ese caso, no podrá conectarse al servidor, salvo que el departamento de TI abra el puerto 5432. Tenga en cuenta que si habilita PgBouncer en la instancia del servidor flexible de Azure Database for PostgreSQL y quiere conectarse a través de él, ya que se ejecuta en el puerto 6432, es ese puerto que el departamento de TI debe abrir para el tráfico saliente.

Obtención de la información de conexión

Para conectarse al servidor, debe proporcionar las credenciales de acceso y la información del host.

az postgres flexible-server show --name mydemoserver --resource-group myresourcegroup

El resultado está en formato JSON. Tome nota de los valores de fullyQualifiedDomainName y administratorLogin. Debe haber guardado la contraseña en el paso anterior.

{
  "administratorLogin": "myadmin",
  "availabilityZone": "3",
  "backup": {
    "backupRetentionDays": 7,
    "earliestRestoreDate": "2022-10-20T18:03:50.989428+00:00",
    "geoRedundantBackup": "Disabled"
  },
  "earliestRestoreDate": null,
  "fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/mydemoserver",
  "location": "eastus",
  "name": "mydemoserver",
  "network": {
    "delegatedSubnetResourceId": null,
    "privateDnsZoneArmResourceId": null,
    "publicNetworkAccess": "Enabled"
  },
  "resourceGroup": "myresourcegroup",
  "sku": {
    "name": "Standard_D2s_v3",
    "tier": "GeneralPurpose"
  },
  "state": "Ready",
  "storage": {
    "storageSizeGb": 128
  },
  "tags": null,
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "version": "13"
}

Conexión mediante el cliente de línea de comandos PostgreSQL

En primer lugar, instale la herramienta de línea de comandos psql.

Con psql, conéctese a la base de datos "flexibleserverdb" mediante el siguiente comando. Reemplace los valores por el nombre de dominio y el nombre de usuario generados automáticamente.

psql -h mydemoserver.postgres.database.azure.com -U myadmin flexibleserverdb

Nota

Si recibe un error The parameter PrivateDnsZoneArguments is required, and must be provided by customer, puede que esté ejecutando una versión anterior de la CLI de Azure. Actualice la CLI de Azure y vuelva a intentar la operación.

Limpieza de recursos

Si no necesita estos recursos para otra guía de inicio rápido o tutorial, puede eliminarlos con el siguiente comando:

az group delete --name myresourcegroup

Si solo quiere eliminar el servidor recién creado, puede ejecutar el comando az postgres flexible-server delete.

az postgres flexible-server delete --resource-group myresourcegroup --name mydemoserver

Pasos siguientes