Inicio rápido: Crear una instancia de Azure Database for PostgreSQL: servidor único con la CLI de AzureQuickstart: Create an Azure Database for PostgreSQL - Single Server using the Azure CLI

Sugerencia

Considere la posibilidad de usar un comando de la CLI de Azure az postgres up más sencillo (actualmente en versión preliminar).Consider using the simpler az postgres up Azure CLI command (currently in preview). Pruebe el inicio rápido.Try out the quickstart.

Azure Database for PostgreSQL es un servicio administrado que le permite ejecutar, administrar y escalar bases de datos de PostgreSQL de alta disponibilidad en la nube.Azure Database for PostgreSQL is a managed service that enables you to run, manage, and scale highly available PostgreSQL databases in the cloud. La CLI de Azure se usa para crear y administrar recursos de Azure desde la línea de comandos o en scripts.The Azure CLI is used to create and manage Azure resources from the command line or in scripts. En esta guía de inicio rápido se muestra cómo crear una base de datos de Azure para el servidor PostgreSQL en un grupo de recursos de Azure mediante la CLI de Azure.This quickstart shows you how to create an Azure Database for PostgreSQL server in an Azure resource group using the Azure CLI.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Uso de Azure Cloud ShellUse Azure Cloud Shell

En Azure se hospeda Azure Cloud Shell, un entorno de shell interactivo que puede utilizar mediante el explorador.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Cloud Shell le permite usar bash o PowerShell para trabajar con servicios de Azure.Cloud Shell lets you use either bash or PowerShell to work with Azure services. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.You can use the Cloud Shell pre-installed commands to run the code in this article without having to install anything on your local environment.

Para iniciar Azure Cloud Shell:To launch Azure Cloud Shell:

OpciónOption Ejemplo o vínculoExample/Link
Seleccione Probarlo en la esquina superior derecha de un bloque de código.Select Try It in the upper-right corner of a code block. Solo con seleccionar Probar no se copia automáticamente el código en Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Ejemplo de Probarlo para Azure Cloud Shell
Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador.Go to https://shell.azure.com or select the Launch Cloud Shell button to open Cloud Shell in your browser. Iniciar Cloud Shell en una nueva ventanaLaunch Cloud Shell in a new window
Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Botón Cloud Shell en Azure Portal

Para ejecutar el código de este artículo en Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Inicie Cloud Shell.Launch Cloud Shell.
  2. Seleccione el botón Copiar de un bloque de código para copiar el código.Select the Copy button on a code block to copy the code.
  3. Pegue el código en la sesión de Cloud Shell con Ctrl+Mayús+V en Windows y Linux, o Cmd+Mayús+V en macOS.Paste the code into the Cloud Shell session with Ctrl+Shift+V on Windows and Linux, or Cmd+Shift+V on macOS.
  4. Presione ENTRAR para ejecutar el código.Press Enter to run the code.

Si decide instalar y usar la CLI localmente, para este artículo es preciso que ejecute la versión 2.0 o posterior de la CLI de Azure.If you choose to install and use the CLI locally, this article requires that you are running the Azure CLI version 2.0 or later. Para ver la versión instalada, ejecute el comando az --version.To see the version installed, run the az --version command. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.If you need to install or upgrade, see Install Azure CLI.

Si ejecuta localmente la CLI, debe iniciar sesión en la cuenta con el comando az login.If you are running the CLI locally, you need to sign in to your account using the az login command. Anote la propiedad ID de la salida del comando para el nombre de la suscripción correspondiente.Note the ID property from the command output for the corresponding subscription name.

az login

Si tiene varias suscripciones, elija la suscripción adecuada en la que se debe facturar el recurso.If you have multiple subscriptions, choose the appropriate subscription in which the resource should be billed. Seleccione el identificador de suscripción específico en su cuenta mediante el comando az account set.Select the specific subscription ID under your account using az account set command. Sustituya la propiedad ID de la salida az login para su suscripción en el marcador de posición de identificador de suscripción.Substitute the ID property from the az login output for your subscription into the subscription ID placeholder.

az account set --subscription <subscription id>

Crear un grupo de recursosCreate a resource group

Cree un grupo de recursos de Azure con el comando az group create.Create an Azure resource group using the az group create command. Un grupo de recursos es un contenedor lógico en el que se implementan y se administran recursos de Azure como un grupo.A resource group is a logical container into which Azure resources are deployed and managed as a group. Debe proporcionar un nombre único.You should provide a unique name. En el ejemplo siguiente, se crea un grupo de recursos denominado myresourcegroup en la ubicación westus.The following example creates a resource group named myresourcegroup in the westus location.

az group create --name myresourcegroup --location westus

Creación de un servidor de Azure Database for PostgreSQLCreate an Azure Database for PostgreSQL server

Cree un servidor de Azure Database for PostgreSQL con el comando az postgres server create.Create an Azure Database for PostgreSQL server using the az postgres server create command. Un servidor puede contener varias bases de datos.A server can contain multiple databases.

ConfiguraciónSetting Valor de ejemploSample value DescripciónDescription
Nombrename mydemoservermydemoserver Elija un nombre único que identifique al servidor de Azure Database for PostgreSQL.Choose a unique name that identifies your Azure Database for PostgreSQL server. El nombre del servidor solo puede contener letras minúsculas, números y el carácter de guion (-).The server name can contain only lowercase letters, numbers, and the hyphen (-) character. Debe contener entre 3 y 63 caracteres.It must contain from 3 to 63 characters.
resource-groupresource-group myresourcegroupmyresourcegroup Especifique el nombre del grupo de recursos de Azure.Provide the name of the Azure resource group.
sku-namesku-name GP_Gen5_2GP_Gen5_2 El nombre de la SKU.The name of the sku. Sigue la convención {plan de tarifa}_{generación de procesos}_{núcleos virtuales} en forma abreviada.Follows the convention {pricing tier}_{compute generation}_{vCores} in shorthand. En esta misma tabla puede obtener más información acerca del parámetro sku-name.See below this table for more information about the sku-name parameter.
backup-retentionbackup-retention 77 Cuánto tiempo deben conservarse las copias de seguridad.How long a backup should be retained. La unidad es días.Unit is days. El intervalo es 7-35.Range is 7-35.
geo-redundant-backupgeo-redundant-backup DisabledDisabled Si se deben habilitar las copias de seguridad con redundancia geográfica en este servidor o no.Whether geo-redundant backups should be enabled for this server or not. Valores permitidos: Enabled (Habilitada), Disabled (Deshabilitada).Allowed values: Enabled, Disabled.
locationlocation westuswestus La ubicación de Azure para el servidor.The Azure location for the server.
ssl-enforcementssl-enforcement habilitadoEnabled Si debe ssl debe habilitarse, o no, en este servidor.Whether ssl should be enabled or not for this server. Valores permitidos: Enabled (Habilitada), Disabled (Deshabilitada).Allowed values: Enabled, Disabled.
storage-sizestorage-size 5120051200 La capacidad de almacenamiento del servidor (la unidad es megabytes).The storage capacity of the server (unit is megabytes). El tamaño de almacenamiento válido un mínimo de 5120 MB y aumenta en incrementos de 1024 MB.Valid storage-size is minimum 5120MB and increases in 1024MB increments. Consulte el documento de los planes de tarifa para más información acerca de los límites de tamaño de almacenamiento.See the pricing tiers document for more information about storage size limits.
versionversion 9,69.6 La versión principal de PostgreSQL.The PostgreSQL major version.
admin-useradmin-user myadminmyadmin El nombre del usuario del inicio de sesión del administrador.The username for the administrator login. No puede ser azure_superuser, admin, administrator, root, guest o public.It cannot be azure_superuser, admin, administrator, root, guest, or public.
admin-passwordadmin-password contraseña segurasecure password La contraseña del usuario administrador.The password of the administrator user. Debe tener entre 8 y 128 caracteres.It must contain between 8 and 128 characters. La contraseña debe contener caracteres de tres de las siguientes categorías: Letras del alfabeto inglés mayúsculas y minúsculas, números y caracteres no alfanuméricos.Your password must contain characters from three of the following categories: English uppercase letters, English lowercase letters, numbers, and non-alphanumeric characters.

El valor del parámetro sku-name sigue la convención {plan de tarifa}_{generación de proceso}_{núcleos virtuales} como en los ejemplos siguientes:The sku-name parameter value follows the convention {pricing tier}_{compute generation}_{vCores} as in the examples below:

  • --sku-name B_Gen5_1 se asigna a Básico, Gen 5 y 1 núcleo virtual.--sku-name B_Gen5_1 maps to Basic, Gen 5, and 1 vCore. Esta opción es la SKU más pequeña disponible.This option is the smallest SKU available.
  • --sku-name GP_Gen5_32 se asigna a De uso general, Gen 5 y 32 núcleos virtuales.--sku-name GP_Gen5_32 maps to General Purpose, Gen 5, and 32 vCores.
  • --sku-name MO_Gen5_2 se asigna a Optimizado para memoria, Gen 5 y 2 núcleos virtuales.--sku-name MO_Gen5_2 maps to Memory Optimized, Gen 5, and 2 vCores.

Para comprender cuáles son los valores válidos por región y nivel consulte la documentación sobre planes de tarifa.Please see the pricing tiers documentation to understand the valid values per region and per tier.

En el ejemplo siguiente se crea un servidor PostgreSQL 9.6 en la región Oeste de EE. UU. llamado mydemoserver en el grupo de recursos myresourcegroup con el inicio de sesión de administrador de servidor myadmin.The following example creates a PostgreSQL 9.6 server in West US named mydemoserver in your resource group myresourcegroup with server admin login myadmin. Se trata de un servidor Gen 4 de uso general con 2 núcleos virtuales.This is a Gen 4 General Purpose server with 2 vCores. Sustituya <server_admin_password> por su propio valor.Substitute the <server_admin_password> with your own value.

az postgres server create --resource-group myresourcegroup --name mydemoserver  --location westus --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen4_2 --version 9.6

Nota

Considere la posibilidad de usar el plan de tarifa Básico si menos proceso y E/S resultan adecuados para su carga de trabajo.Consider using the Basic pricing tier if light compute and I/O are adequate for your workload. Tenga en cuenta que los servidores que creó en el plan de tarifa Básico no se podrán escalar más adelante a De uso general u Optimizada para memoria.Note that servers created in the Basic pricing tier cannot later be scaled to General Purpose or Memory Optimized. Consulte la página de precios para más información.See the pricing page for more information.

Configuración de una regla de firewall de nivel de servidorConfigure a server-level firewall rule

Cree una regla de firewall de nivel de servidor de Azure PostgreSQL con el comando az postgres server firewall-rule create.Create an Azure PostgreSQL server-level firewall rule with the az postgres server firewall-rule create command. Una regla de firewall de nivel de servidor permite que una aplicación externa, como psql o PgAdmin, se conecte al servidor a través del firewall del servicio Azure PostgreSQL.A server-level firewall rule allows an external application, such as psql or PgAdmin to connect to your server through the Azure PostgreSQL service firewall.

Puede establecer una regla de firewall que abarque un intervalo de IP para poder conectarse desde la red.You can set a firewall rule that covers an IP range to be able to connect from your network. En el ejemplo siguiente se usa az postgres server firewall-rule create para crear una regla de firewall AllowMyIP para una direcciones IP individual.The following example uses az postgres server firewall-rule create to create a firewall rule AllowMyIP for a single IP address.

az postgres server firewall-rule create --resource-group myresourcegroup --server mydemoserver --name AllowMyIP --start-ip-address 192.168.0.1 --end-ip-address 192.168.0.1

Nota

El servidor Azure PostgreSQL se comunica a través de puerto 5432.Azure PostgreSQL server communicates over port 5432. Al conectarse desde una red corporativa, es posible que el firewall de la red no permita el tráfico saliente a través del puerto 5432.When connecting from within a corporate network, outbound traffic over port 5432 may not be allowed by your network's firewall. Indique al departamento de TI que abra el puerto 5432 para conectarse al servidor de Azure PostgreSQL.Have your IT department open port 5432 to connect to your Azure PostgreSQL server.

Obtención de la información de conexiónGet the connection information

Para conectarse al servidor, debe proporcionar las credenciales de acceso y la información del host.To connect to your server, you need to provide host information and access credentials.

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

El resultado está en formato JSON.The result is in JSON format. Tome nota de los valores de administratorLogin y fullyQualifiedDomainName.Make a note of the administratorLogin and fullyQualifiedDomainName.

{
  "administratorLogin": "myadmin",
  "earliestRestoreDate": null,
  "fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/servers/mydemoserver",
  "location": "westus",
  "name": "mydemoserver",
  "resourceGroup": "myresourcegroup",
  "sku": {
    "capacity": 2,
    "family": "Gen5",
    "name": "GP_Gen5_2",
    "size": null,
    "tier": "GeneralPurpose"
  },
  "sslEnforcement": "Enabled",
  "storageProfile": {
    "backupRetentionDays": 7,
    "geoRedundantBackup": "Disabled",
    "storageMb": 5120
  },
  "tags": null,
  "type": "Microsoft.DBforPostgreSQL/servers",
  "userVisibleState": "Ready",
  "version": "9.6"
}

Conectarse a la base de datos de PostgreSQL mediante psqlConnect to PostgreSQL database using psql

Si el equipo cliente tiene PostgreSQL instalado, puede usar una instancia local de psql para conectarse a un servidor Azure PostgreSQL.If your client computer has PostgreSQL installed, you can use a local instance of psql to connect to an Azure PostgreSQL server. Ahora vamos a usar la utilidad de línea de comandos psql para conectarnos al servidor Azure PostgreSQL.Let's now use the psql command-line utility to connect to the Azure PostgreSQL server.

  1. Ejecute el comando psql siguiente para conectarse a un servidor de Azure Database for PostgreSQLRun the following psql command to connect to an Azure Database for PostgreSQL server

    psql --host=<servername> --port=<port> --username=<user@servername> --dbname=<dbname>
    

    Por ejemplo, el siguiente comando se conecta a la base de datos predeterminada llamada postgres en el servidor PostgreSQL mydemoserver.postgres.database.azure.com con las credenciales de acceso.For example, the following command connects to the default database called postgres on your PostgreSQL server mydemoserver.postgres.database.azure.com using access credentials. Escriba el valor de <server_admin_password> que eligió cuando se le solicitó una contraseña.Enter the <server_admin_password> you chose when prompted for password.

    psql --host=mydemoserver.postgres.database.azure.com --port=5432 --username=myadmin@mydemoserver --dbname=postgres
    

    Sugerencia

    Si prefiere usar una ruta URL para conectarse a Postgres, codifique la URL con el signo @ en el nombre de usuario con %40.If you prefer to use a URL path to connect to Postgres, URL encode the @ sign in the username with %40. Por ejemplo, la cadena de conexión de psql sería:For example the connection string for psql would be,

    psql postgresql://myadmin%40mydemoserver@mydemoserver.postgres.database.azure.com:5432/postgres
    
  2. Una vez conectado al servidor, cree una base de datos vacía en el símbolo del sistema.Once you are connected to the server, create a blank database at the prompt.

    CREATE DATABASE mypgsqldb;
    
  3. En el símbolo del sistema, ejecute el siguiente comando para cambiar la conexión a la base de datos mypgsqldb recién creada:At the prompt, execute the following command to switch connection to the newly created database mypgsqldb:

    \c mypgsqldb
    

Conexión al servidor de PostgreSQL mediante pgAdminConnect to the PostgreSQL Server using pgAdmin

pgAdmin es una herramienta de código abierto que se usa con PostgreSQL.pgAdmin is an open-source tool used with PostgreSQL. Puede instalar pgAdmin desde el sitio web de pgAdmin.You can install pgAdmin from the pgAdmin website. La versión de pgAdmin que use podría ser diferente de la que se usa en esta guía de inicio rápido.The pgAdmin version you're using may be different from what is used in this Quickstart. Lea la documentación de pgAdmin si necesita instrucciones adicionales.Read the pgAdmin documentation if you need additional guidance.

  1. Abra la aplicación pgAdmin en el equipo cliente.Open the pgAdmin application on your client computer.

  2. En la barra de herramientas, vaya a Object (Objeto), mantenga el mouse sobre Create (Crear) y seleccione Server (Servidor).From the toolbar go to Object, hover over Create, and select Server.

  3. En el cuadro de diálogo Create - Server (Crear: servidor) de la pestaña General, escriba un nombre descriptivo único para el servidor, como mydemoserver.In the Create - Server dialog box, on the General tab, enter a unique friendly name for the server, such as mydemoserver.

    Pestaña "General"

  4. En la pestaña Connection (Conexión) del cuadro de diálogo Create - Server (Crear: servidor), rellene la tabla de configuración.In the Create - Server dialog box, on the Connection tab, fill in the settings table.

    Pestaña "Conexión"

    parámetro pgAdminpgAdmin parameter ValorValue DESCRIPCIÓNDescription
    Host name/addressHost name/address Nombre de servidorServer name El valor de nombre de servidor que usó al crear el servidor de Azure Database for MySQL.The server name value that you used when you created the Azure Database for PostgreSQL server earlier. El servidor de ejemplo es mydemoserver.postgres.database.azure.com.Our example server is mydemoserver.postgres.database.azure.com. Use el nombre de dominio completo ( *.postgres.database.azure.com) tal como se muestra en el ejemplo.Use the fully qualified domain name (*.postgres.database.azure.com) as shown in the example. Si no recuerda el nombre del servidor, siga los pasos de la sección anterior para obtener la información de conexión.If you don't remember your server name, follow the steps in the previous section to get the connection information.
    PortPort 54325432 El puerto se usará al conectarse al servidor de Azure Database for PostgreSQL.The port to use when you connect to the Azure Database for PostgreSQL server.
    Maintenance DatabaseMaintenance database postgrespostgres Nombre de la base de datos predeterminada que crea el sistema.The default system-generated database name.
    Nombre de usuarioUsername Nombre de inicio de sesión del administrador del servidorServer admin login name El nombre de usuario de inicio de sesión del administrador del servidor que suministró al crear el servidor de Azure Database for PostgreSQL.The server admin login username that you supplied when you created the Azure Database for PostgreSQL server earlier. Si no recuerda el nombre de usuario, siga los pasos de la sección anterior para obtener la información de conexión.If you don't remember the username, follow the steps in the previous section to get the connection information. El formato es nombre de usuario@nombre de servidor.The format is username@servername.
    ContraseñaPassword Contraseña del administradorYour admin password La contraseña que eligió al crear el servidor antes en esta guía de inicio rápido.The password you chose when you created the server earlier in this Quickstart.
    RoleRole Déjelo en blancoLeave blank No es necesario proporcionar un nombre de rol en este momento.There's no need to provide a role name at this point. Deje el campo en blanco.Leave the field blank.
    SSL ModeSSL mode RequireRequire Puede establecer el modo SSL en la pestaña SSL de pgAdmin. De forma predeterminada, todos los servidores de Azure Database for PostgreSQL se crean de modo que se exija SSL.You can set the SSL mode in pgAdmin's SSL tab. By default, all Azure Database for PostgreSQL servers are created with SSL enforcing turned on. Para desactivar la obligación de SSL, consulte la sección sobre la aplicación de SSL.To turn off SSL enforcing, see SSL Enforcing.
  5. Seleccione Guardar.Select Save.

  6. En el panel izquierdo del explorador, expanda el nodo Servidores.In the Browser pane on the left, expand the Servers node. Seleccione el servidor, por ejemplo, mydemoserver.Select your server, for example, mydemoserver. Haga clic para conectarse a él.Click to connect to it.

  7. Expanda el nodo de servidor y Bases de datos.Expand the server node, and then expand Databases under it. La lista debe incluir las bases de datos postgres existentes y otras bases de datos que haya creado.The list should include your existing postgres database and any other databases you've created. Con Azure Database for PostgreSQL puede crear varias bases de datos por servidor.You can create multiple databases per server with Azure Database for PostgreSQL.

  8. Haga clic con el botón derecho en Bases de datos, elija el menú Crear y, a continuación, seleccione Base de datos.Right-click Databases, choose the Create menu, and then select Database.

  9. Escriba el nombre de base de datos que quiera en el campo Base de datos, por ejemplo, mypgsqldb2.Type a database name of your choice in the Database field, such as mypgsqldb2.

  10. Seleccione el propietario de la base de datos en el cuadro de lista.Select the Owner for the database from the list box. Elija el nombre de inicio de sesión del administrador del servidor, como en el ejemplo, my admin.Choose your server admin login name, such as the example, my admin.

    Creación de una base de datos en pgadmin

  11. Seleccione Guardar para crear una base de datos vacía.Select Save to create a new blank database.

  12. En el panel del explorador, puede ver la base de datos que ha creado en la lista de bases de datos, debajo del nombre del servidor.In the Browser pane, you can see the database that you created in the list of databases under your server name.

Limpieza de recursosClean up resources

Elimine el grupo de recursos de Azure para eliminar todos los recursos que ha creado en la guía de inicio rápido.Clean up all resources you created in the quickstart by deleting the Azure resource group.

Sugerencia

Otras guías de inicio rápido de esta colección se basan en los valores de esta.Other quickstarts in this collection build upon this quickstart. Si tiene previsto seguir trabajando con las siguientes guías de inicio rápido, no elimine los recursos creados en esta.If you plan to continue to work with subsequent quickstarts, do not clean up the resources created in this quickstart. Si no tiene previsto continuar, siga estos pasos para eliminar todos los recursos creados en esta guía de inicio rápido en la CLI de Azure.If you do not plan to continue, use the following steps to delete all resources created by this quickstart in the Azure CLI.

az group delete --name myresourcegroup

Si solo desea eliminar el servidor recién creado, puede ejecutar el comando az postgres server delete.If you would just like to delete the one newly created server, you can run az postgres server delete command.

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

Pasos siguientesNext steps