Comment se connecter à la base de données de reporting
Fonctionnalité en bêta. La base de données de reporting est actuellement en bêta et peut encore évoluer. Cette fonctionnalité est disponible uniquement sur inscription. Contactez votre interlocuteur Azumuta pour rejoindre la bêta et l'essayer.
Ce dont vous aurez besoin
Après activation de la base de données de reporting, Azumuta fournit les informations de connexion suivantes :
- Host — l'adresse de votre base de données de reporting.
- Port — le port de connexion.
- Database name — la base de données à laquelle se connecter.
- Username et password — identifiants en lecture seule pour votre espace de travail.
- Schema name — la zone à l'intérieur de la base de données qui contient les données de votre espace de travail. Elle a la forme
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. Lors de la connexion, assurez-vous que SSL/TLS est activé. Dans la plupart des outils, cela signifie régler le mode SSL sur require (ou cocher la case "Use SSL").
Se connecter 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 connexion, pointez votre session vers 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;
Se connecter avec un outil BI
Des outils comme Power BI, Tableau, Metabase, Looker et Grafana prennent en charge PostgreSQL. En général :
- Ajoutez une nouvelle source de données et choisissez le connecteur PostgreSQL.
- 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.
- Activez SSL (réglez le mode SSL sur require).
- Lorsque l'on vous demande un schéma, sélectionnez le schéma de votre 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. Voir Example Analytics Queries pour des idées pour débuter.
Remarque sur les performances
La base de données de reporting est une copie, donc les requêtes lourdes n'affecteront pas votre espace Azumuta en production. Cela dit, il est recommandé de filtrer et d'agréger en SQL plutôt que d'importer des tables entières dans votre outil BI.