Démarrage rapide : Se connecter et interroger à l’aide de Azure CLI avec Azure Database pour PostgreSQL serveur flexible

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

Prerequisites

  • Un 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 à l’aide d’Azure CLI avec la az login commande.
  • (facultatif) Activez la persistance expérimentale des paramètres à l’aide de 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 Azure Database pour PostgreSQL

Tout d’abord, créez un serveur flexible Azure Database pour PostgreSQL managé. Dans Azure Cloud Shell, exécutez le script suivant. 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>

Pour personnaliser la commande, fournissez plus d’arguments. Consultez tous les arguments pour az postgres flexible-server create.

Visualiser tous les arguments

Vous pouvez afficher tous les arguments de cette commande à l’aide de 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 à l’aide de 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’affiche si la connexion réussit.

Successfully connected to server372060240.

Si la connexion échoue, vérifiez les points suivants :

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

Exécuter plusieurs requêtes à l’aide du mode interactif

Vous pouvez exécuter plusieurs requêtes à l’aide du 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 voyez l’interface en ligne de commande psql, semblable à la sortie suivante :

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 individuelles

Utilisez az postgres flexible-server execute pour exécuter des requêtes uniques sur une base de données Postgres.

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 illustré dans l’exemple suivant :

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

Utilisez la commande az postgres flexible-server execute avec l’argument --file-path , -fpour exécuter un fichier SQL.

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 test.sql fichier dans le répertoire actif. Exécutez ensuite la commande suivante pour exécuter le fichier.

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

Vous voyez une sortie comme illustré dans l’exemple suivant :

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

Contenu connexe

  • Last updated on