Démarrage rapide : Se connecter et interroger avec Azure CLI et Azure Database pour PostgreSQL – Serveur flexible
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