Inicio rápido: Conexión y consulta mediante CLI de Azure con Azure Database for PostgreSQL servidor flexible

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

Prerrequisitos

  • Una cuenta de Azure con una suscripción activa. Si no tiene una, obtenga la versión de evaluación gratuita.
  • Instale la versión más reciente de la CLI de Azure.
  • Inicie sesión con la CLI de Azure con el az login comando .
  • (opcional) Active una persistencia de parámetros experimentales mediante 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 una instancia de Azure Database for PostgreSQL

En primer lugar, cree un servidor flexible administrado de Azure Database for PostgreSQL. En Azure Cloud Shell, ejecute el siguiente script. 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>

Para personalizar el comando, proporcione más argumentos. 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 mediante el --help argumento .

az postgres flexible-server connect --help

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

Puede 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>

Example:

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

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

Successfully connected to server372060240.

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

  • Asegúrese de que el nombre de usuario y la contraseña del administrador del servidor son correctos.
  • Asegúrese de configurar la regla de firewall para la máquina cliente.
  • Si el servidor está configurado con acceso privado mediante redes virtuales, asegúrese de que la máquina cliente está 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

Example:

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

Verá que la experiencia del shell de psql es similar a la siguiente salida:

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

Use az postgres flexible-server execute para ejecutar consultas únicas en una base de datos postgres.

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

Example:

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

Verá una salida como se muestra en el ejemplo siguiente:

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

Ejecución de un archivo SQL

Use el comando az postgres flexible-server execute con el --file-path argumento , -fpara ejecutar un archivo SQL.

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 test.sql archivo en el directorio actual. A continuación, ejecute el siguiente comando para ejecutar el archivo.

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

Verá una salida como se muestra en el ejemplo siguiente:

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

Contenido relacionado

  • Last updated on