Share via

Inicio rápido: Conexión y consulta mediante la CLI de Azure a Azure Database for PostgreSQL Servidor flexible

  • Artículo

SE APLICA A: Azure Database for PostgreSQL: servidor flexible

En este inicio rápido se muestra cómo conectarse a una instancia del servidor flexible de Azure Database for PostgreSQL mediante la CLI de Azure con az postgres flexible-server connect y ejecutar una consulta única o un archivo SQL con el comando az postgres flexible-server execute. Este comando permite probar la conectividad con el servidor de base de datos y ejecutar consultas. También puede ejecutar varias consultas mediante el modo interactivo.

Requisitos previos

  • Una cuenta de Azure con una suscripción activa. Si no tiene una, obtenga la versión de evaluación gratuita.
  • Instale la última versión de la CLI de Azure.
  • Inicie sesión mediante la CLI de Azure con el comando az login.
  • (opcional) active una persistencia de parámetros experimentales con az config param-persist on. La persistencia de parámetros le ayudará a usar el contexto local sin tener que repetir muchos argumentos, como el grupo de recursos o la ubicación.

Creación de instancias del servidor flexible de Azure Database for PostgreSQL

Lo primero que hay que crear es una instancia administrada del servidor flexible de Azure Database for PostgreSQL. En Azure Cloud Shell, ejecute el siguiente script y anote el nombre del servidor, el **nombre de usuario y la contraseña generados a partir de este comando.

az postgres flexible-server create --public-access <your-ip-address>

Puede proporcionar más argumentos a este comando para personalizarlo. Consulte todos los argumentos del comando az postgres flexible-server create.

Visualización de todos los argumentos

Puede ver todos los argumentos de este comando con el argumento --help.

az postgres flexible-server connect --help

Prueba de la conexión al servidor de bases de datos

Es posible probar y validar la conexión a la base de datos desde el entorno de desarrollo mediante el comando az postgres flexible-server connect.

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename>

Ejemplo:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres

Verá una salida similar si la conexión se realizó correctamente.

Successfully connected to server372060240.

Si se produjo un error en la conexión, compruebe los siguientes puntos:

  • Compruebe si el nombre de usuario y la contraseña del administrador del servidor son correctos.
  • Compruebe si configuró una regla de firewall para la máquina cliente
  • Si se configuró el servidor con acceso privado con redes virtuales, asegúrese de que la máquina cliente se encuentre en la misma red virtual.

Ejecución de varias consultas mediante el modo interactivo

Puede ejecutar varias consultas mediante el modo interactivo. Para habilitar el modo interactivo, ejecute el siguiente comando.

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    --interactive

Ejemplo:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive

Verá la experiencia del shell de psql, tal y como se muestra aquí:

Password for starchylapwing9:
Server: PostgreSQL 13.14
Version: 4.0.1
Home: http://pgcli.com
postgres> SELECT 1;
+----------+
| ?column? |
|----------|
| 1        |
+----------+
SELECT 1
Time: 0.167s
postgres>

Ejecución de consultas únicas

Ejecute consultas únicas en la base de datos de Postgres mediante az postgres flexible-server execute.

az postgres flexible-server execute \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    -q <querytext> --output table

Ejemplo:

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -q "SELECT 1" --output table

Verá una salida como la que se muestra aquí:

Successfully connected to server372060240.
Ran Database Query: 'SELECT 1'
Retrieving first 30 rows of query output, if applicable.
Closed the connection to server372060240
?column?
----------
1

Ejecutar archivo SQL

Ejecute un archivo SQL con el comando az postgres flexible-server execute mediante el argumento --file-path, -f.

az postgres flexible-server execute \
    -n <server-name> -u <username> -p "<password>" -d <database-name> \
    --file-path "<file-path>"

Ejemplo: preparar un archivo test.sql. Use el siguiente script de prueba con consultas sencillas de SELECT:

SELECT 1;
SELECT 2;
SELECT 3;

Guarde el contenido en el archivo test.sql en el directorio actual y ejecute con el comando siguiente.

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -f "test.sql"

Verá una salida como la que se muestra aquí:

Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240

Pasos siguientes

Administración del servidor