Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette page explique comment interroger des bases de données dans votre projet Lakebase à partir de l’éditeur SQL dans l’espace de travail Analytique et IA à l’aide de deux méthodes de connexion différentes.
L’éditeur SQL de l’espace de travail est un espace de travail SQL collaboratif dans lequel vous pouvez créer des requêtes, rechercher des catalogues de données, créer des visualisations et partager des résultats avec des collègues. Il dispose de fonctionnalités avancées pour l’analytique, la collaboration et l’automatisation.
Note
Pour les fonctionnalités natives Postgres telles que EXPLAIN/ANALYZE et les méta-commandes (\dt, , \d\l), utilisez l’éditeur SQL Lakebase. Consultez Requête à partir de l’éditeur SQL Lakebase.
Pour obtenir des informations complètes sur les fonctionnalités de l’éditeur SQL, consultez Écrire des requêtes et explorer les données dans l’éditeur SQL.
Méthodes de connexion
Vous pouvez vous connecter à votre base de données Lakebase à partir de l’éditeur SQL à l’aide de deux méthodes :
- Connexion directe au compute : connectez-vous directement à votre compute Lakebase pour accéder immédiatement aux requêtes d’un Project et d’une branche spécifiques.
- Enregistrement dans Unity Catalog : Enregistrez votre base de données dans Unity Catalog pour permettre les requêtes fédérées, la gouvernance unifiée et l’analyse cross-source.
Choisir votre méthode de connexion
| Caractéristique | Connexion de calcul directe | Inscription du catalogue Unity |
|---|---|---|
| Accès aux données | Accès en lecture-écriture complet à votre base de données Lakebase | Accès en lecture seule via le catalogue Unity |
| Idéal pour | Utilisation principalement des données Lakebase sans la combiner avec d’autres sources de données | Combinaison de données Lakebase avec d’autres tables de catalogue Unity dans des requêtes fédérées |
| Complexité de l’installation | Accès immédiat à l’interrogation d’une base de données spécifique sans inscription | Nécessite l'enregistrement de catalogue et les privilèges du Catalogue Unity |
| Gouvernance | Aucune fonctionnalité de gouvernance du catalogue Unity | Contrôles de gouvernance unifiés (autorisations, traçabilité, journaux d’audit) |
| Contrôle d’accès | Autorisations basées sur les rôles Postgres uniquement | Détection centralisée et contrôle d’accès sur plusieurs sources de données |
| Cas d’utilisation | Opérations et modifications de base de données directes | Tableaux de bord et applications qui intègrent des données transactionnelles et analytiques |
Méthode 1 : Se connecter directement à Lakebase compute
Utilisez cette méthode pour vous connecter directement à votre calcul Lakebase pour l’accès immédiat aux requêtes.
Prerequisites
Si vous n’êtes pas le propriétaire du projet, vérifiez que vous disposez des éléments suivants :
- Rôle Postgres : Un rôle correspondant de Postgres pour accéder à la base de données. Consultez Gérer les rôles Postgres.
- Autorisations de base de données : Les permissions nécessaires pour accéder à la base de données, au schéma ou à la table. Consultez Gérer les autorisations.
Si vous n’avez pas le rôle ou les autorisations nécessaires, contactez le propriétaire du projet pour demander l’accès.
Note
Les capacités de calcul Lakebase doivent être dans un état actif pour pouvoir les attacher. Si le calcul est inactif, vous ne pouvez pas attacher. Les calculs deviennent généralement inactifs lorsque la mise à l’échelle à zéro est activée et qu’aucune activité de base de données n’est activée.
Pour activer un calcul inactif, exécutez une requête dans l’Éditeur SQL Lakebase ou désactivez l’échelle à zéro pour vous assurer que votre calcul reste actif. Voir Mise à l’échelle à zéro.
Pour vous connecter directement à votre calcul Lakebase :
- Utilisez le commutateur d’applications pour aller dans Analytics et AI.
- Ouvrez l’éditeur SQL en cliquant sur
dans la barre latérale. - Dans le menu déroulant calcul, sélectionnez Plus...
- Dans la boîte de dialogue Attacher à une ressource de calcul existante, sélectionnez Lakebase Postgres, puis sélectionnez votre Project et Branch.
- Cliquez sur Attacher pour vous connecter.
Exemples de requêtes avec connexion directe
Après vous être connecté, vous pouvez exécuter des requêtes Postgres SQL standard sur votre base de données Lakebase.
Créez une table, insérez des données et interrogez-les :
CREATE TABLE IF NOT EXISTS playing_with_lakebase(id SERIAL PRIMARY KEY, name TEXT NOT NULL, value REAL);
INSERT INTO playing_with_lakebase(name, value)
SELECT LEFT(md5(i::TEXT), 10), random() FROM generate_series(1, 10) s(i);
SELECT * FROM playing_with_lakebase;
Interroger une table spécifique :
SELECT * FROM public.playing_with_lakebase;
Important
Limitations de la connexion directe :
- Requêtes fédérées non prises en charge : Vous ne pouvez interroger que le projet Lakebase connecté et la branche. Vous ne pouvez pas combiner les données Lakebase avec d’autres tables de catalogue Unity dans une seule requête.
-
Méta-commandes Postgres non supportées : Les méta-commandes Postgres (comme
\dt,\d,\l) qui fonctionnent dans l’éditeur SQL Lakebase ne fonctionnent pas dans l’éditeur SQL (Lakehouse).
Méthode 2 : Enregistrer une base de données dans Unity Catalog
Utilisez cette méthode pour inscrire votre base de données Lakebase dans le catalogue Unity, en activant des requêtes fédérées et une gouvernance unifiée sur vos sources de données.
Prerequisites
Vérifiez que vous disposez des éléments suivants :
- Rôle Postgres : Un rôle correspondant de Postgres pour accéder à la base de données. Consultez Gérer les rôles Postgres.
- Autorisations de base de données : Les permissions nécessaires pour accéder à la base de données, au schéma ou à la table. Consultez Gérer les autorisations.
-
Privilèges du catalogue Unity :
CREATE CATALOGprivilèges sur le métastore du catalogue Unity pour enregistrer la base de données -
Calcul : un entrepôt SQL sans serveur ou un calcul serverless pour notebooks et jobs. Les Pro SQL Warehouses et Classic SQL Warehouses ainsi que Classic Compute ne sont pas pris en charge et génèrent une erreur
PERMISSION_DENIED.
Si vous n’avez pas le rôle ou les autorisations nécessaires, contactez le propriétaire du projet pour demander l’accès.
Important
Les catalogues Lakebase nécessitent un calcul serverless. Si vous constatez une PERMISSION_DENIED erreur lors de la requête depuis l’éditeur SQL, ouvrez la liste déroulante de l’entrepôt et passez à un entrepôt SQL serverless.
Inscrire votre base de données
Pour inscrire une base de données Lakebase dans le catalogue Unity :
- Utilisez le commutateur d’applications pour aller dans Analytics et AI.
- Dans l’Explorateur de catalogues, cliquez sur le bouton Plus et créez un catalogue.
- Entrez un nom de catalogue (par exemple,
lakebase_catalog). - Sélectionnez Lakebase Postgres comme type de catalogue, puis choisissez l’option de mise à l’échelle automatique .
- Sélectionnez votre projet, votre branche et votre base de données Postgres.
- Cliquez sur Créer.
Le catalogue s’affiche dans l’Explorateur de catalogues, où vous pouvez trouver des schémas, des tables et des vues.
Interroger via Unity Catalog
Après l'enregistrement, interrogez votre base de données Lakebase depuis un entrepôt SQL serverless ou depuis des notebooks et jobs fonctionnant sur un calcul sans serveur.
Interroger une base de données enregistrée :
-- Query a registered Lakebase database
SELECT * FROM chatbot_catalog.public.conversations
WHERE created_at >= current_date - INTERVAL 7 DAYS;
Combinez les données de Lakebase et de Lakehouse :
-- Join Lakebase and Unity Catalog data
SELECT
c.conversation_id,
c.user_id,
c.agent_response,
u.user_name,
u.subscription_tier
FROM chatbot_catalog.public.conversations c
JOIN main.user_analytics.users u
ON c.user_id = u.user_id;
Pour plus d’informations sur les autorisations du catalogue Unity et sur l’octroi de l’accès à d’autres utilisateurs, consultez Autorisations et contrôle d’accès.
Important
Limitations liées à l’enregistrement au catalogue Unity :
- Accès en lecture seule : Les catalogues enregistrés dans les bases de données Lakebase sont en lecture seule via le catalogue Unity. Pour modifier des données, utilisez l’Éditeur SQL Lakebase ou connectez-vous directement à votre base de données.
- Une seule base de données par catalogue : chaque catalogue Unity Catalog représente une base de données Lakebase. Pour exposer plusieurs bases de données, inscrivez-les séparément.
-
Synchronisation des métadonnées : Unity Catalog met en cache les métadonnées afin de réduire les requêtes Postgres. Les nouveaux objets peuvent ne pas apparaître immédiatement. Cliquez sur
pour déclencher une actualisation complète. - Enregistrement de base de données branchée : L’enregistrement d’une base de données branchée comme catalogue séparé n’est pas encore pris en charge. Les branches héritent des métadonnées d’enregistrement dans Unity Catalog de leur branche parente, ce qui fait échouer l’enregistrement de nouveaux catalogues.
Pour obtenir des informations complètes sur l’inscription de bases de données dans le catalogue Unity, consultez Inscrire une base de données Lakebase dans le catalogue Unity.