Simple Log Service:Accélérez les requêtes avec les vues matérialisées

Portée et limitations

• Seuls les Logstores Standard sont pris en charge. Les Query Logstores, MetricStores et StoreViews ne sont pas pris en charge.

• Vous pouvez créer jusqu'à 100 vues matérialisées par projet.

• Vous pouvez créer et gérer des vues matérialisées dans la console ou via l'API.

Exigences en matière d'autorisations

Un compte Alibaba Cloud dispose par défaut de toutes les autorisations requises. Un utilisateur RAM doit se voir attribuer les autorisations suivantes :

Créer depuis la page de requête

Vous pouvez créer une vue matérialisée directement à partir d'une requête SQL sur la page de requête et d'analyse.

1. Connectez-vous à la console Simple Log Service.

2. Dans la liste Projects, cliquez sur le projet cible, puis sur le Logstore Standard cible.

3. Sur la page de requête et d'analyse, saisissez l'instruction SQL que vous souhaitez accélérer, puis cliquez sur Search & Analyze.

4. Dans la zone statistics chart des résultats de la requête, cliquez sur Create Materialized View.

5. Dans l'assistant de création, complétez la configuration. L'instruction SQL est automatiquement renseignée avec la requête actuelle. Les autres paramètres sont identiques à ceux de la création d'une vue depuis le panneau des vues matérialisées.

Créer et gérer dans la console

Créer une vue matérialisée

1. Connectez-vous à la console Simple Log Service.

2. Dans la liste Projects, cliquez sur le projet cible.

3. Dans le volet de navigation de gauche, cliquez sur l'icône Materialized View.

4. Sur le panneau des vues matérialisées, cliquez sur Create Now.

5. Dans l'assistant de création, configurez les paramètres suivants.

   1. Source Logstore : configurez la source de données pour la vue matérialisée.

      Paramètre	Description
      Project	Automatiquement renseigné avec le projet actuel et ne peut pas être modifié.
      Type de source	Sélectionnez Logstore. Actuellement, seuls les Logstores Standard sont pris en charge.
      Logstore	Sélectionnez le Logstore cible dans la liste déroulante.

      Une fois la configuration terminée, cliquez sur Next.

   2. Configuration de la vue matérialisée : configurez le nom, le code SQL et les autres paramètres de la vue matérialisée.

      Paramètre	Description
      Nom de la vue matérialisée	Saisissez un nom pour la vue matérialisée. Le système ajoute automatiquement le préfixe mv_. Vous n'avez pas besoin de l'ajouter manuellement.
      Code SQL	Saisissez l'instruction SQL à accélérer. L'éditeur prend en charge la coloration syntaxique et la saisie semi-automatique. Après avoir saisi l'instruction SQL, cliquez sur Preview pour valider le résultat d'exécution. Remarque Les noms de colonnes utilisés dans l'instruction SQL doivent être indexés. Sinon, une erreur se produit lors de la prévisualisation.
      Heure de début	Sélectionnez l'heure de début pour la matérialisation des données. Cette heure est basée sur l'heure d'écriture des données brutes. Le système ne matérialise que les données écrites après cette heure.
      Intervalle de matérialisation	Définissez l'intervalle (en minutes) auquel la vue est recalculée. Un intervalle plus court maintient le résultat matérialisé plus proche du temps réel, mais augmente les coûts de calcul.

6. Une fois la configuration terminée, cliquez sur Save.

   Après la création de la vue matérialisée, le système vous redirige automatiquement vers la page de requête de la vue matérialisée.

   Remarque

   La période de conservation des données d'une vue matérialisée est identique à celle du Source Logstore associé. Vous pouvez créer un maximum de 100 vues matérialisées par projet.

Afficher et gérer les vues matérialisées

Après avoir créé une vue matérialisée, vous pouvez la consulter et la gérer dans la console.

• Afficher la liste des vues matérialisées

  Dans le volet de navigation de gauche du projet cible, cliquez sur l'icône Materialized View. Le panneau latéral qui s'affiche présente toutes les vues matérialisées du projet actuel.

• Afficher les détails d'une vue matérialisée

  Dans la liste des vues matérialisées, cliquez sur le nom d'une vue matérialisée pour ouvrir sa page de détails. La page de détails affiche les informations de configuration suivantes :

  • Materialized View Name : le nom complet de la vue matérialisée, y compris le préfixe mv_.

  • Start At : l'heure de début pour la matérialisation des données.

  • View Update Interval : l'intervalle auquel la vue est recalculée.

  • Data Retention Period : identique à la période de conservation des données du Source Logstore.

  • SQL Code : l'instruction SQL correspondant à la vue matérialisée.

• Supprimer une vue matérialisée

  Sur la page de détails de la vue matérialisée, cliquez sur Delete, puis sur OK dans la boîte de dialogue de confirmation.

  Avertissement

  Une vue matérialisée supprimée ne peut pas être récupérée. Le materialized store correspondant est également supprimé.

Accélération des requêtes de tableau de bord

Si un graphique de tableau de bord présente une latence de requête élevée, vous pouvez créer une vue matérialisée pour l'accélérer. Pour plus d'informations, consultez la rubrique accélération des requêtes de tableau de bord.

Utiliser un SDK

Vous pouvez également créer et gérer des vues matérialisées par programmation à l'aide d'un SDK. L'exemple suivant utilise Java.

1. Importez le SDK SLS pour Java.

   <dependency>
       <groupId>com.aliyun.openservices</groupId>
       <artifactId>aliyun-log</artifactId>
       <version>0.6.138</version>
   </dependency>

2. L'exemple suivant montre comment créer, lister, obtenir et supprimer des vues matérialisées. Modifiez et exécutez le code selon vos besoins.

   • Obtenez les paramètres du code comme suit :

     • Pour obtenir un ID AccessKey et un secret AccessKey, consultez la rubrique Obtenir une paire de clés AccessKey.

     • Pour obtenir l'endpoint :

       1. Connectez-vous à la console Simple Log Service, et dans la liste des projets, cliquez sur le projet cible.

       2. Cliquez sur l'icône à côté du nom du projet pour ouvrir la page Project Overview, puis copiez l'endpoint public.

     import com.aliyun.openservices.log.Client;
     import com.aliyun.openservices.log.exception.LogException;
     import com.aliyun.openservices.log.request.CreateMaterializedViewRequest;
     import com.aliyun.openservices.log.request.ListMaterializedViewsRequest;
     import com.aliyun.openservices.log.response.GetMaterializedViewResponse;
     import com.aliyun.openservices.log.response.ListMaterializedViewsResponse;
     
     import java.text.SimpleDateFormat;
     import java.util.concurrent.TimeUnit;
     
     public class MvDemo
     {
         static String accessId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         static String accessKey = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         /**
          * The endpoint for Simple Log Service. This example uses Hangzhou. Change it to your actual region.
          */
         static String host = "cn-hangzhou.log.aliyuncs.com";
         /**
          * Create a Simple Log Service client.
          */
         static Client client = new Client(host, accessId, accessKey);
         /**
          * The project name.
          */
         static String projectName = "xxx";
         /**
          * The Logstore name.
          */
         static String logstoreName = "xxx";
     
         public static void main(String[] args) throws Exception {
             String materializedViewName = "test_mv";
     
             createMv(materializedViewName); // Create a materialized view with the specified name.
     
             listMv(); // Get the list of materialized views in the current project.
     
             getMv(materializedViewName); // Get information about the current materialized view.
     
             // deleteMv(materializedViewName); // Delete the materialized view.
         }
     
         static int dateStrToSecond(String dateStr) throws Exception {
             SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
             return (int)TimeUnit.MILLISECONDS.toSeconds(simpleDateFormat.parse(dateStr).getTime());
         }
     
         static void createMv(String materializedViewName) throws Exception {
             String originalSql = "* | select count(l1) as cnt, l2 from stability group by l2"; // Modify this to the SQL query you want to accelerate.
             int aggInternalMins = 60; // The materialization interval, in minutes.
             int startTime = dateStrToSecond("2025-07-30 00:00:00"); // The start time for materialization, based on the write time of raw data. Only data written after this time is materialized.
             int ttl = 0; // The TTL of the materialized store. A value of 0 means the TTL matches that of the Source Logstore. This TTL cannot be shorter than the Source Logstore's TTL.
             // The number of materialized views per project cannot exceed 100.
             CreateMaterializedViewRequest request = new CreateMaterializedViewRequest(projectName, materializedViewName, logstoreName, originalSql, aggInternalMins, startTime, ttl);
             client.createMaterializedView(request);
             System.out.println("create materialized view " + materializedViewName);
         }
     
         static void listMv() throws LogException
         {
             ListMaterializedViewsRequest request = new ListMaterializedViewsRequest(projectName, "", 0, 10); // 0 and 10 are pagination parameters.
             ListMaterializedViewsResponse response = client.listMaterializedViews(request);
             System.out.println("total materialized view count: " + response.getTotal());
             for (String materializedView : response.getMaterializedViews()) {
                 System.out.println(materializedView);
             }
         }
     
         static void getMv(String materializedViewName) throws Exception
         {
             GetMaterializedViewResponse response = client.getMaterializedView(projectName, materializedViewName);
             System.out.println("get materialized view detail, name: " + materializedViewName);
             System.out.println("originalSql: " + response.getOriginalSql());
             System.out.println("startTime: " + response.getStartTime());
             System.out.println("ttl: " + response.getTtl());
         }
     
         static void deleteMv(String materializedViewName ) throws LogException {
             client.deleteMaterializedView(projectName, materializedViewName);
             System.out.println("delete materialized view " + materializedViewName);
         }
     
     }