Démarrage rapide : Se connecter et interroger avec Azure CLI et Azure Database pour PostgreSQL – Serveur flexible

  • Article

S’APPLIQUE À : Azure Database pour PostgreSQL : serveur flexible

Ce démarrage rapide montre comment se connecter à une instance de serveur flexible Azure Database pour PostgreSQL en utilisant Azure CLI avec la commande az postgres flexible-server connect et exécuter une seule requête ou un fichier SQL avec la commande az postgres flexible-server execute. Cette commande vous permet de tester la connectivité à votre serveur de base de données et d’exécuter des requêtes. Vous pouvez également exécuter plusieurs requêtes en utilisant le mode interactif.

Prérequis

  • Compte Azure avec un abonnement actif. Si vous n’en avez pas, inscrivez-vous pour un essai gratuit.
  • Installez la dernière version d’Azure CLI.
  • Connectez-vous en utilisant Azure CLI avec la commande az login.
  • (facultatif) Activez la persistance de paramètre expérimental avec az config param-persist on. La persistance des paramètres vous permet d’utiliser le contexte local sans devoir répéter de nombreux arguments comme le groupe de ressources ou l’emplacement.

Créer une instance de serveur flexible Azure Database pour PostgreSQL

La première chose à créer est une instance managée du serveur flexible Azure Database pour PostgreSQL. Dans Azure Cloud Shell, exécutez le script suivant et notez le nom du serveur, le **nom d’utilisateur et le mot de passe générés à partir de cette commande.

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

Vous pouvez fournir des arguments supplémentaires à cette commande pour la personnaliser. Consultez tous les arguments pour az postgres flexible-server create.

Visualiser tous les arguments

Vous pouvez visualiser tous les arguments de cette commande avec l’argument --help.

az postgres flexible-server connect --help

Tester la connexion au serveur de base de données

Vous pouvez tester et valider la connexion à la base de données à partir de votre environnement de développement en utilisant la commande az postgres flexible-server connect.

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

Exemple :

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

Une sortie similaire s’afficher pour vous indiquer si la connexion a réussi.

Successfully connected to server372060240.

En cas d’échec de la connexion, consultez les points suivants :

  • Vérifiez si le nom d’utilisateur et le mot de passe de votre administrateur de serveur sont corrects.
  • Si vous avez configuré une règle de pare-feu pour votre machine cliente
  • Si votre serveur est configuré avec un accès privé dans le réseau virtuel, vérifiez que votre machine cliente se trouve dans le même réseau virtuel.

Exécuter plusieurs requêtes en utilisant le mode interactif

Vous pouvez effectuer plusieurs requêtes en utilisant le mode interactif. Pour activer le mode interactif, exécutez la commande suivante.

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

Exemple :

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

Vous verrez l’expérience du shell psql comme illustré ici :

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>

Exécuter des requêtes uniques

Vous pouvez exécuter des requêtes uniques sur la base de données Postgres en utilisant az postgres flexible-server execute.

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

Exemple :

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

Vous voyez une sortie comme celle illustrée ici :

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

Exécuter un fichier SQL

Vous pouvez exécuter un fichier SQL avec la commande az postgres flexible-server execute en utilisant l’argument --file-path, -f.

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

Exemple : préparez un fichier test.sql. Vous pouvez utiliser le script de test suivant avec des requêtes SELECT simples :

SELECT 1;
SELECT 2;
SELECT 3;

Enregistrez le contenu dans le fichier test.sql du répertoire actuel et exécutez en utilisant la commande suivante.

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

Vous voyez une sortie comme celle illustrée ici :

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

Étapes suivantes

Gérer le serveur