Utilisation du créateur de requête avancé

Dans ce mode, la zone de requête SQL est affichée sous la forme d'un éditeur de texte libre vous permettant de créer des requêtes SQL SELECT standard de votre propre conception et complexité. Cette option est disponible pour SQL Explorer, Data Object Explorer, Database Explorer, Host Explorer et Exadata Explorer.

Avec Advanced Query Creator, vous pouvez enregistrer les paramètres de liaison en tant que filtres et les charger dans l'explorateur de données. En outre, les paramètres de liaison permettent d'ajouter des filtres dans le tableau de bord pour les requêtes d'explorateur avancées.

Ecran principal Objets de données avancés avec zone de texte de requête en texte libre sélectionnée avancée affichée

Ecrire une requête

Avec le créateur de requête avancé, vous pouvez écrire des requêtes en texte libre SELECT standard, ce qui vous permet de joindre différentes vues en une seule requête. Dans le panneau de requête principal, pour mettre à jour et saisir de nouvelles requêtes, procédez comme suit :

Remarque

Lors du développement de requêtes, les éléments suivants doivent être pris en compte :

SELECT ou WITH doit être le premier mot-clé utilisé dans la zone de requête SQL avancée.
Si la clause WITH est utilisée, elle doit être utilisée au début de la requête. Une clause WITH imbriquée n'est pas prise en charge.
Si le nom d'objet de données doit être référencé plusieurs fois dans la requête, vous devez définir un nom CTE de clause WITH et utiliser le nom CTE dans la requête. Par exemple : WITH MYDO AS (SELECT * FROM OPSIDO$HOSTINSIGHTS$HOST_CPU_AND_MEMORY_DAILY))

Sous Mode, sélectionnez Avancé pour accéder à l'éditeur de requête en texte libre.
Effacez la requête en cours, cliquez sur le bouton Effacer.
Ecrivez une nouvelle requête SELECT standard.
Cliquez sur le bouton Exécuter pour exécuter la nouvelle requête.
Basculez entre différents types de graphique à l'aide du panneau Visualisation à droite des résultats de la requête. Cela vous permettra de visualiser vos données de différentes manières.

Utiliser des vues, des colonnes et des exemples de requête

Des exemples de requête prédéfinis, ainsi que des noms de vue et de colonne sont disponibles pour les différents types d'objet de données et peuvent être utilisés comme base pour vos requêtes personnalisées. Pour commencer à utiliser les exemples de requête en mode avancé, cliquez sur le bouton ? en haut à droite de la fenêtre de l'éditeur SQL. L'écran Affichage et colonne et les exemples de requêtes s'affichent.

Ecran Visualiser, Colonne et Exemples de requêtes

Cliquez sur l'onglet Vues et colonnes pour afficher la liste complète des paramètres de vue et de colonne disponibles, ainsi que le type et la description des vues et des colonnes. Vous pouvez également développer des vues, ce qui vous permet de voir toutes les colonnes associées à cette vue. Une fois que vous avez sélectionné la vue ou la colonne, cliquez sur Copier pour copier son nom dans la requête.

Le champ Rechercher vous permet de rechercher et de rechercher des noms de vue et des noms de colonne spécifiques.

Sélectionnez le type de ressource à filtrer et réviser. Le sélecteur d'objet de données et la table vue/colonne seront filtrés en fonction du type de ressource. Les types de ressource sont disponibles pour les explorateurs suivants :

Explorateur SQL : Oracle et MySQL
Explorateur de base de données : Oracle et MySQL
Explorateur d'objets de données : base de données - Oracle, base de données - MySQL, Exadata et hôte.

Cliquez sur n'importe quelle requête Exemple pour afficher des exemples de requête. Cliquez sur Copier si vous voulez en utiliser un comme base pour vos propres requêtes.

Une fois que vous avez copié l'élément de votre choix, cliquez sur Fermer pour revenir à l'écran Explorateur et continuer à créer votre requête.

Utiliser les paramètres de liaison dans Advanced Query Creator

Vous pouvez ajouter des paramètres de liaison à la requête de forme libre avancée, ce qui vous permet d'utiliser la notation de requête : en tant qu'espace réservé et d'entrer des valeurs de données ultérieurement. Avec Advanced Query Creator, vous pouvez enregistrer les paramètres de liaison en tant que filtres et les charger dans l'explorateur de données.

Figure 12-1 Ajout de paramètres attachés à l'aide de l'explorateur de données

Ajouter un paramètre de liaison à une instruction SQL à l'aide de l'explorateur de données

Sous Mode, sélectionnez Avancé pour accéder à l'éditeur de requête en texte libre.
Cliquez sur le bouton Ajouter un paramètre de liaison situé sur le côté droit de l'écran. Cela ouvrira la diapositive du paramètre Add bind. Vous pouvez sélectionner l'une des options suivantes :
- Choisir un paramètre de liaison existant : sélectionnez le compartiment de widget, puis le filtre de votre choix. Cliquez sur Ajouter.
  
  Figure 12-2 Ajout d'un paramètre de liaison existant
- Configurer un nouveau paramètre : sélectionnez l'une des deux options.
  
  Figure 12-3 Ajout d'un nouveau paramètre de liaison
  1. Liste des valeurs en fonction de l'objet de données : sélectionnez l'objet de données, le champ de dimension souhaité, qui sera rempli avec les valeurs distinctes de ce champ. Entrez un nom de paramètre de liaison. Sous Paramètres, les options suivantes sont configurables :
    - Mode de sélection : détermine si la liste déroulante des variables attachées prend en charge une ou plusieurs sélections.
    - Obligatoire : détermine si la valeur du paramètre de liaison requiert une sélection.
    - Remplacer automatiquement la valeur vide : détermine si les sélections de paramètre de liaison vides doivent être gérées automatiquement. Lorsque le remplacement automatique est activé, les valeurs de variable attachée vides utilisées après '=' (opérateur Egal à) sont automatiquement gérées lors de l'exécution. Vous pouvez afficher les exemples de remplacement automatique dans la diapositive en développant la section Exemples.
      Remarque
      
      Applicable uniquement lorsque le paramètre n'est pas requis.
  2. Utiliser la valeur indiquée : entrez le nom du paramètre de liaison et le type (STRING, NUMBER, DATETIME). Sous Paramètres, les options suivantes sont configurables :
    - Obligatoire : détermine si la valeur du paramètre de liaison requiert une sélection.
    - Remplacer automatiquement la valeur vide : détermine si les sélections de paramètre de liaison vides doivent être gérées automatiquement. Applicable uniquement lorsque le paramètre n'est pas requis.
Une fois que toutes les informations ont été saisies, cliquez sur Ajouter pour ajouter le paramètre de liaison à l'explorateur de données. Les options Bind Parameters s'affichent à présent. Vous pouvez sélectionner une valeur pour le paramètre de liaison ou saisir manuellement les valeurs pour le champ de saisie en texte libre.
Les paramètres attachés ne fonctionnent que lorsqu'ils sont utilisés dans une requête à l'aide de l'annotation ':' devant le nom du paramètre attaché afin qu'il soit utilisé correctement dans la requête. Mettez à jour la requête, puis cliquez sur Exécuter. La requête sera exécutée avec les paramètres de liaison.
En outre, vous pouvez enregistrer la recherche en cours ainsi que le paramètre de liaison en tant que filtre de recherche enregistrée en cliquant sur Enregistrer ou sur Enregistrer sous dans la section du bouton d'action.
Les recherches enregistrées qui lient des paramètres de liaison chargeront automatiquement les paramètres de liaison liés dans Explorer. De même, lors de l'ajout d'une recherche enregistrée à un tableau de bord, les filtres de paramètres de liaison sont ajoutés automatiquement. Les paramètres de liaison ne sont ajoutés automatiquement à un tableau de bord que lorsqu'ils sont requis pour la recherche enregistrée.

Pour ajouter un paramètre de liaison facultatif à un widget de tableau de bord, reportez-vous à Ajout d'un paramètre de liaison facultatif dans un tableau de bord.

Documentation Oracle Cloud Infrastructure

Utilisation du créateur de requête avancé