Navigation dans les données à l’aide de l’extension SQL - Amazon SageMaker AI

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Navigation dans les données à l’aide de l’extension SQL

Pour ouvrir l'interface utilisateur (UI) de l'extension SQL, cliquez sur l'icône de l'extension SQL ( Purple circular icon with a clock symbol representing time or scheduling. ) dans le volet de navigation de votre JupyterLab application dans Studio. La vue de découverte des données du panneau de gauche s’étend et affiche toutes les connexions de magasin de données préconfigurées à Amazon Athena, Amazon Redshift et Snowflake.

À partir de là, vous pouvez effectuer les actions suivantes :

  • Développer une connexion spécifique pour explorer ses bases de données, ses schémas, ses tables ou ses vues, ainsi que ses colonnes.

  • Rechercher une connexion spécifique à l’aide du champ de recherche de l’interface utilisateur de l’extension SQL. La recherche renvoie les bases de données, les schémas, les tables ou les vues qui correspondent partiellement à la chaîne que vous entrez.

Note

Si Athena est déjà configurée dans votre AWS compte, vous pouvez en activer une default-athena-connection dans votre JupyterLab application. Cela vous permet d’exécuter des requêtes Athena sans avoir à créer manuellement la connexion. Pour activer la connexion Athena par défaut :

  1. Vérifiez auprès de votre administrateur que votre rôle d'exécution dispose des autorisations requises pour accéder à Athena et au AWS Glue catalogue. Pour obtenir des détails sur les autorisations requises, consultez Configuration d’une connexion AWS Glue pour Athena.

  2. Dans votre JupyterLab application, accédez au menu Paramètres dans la barre de navigation supérieure et ouvrez le menu de l'éditeur de paramètres.

  3. Choisissez Découverte des données.

  4. Cochez la case Activer la connexion Athena par défaut.

  5. Vous pouvez mettre à jour la valeur par défaut primary WorkGroup si nécessaire.

Pour interroger une base de données, un schéma ou une table dans un JupyterLab bloc-notes, à partir d'une connexion donnée dans le volet d'extension SQL :

  • Choisissez l’icône à trois points ( SQL extension three dots icon. ) sur le côté droit d’une base de données, d’un schéma ou d’une table quelconque.

  • Sélectionnez Requête dans le bloc-notes dans le menu.

    Cela remplit automatiquement une cellule du bloc-notes JupyterLab avec la commande %%sm_sql magique appropriée pour se connecter à la source de données. Cela ajoute également un exemple d’instruction SQL pour vous aider à exécuter des requêtes immédiatement. Vous pouvez affiner encore la requête SQL à l’aide des fonctionnalités de saisie automatique et de surlignage de l’extension. Consultez Fonctionnalités de l'extension JupyterLab SQL relatives à l'éditeur SQL pour plus d’informations sur l’utilisation de l’éditeur SQL de l’extension SQL.

Au niveau de la table, l’icône à trois points fournit l’option supplémentaire permettant de choisir de prévisualiser les métadonnées d’une table.

Le contenu des cellules du JupyterLab bloc-notes ci-dessous montre un exemple de ce qui est généré automatiquement lorsque vous sélectionnez le menu Requête dans le bloc-notes sur une source de redshift-connection données dans le volet d'extension SQL.

%%sm_sql --metastore-id redshift-connection --metastore-type GLUE_CONNECTION

-- Query to list tables from schema 'dev.public'
SHOW TABLES
FROM
  SCHEMA "dev"."public"

Utilisez le symbole inférieur à ( Icon to clear the SQL extension search box. ) en haut du volet de l’extension SQL pour effacer le champ de recherche ou revenir à la liste de vos connexions.

Note

L’extension met en cache vos résultats d’exploration pour un accès rapide. Si les résultats mis en cache sont périmés ou si une connexion est absente de votre liste, vous pouvez actualiser manuellement le cache en choisissant le bouton Actualiser en bas du panneau d’extension SQL. Pour plus d’informations sur la mise en cache des connexions, consultez Mise en cache des connexions aux extensions SQL.