Comment se connecter à la base de données de reporting

Mis à jour

Bêta. La base de données de reporting est actuellement en bêta ; les détails de cette page peuvent encore changer.

Ce dont vous aurez besoin

Après avoir activé la base de données de reporting, Azumuta fournit les informations de connexion suivantes :

  • Hôte — l'adresse de votre base de données de reporting.
  • Port — le port à utiliser pour la connexion.
  • Nom de la base de données — la base de données à laquelle se connecter.
  • Nom d'utilisateur et mot de passe — identifiants en lecture seule pour votre espace de travail.
  • Nom du schéma — la zone à l'intérieur de la base de données qui contient les données de votre espace de travail. Il ressemble à company_<your-workspace-id>.

Traitez ces identifiants comme un mot de passe. Toute personne qui les possède peut lire vos données de reporting. Ne les partagez qu'avec les personnes qui en ont besoin, et stockez-les dans un gestionnaire de secrets plutôt que dans des documents partagés ou du code source.

Les connexions sécurisées (SSL) sont requises

La base de données de reporting n'accepte que des connexions chiffrées. Lorsque vous vous connectez, assurez-vous que SSL/TLS est activé. Dans la plupart des outils, cela signifie régler le mode SSL sur require (ou activer la case à cocher « Use SSL »).

Connexion avec un client SQL

Vous pouvez utiliser n'importe quel client compatible PostgreSQL, tel que psql, DBeaver, TablePlus, ou pgAdmin. Une chaîne de connexion ressemble à ceci:

postgresql://<username>:<password>@<host>:<port>/<database>?sslmode=require

Après la connexion, pointez votre session sur le schéma de votre espace de travail afin de pouvoir référencer les tables par leurs noms courts:

set search_path to \"company_<your-workspace-id>\";

Pour vérifier que tout fonctionne, listez les tables disponibles:

select table_name
from information_schema.tables
where table_schema = 'company_<your-workspace-id>'
order by table_name;

Connexion avec un outil BI

Des outils comme Power BI, Tableau, Metabase, Looker et Grafana prennent tous en charge PostgreSQL. En général :

  1. Ajoutez une nouvelle source de données et choisissez le connecteur PostgreSQL.
  2. Saisissez l'hôte, le port, le nom de la base de données, le nom d'utilisateur et le mot de passe fournis par Azumuta.
  3. Activez SSL (réglez le mode SSL sur require).
  4. Lorsque l'on vous demande un schéma, sélectionnez votre schéma d'espace de travail (company_<your-workspace-id>).

Une fois connecté, vos tables apparaissent dans l'outil et vous pouvez commencer à créer des tableaux de bord. Consultez Exemples de requêtes analytiques pour des idées afin de démarrer.

Remarque sur les performances

La base de données de reporting est une copie, donc les requêtes lourdes ne ralentiront pas votre espace de travail Azumuta en production. Néanmoins, il est conseillé de filtrer et d'agréger en SQL plutôt que de charger des tables entières dans votre outil BI.