Options d'interface utilisateur dans Compléments de feuille de calcul

Les modules d'extension de feuille de calcul fournissent des éléments d'interface utilisateur communs à plusieurs fonctionnalités et des contrôles supplémentaires propres à des panneaux individuels.

Informations de connexion

La section supérieure de la plupart des panneaux d'extension affiche des informations sur la connexion active, notamment l'URL de la base de données, le schéma, le statut de la connexion et le temps de session restant avant l'expiration de la connexion. Pour les connexions OCI IAM, il affiche également l'utilisateur connecté.

Remarques :

Bien que le module d'extension conserve une connexion active avec la base de données, les données extraites sont locales dans la feuille de calcul. En cas d'inactivité ou d'expiration de la connexion, le module d'extension affiche une notification et suggère de vous reconnecter à la base de données.

Utilisation de l'éditeur de requêtes SQL

L'éditeur de requêtes SQL est la zone dans laquelle vous écrivez, modifiez et visualisez les instructions SQL avant de les exécuter.

Vous pouvez entrer une requête manuellement ou sélectionner des tables, des vues et des colonnes à partir du navigateur d'objets pour faciliter la création de l'instruction SQL. L'éditeur de requêtes SQL affiche les numéros de ligne et la coloration syntaxique des requêtes.

Les actions disponibles dans l'éditeur de requête dépendent de la fonctionnalité d'extension que vous utilisez. En général, vous pouvez utiliser les options suivantes avec l'éditeur de requêtes SQL :

  • Exécution

    Le premier bouton, affiché sous la forme d'un cercle avec un triangle, est le bouton Run (Exécuter). Cliquez sur ce bouton pour exécuter l'instruction SQL et afficher les résultats de la requête dans la feuille de calcul sélectionnée.

  • Effacer contenu SQL

    L'icône d'effacement en regard de Exécuter enlève l'instruction SQL en cours de l'éditeur de requête.

  • Extraire la requête à partir de la feuille

    Ce bouton extrait la requête SQL de la feuille de calcul active et l'affiche dans l'éditeur de requête SQL. Vous pouvez ensuite modifier et exécuter à nouveau la requête.

  • Partager en tant que lien hypertexte de table

    Cette option est disponible uniquement pour les résultats de requête générés à l'aide de SQL direct et de l'analyse de données. Créez un lien hypertexte de table et partagez-le avec d'autres utilisateurs afin qu'ils puissent charger les résultats de requête en lecture seule dans une feuille de calcul.

Remarques :

Le module d'extension pour Excel fournit un menu flottant avec des options supplémentaires, telles que le rechargement de la fenêtre du module. Cliquez sur la petite flèche sur le côté droit de la fenêtre du complément pour ouvrir le menu flottant.

Sélectionner une feuille de travail pour les résultats de requête

Vous pouvez utiliser la feuille par défaut ou sélectionner une autre feuille pour afficher les résultats.

Remarques :

Si vous exécutez une autre requête dans la même feuille de calcul, le module d'extension actualise la feuille de calcul avec le résultat de la nouvelle requête.

Pour utiliser une autre feuille pour une autre requête, procédez comme suit :

  • Dans Compléments de feuille de calcul, cliquez sur le bouton plus (+), indiquez un nom sous Ajouter une nouvelle feuille de calcul et cliquez sur le bouton de coche. Le module d'extension insère la nouvelle feuille lorsque vous exécutez la requête. Le bouton Flèche Gauche permet d'annuler et de revenir en arrière.

  • Insérez une nouvelle feuille à l'aide des options d'Excel ou de Google Sheets.

Vous pouvez ensuite sélectionner la nouvelle feuille dans Sélectionner une feuille de calcul et afficher les résultats.

Interroger les informations

Outre les résultats de requête, la feuille de calcul affiche également les informations de requête suivantes :

  • l'URL de base de données ;

  • l'utilisateur ou le schéma de base de données qui crée et exécute la requête

  • la requête SQL réelle

  • la configuration d'actualisation

  • Date et heure de la requête.

Utiliser des variables attachées dans des requêtes SQL

Vous pouvez utiliser des variables attachées dans une requête SQL pour fournir des valeurs lors de l'exécution. Définissez une variable attachée dans l'instruction SQL à l'aide du signe deux-points ( :), suivi d'un nom de variable.

Par exemple :

SELECT *
FROM employees
WHERE city = :ct;

Lorsque vous exécutez la requête, le module d'extension vous invite à entrer une valeur pour la variable attachée, :ct. Une fois que vous avez indiqué une valeur, par exemple Austin, la requête s'exécute en utilisant cette valeur. Les informations de requête affichées avec les résultats incluent l'affectation de variable attachée, par exemple, :ct=Austin.

Vous pouvez inclure plusieurs variables attachées dans une requête. Le module d'extension conserve les valeurs récemment utilisées pour chaque variable attachée. Lorsque vous exécutez à nouveau la requête, vous pouvez sélectionner une valeur récente ou saisir une nouvelle valeur. Vous pouvez également effacer les valeurs précédemment enregistrées dans la boîte de dialogue Paramètres de requête.

Actualiser les résultats de la requête

Vous pouvez utiliser Actualiser la requête pour réexécuter une requête enregistrée et mettre à jour les résultats dans une feuille de calcul sans ouvrir les panneaux SQL direct, Analyse des données ou Langage naturel.

Pour actualiser les résultats d'une requête :

  1. Sélectionnez une feuille de calcul contenant les résultats de requête générés par les compléments de feuille de calcul.

  2. Cliquez sur Actualiser la requête.

    Le module d'extension réexécute la requête enregistrée et met à jour la feuille de calcul actuelle avec les derniers résultats.

Si le classeur contient des feuilles de calcul supplémentaires avec des résultats de requête actualisables, le module d'extension affiche le nombre de feuilles de calcul restantes et vous invite à les actualiser. Une fois l'actualisation terminée, le module d'extension affiche un rapport qui indique les feuilles de travail qui ont été actualisées avec succès et identifie toutes les feuilles de travail qui n'ont pas pu être actualisées.

Remarques :

Une feuille de calcul peut être actualisée si la connexion à la base de données correspondante est enregistrée et connectée. Compléments de feuille de calcul actualise chaque feuille de calcul à l'aide des informations de connexion enregistrées, même si cette connexion n'est pas la connexion active.

Une opération d'actualisation peut échouer dans les scénarios suivants :

  • La visualisation enregistrée ne correspond plus aux colonnes renvoyées par la requête.

  • Aucune connexion enregistrée ne correspond à l'URL de base de données et à l'utilisateur associés à la feuille de calcul.

  • La connexion de base de données requise est déconnectée.

Le rapport d'actualisation fournit des détails sur les feuilles de travail ayant échoué. Selon la cause, vous pouvez mettre à jour la requête ou la visualisation, ajouter ou importer une connexion enregistrée correspondante ou reconnecter la connexion de base de données requise avant d'actualiser à nouveau.

Gérer les données volumineuses

Pour les requêtes avec des jeux de données volumineux, par exemple un résultat contenant plus de 10 000 enregistrements, le module d'extension affiche une fenêtre de confirmation si vous souhaitez afficher l'intégralité du résultat.

Remarques :

Lorsque vous utilisez des tableaux croisés dynamiques, chargez les données complètes pour obtenir des résultats précis à partir de l'agrégation.

Rubrique parent : Utilisation des fonctionnalités des compléments de feuille de calcul