Enregistrement, partage et export de requêtes SQL

Vous pouvez enregistrer une requête SQL à tout moment et continuer à travailler dessus ultérieurement. Vous pouvez également enregistrer une requête terminée et la partager en tant que widget de recherche pour une utilisation future par vous ou d'autres utilisateurs.

Si vous avez créé le widget pour une période fixe, chaque fois que vous l'ouvrez, il affiche les résultats de la période définie dans la recherche. Par défaut, si vous avez créé le widget pour une période relative (par exemple, les 7 derniers jours), chaque fois que vous l'ouvrez, il affiche les résultats à jour selon le sélecteur d'heure (7 derniers jours). Lorsque le widget est référencé dans un tableau de bord, il reflète le paramètre de sélecteur de temps de page.

Prérequis :

Le menu Action de l'explorateur SQL vous permet d'enregistrer et de partager vos recherches SQL avec d'autres utilisateurs.

Enregistrement d'une recherche terminée et ajout à un tableau de bord

Pour enregistrer une requête SQL et l'ajouter à un tableau de bord :

  1. Dans le menu Actions, sélectionnez Enregistrer. La boîte de dialogue Enregistrer la recherche apparaît.
  2. Sélectionnez un compartiment dans lequel enregistrer la recherche.
    Remarque

    Il n'existe aucune association entre le compartiment sélectionné de la recherche enregistrée et les données sous-jacentes faisant l'objet de la requête.
  3. Entrez un nom et une description pour le widget.

    Vous pouvez éventuellement enregistrer le widget de recherche et l'ajouter à un tableau de bord.

  4. Cliquez sur l'option Ajouter au tableau de bord.
  5. Choisissez si vous souhaitez ajouter le widget à un tableau de bord existant (sélectionnez le compartiment du tableau de bord et un tableau de bord spécifique) ou créez un tableau de bord et fournissez les informations requises.
    Remarque

    Ops Insights fournit les tableaux de bord prêts à l'emploi suivants pour Exadata :
    • Tableau de bord de cellules Exadata - Horaire

      Tableau de bord de granularité horaire pour les mesures de disque cellule.

    • Tableau de bord IORM Exadata - Horaire

      Tableau de bord de degré de finesse horaire pour les mesures associées à l'IORM Exadata.

  6. Cliquez sur Enregistrer.

Ouvrir une recherche précédemment sauvegardée ou prédéfinie

  1. Dans le menu Actions, sélectionnez Ouvrir. La boîte de dialogue Ouvrir la recherche apparaît.
  2. Choisissez une recherche précédemment enregistrée ou l'un des widgets de recherche prédéfinis fournis avec SQL Explorer.
  3. Cliquez sur Ouvrir.

Supprimer une recherche enregistrée

  1. Dans le menu Actions, sélectionnez Supprimer. La boîte de dialogue Supprimer la recherche apparaît.
  2. Choisissez une recherche précédemment enregistrée.
  3. Cliquez sur Supprimer.

Important : si vous supprimez un widget de recherche enregistrée qui est actuellement référencé par un tableau de bord existant, sachez qu'il n'est pas automatiquement supprimé du tableau de bord. Cela entraînera une erreur lors de l'accès au tableau de bord.

Remarque

Vous ne pouvez pas supprimer une recherche prédéfinie prête à l'emploi.

Création d'une requête de recherche enregistrée à partir d'une requête existante

Vous pouvez créer une recherche personnalisée à partir d'une recherche existante à l'aide de l'option Enregistrer sous.

  1. Dans le menu Actions, sélectionnez Ouvrir. La boîte de dialogue Ouvrir la recherche apparaît.
  2. Choisissez une recherche précédemment enregistrée ou prédéfinie dans la liste.
  3. Cliquez sur Ouvrir. Les critères de recherche sont affichés dans SQL Explorer.
  4. Mettez à jour les critères de recherche si nécessaire.
  5. Dans le menu Actions, sélectionnez Enregistrer sous.
  6. Entrez un nouveau nom pour la recherche mise à jour.
  7. Cliquez sur Enregistrer.

Mettre à jour le nom et la description d'une recherche existante

Lors du développement d'une requête SQL, vous pouvez modifier le nom et les informations descriptives associées du widget de recherche. Vous pouvez utiliser l'option Modifier pour effectuer ces modifications.

  1. Dans le menu Actions, sélectionnez Ouvrir si vous mettez à jour un widget de recherche existant. La boîte de dialogue Ouvrir la recherche apparaît.
  2. Sélectionnez le compartiment dans lequel réside le widget de recherche.
    Remarque

    Il n'existe aucune association entre le compartiment sélectionné de la recherche enregistrée et les données sous-jacentes faisant l'objet de la requête.
  3. Sélectionnez un widget de recherche et cliquez sur Ouvrir pour afficher la recherche dans l'explorateur SQL.
  4. Dans le menu Actions, sélectionnez Modifier. La boîte de dialogue Modifier la recherche apparaît.
  5. Entrez un nom de la nouvelle recherche et/ou une description de la nouvelle recherche.
  6. Cliquez sur Modifier pour enregistrer les modifications apportées.

Créer une nouvelle recherche

Pour effacer les critères de recherche existants et lancer une nouvelle recherche, sélectionnez Créer dans le menu Actions.

Export de données

Pour exporter les données obtenues à partir d'une recherche, cliquez sur Exporter au format CSV dans le menu Recherche enregistrée. L'export de données est limité à 10 000 lignes maximum pouvant être extraites pour une seule requête (en utilisant la limite = 1000 et les pages = 10). Vous pouvez également exporter des données via la CLI (interface de ligne de commande). L'export via la CLI est très puissant et facile à utiliser. Reportez-vous à l'exemple ci-dessous pour obtenir des données à l'aide de la CLI :
  • Exemple avec un fichier JSON :
    oci opsi
    opsi-data-objects query-data-templatized-query 
    --from-json file://./<file name>
    --compartment-id <compartment id>
    --limit 1000
    Le fichier JSON contient les éléments suivants :
    {
       "dataObjectIdentifier":"opsidataobject.dbinsights.f0819908-5ae3-4cb5-8a81-80a4ba888881",
       "query":{
          "queryType":"TEMPLATIZED_QUERY",
          "selectList":[
             "DB_DISPLAY_NAME, CDB_NAME, EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"
          ],
          "whereConditionsList":[
              
          ],
          "groupByList":[
              
          ],
          "havingConditionsList":[
              
          ],
          "orderByList":[
             "ROLLUP_TIME_UTC ASC"
          ],
          "timeFilters":{
             "timeStart":"2024-01-05T00:00:00.000Z",
             "timeEnd":"2024-01-12T00:00:00.000Z"
          }
       },
       "resourceFilters":{
          "compartmentIdInSubtree":false
       }
    }
  • Exemple d'appel de la requête directement dans la commande CLI :
    oci opsi
    opsi-data-objects query-data-templatized-query 
    --compartment-id <compartment id>
    --data-object-identifier <data object id>
    --query-select-list '["DB_DISPLAY_NAME, CDB_NAME,EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"]'
    --query-order-by-list '["ROLLUP_TIME_UTC ASC"]'
    --limit 1000