Use the TimeSeries model from the console - Tablestore - Centre de documentation Alibaba Cloud

Le modèle TimeSeries est conçu pour les données de séries temporelles. Il est idéal pour des scénarios tels que la surveillance des appareils IoT (Internet des objets), la collecte de données d'appareils et la surveillance des machines. Il prend en charge les écritures et les requêtes à haute concurrence et offre un stockage économique pour des pétaoctets de données. Cette rubrique explique comment utiliser le modèle TimeSeries dans la console Tablestore.

Important

Pour utiliser le modèle TimeSeries avec un outil en ligne de commande, consultez la section Utilisation du modèle TimeSeries avec un outil en ligne de commande.

Remarques

Le modèle TimeSeries est pris en charge dans les régions suivantes : Chine (Hangzhou), Chine (Shanghai), Chine (Pékin), Chine (Zhangjiakou), Chine (Ulanqab), Chine (Shenzhen), Chine (Chengdu), Chine (Hong Kong), Japon (Tokyo), Malaisie (Kuala Lumpur), Allemagne (Francfort), Indonésie (Jakarta), Royaume-Uni (Londres), États-Unis (Silicon Valley), États-Unis (Virginie), Arabie saoudite (Riyad - Région partenaire), et Singapour.

Des fonctionnalités telles que l'index Lastpoint, le stockage analytique des séries temporelles, les identifiants de série temporelle personnalisés et les champs de données en tant que clés primaires sont disponibles uniquement dans les régions Chine (Hangzhou), Chine (Shanghai), Chine (Pékin) et Chine (Zhangjiakou). Pour utiliser ces fonctionnalités, créez votre instance dans l'une de ces régions.

Prérequis

Vous avez activé le service Tablestore. Pour plus d'informations, consultez la section Activation de Tablestore.
Une instance de modèle TimeSeries a été créée.
1. Connectez-vous à la console Tablestore.
2. Dans la barre de navigation supérieure, sélectionnez un groupe de ressources et une région.
3. Sur la page Overview, cliquez sur Create Instance for TimeSeries Model.
4. Dans la boîte de dialogue Create Instance for TimeSeries Model, sélectionnez une spécification d'instance, saisissez un nom d'instance et ajoutez une description d'instance.
5. Cliquez sur OK.

Procédure

Étape 1 : Créer une table de séries temporelles

Créez une table de séries temporelles pour stocker les données de séries temporelles.

Pour obtenir des informations sur le scénario d'exemple et le schéma de table, consultez la section Scénario d'exemple .

Accédez à la page Instance Management.
1. Connectez-vous à la console Tablestore.
2. Dans la barre de navigation supérieure, sélectionnez un groupe de ressources et une région.
3. Sur la page Overview, cliquez sur le nom de l'instance ou sur Manage Instance dans la colonne Actions de l'instance.
Sous l'onglet Instance Details, cliquez sur l'onglet Time Series Tables.
Sous l'onglet Time Series Tables, cliquez sur Create Time Series Table.

Remarque
Vous pouvez également cliquer sur Generate Demo with One Click pour créer une table d'exemple avec des données d'exemple afin de tester rapidement les fonctionnalités. L'affichage d'une nouvelle série temporelle peut prendre quelques secondes, le temps que le système initialise la table d'exemple.
Dans la boîte de dialogue Create Time Series Table, définissez le paramètre Time Series Table Name sur car_example et conservez les paramètres par défaut pour les autres options.
Cliquez sur Create.

Une fois la table de séries temporelles créée, vous pouvez la consulter sous l'onglet Time Series Tables. Si la nouvelle table n'apparaît pas dans la liste, cliquez sur l'icône pour actualiser la liste des tables de séries temporelles.

Étape 2 : Écrire des données

Écrivez des données dans la table de séries temporelles. Les données de séries temporelles se composent de métadonnées et de points de données. Si vous ne créez pas les métadonnées au préalable, le système les extrait automatiquement des données que vous écrivez.

Sous l'onglet Time Series Tables, cliquez sur le nom de la table de séries temporelles, puis sur l'onglet Query Data. Vous pouvez également cliquer sur Manage Data dans la colonne Actions de la table de séries temporelles.
(Facultatif) Créez une série temporelle.
1. Sous l'onglet Query Data, cliquez sur Add Time Series.
2. Dans la boîte de dialogue Add Time Series, ajoutez des métadonnées pour la série temporelle, telles que le nom de la métrique et la source de données.
  
  Dans cet exemple, définissez le paramètre Metric Name sur car_tsdata, sélectionnez une Data Source et, dans la section Tag, ajoutez une condition de filtre où la clé est car_model, l'opérateur est = et la valeur est model_A. Cliquez ensuite sur Add.
3. Cliquez sur Add.
Insérez des données.
1. Dans la colonne Actions de la série temporelle que vous souhaitez gérer, cliquez sur Query Data.
2. Cliquez sur Insert Data.
  
  Le système obtient automatiquement les métadonnées de la série temporelle sélectionnée.
3. Dans la boîte de dialogue Insert Data, définissez les colonnes de temps et d'attributs.
  
  Définissez le nom de la métrique sur car_tsdata. Ajoutez un tag dont la clé est car_model et la valeur est model_A. Définissez l'heure sur February 5, 2025, 00:00:00. Les colonnes d'attributs requises incluent : vin_id (chaîne), model (chaîne, valeur model_A), speed (double, valeur 75.90), gps (chaîne, valeur 30.23,52.78), current_mileage (double, valeur 10), remaining_oil (double, valeur 20), available_mileage (double, valeur 198) et tire_pressure (double, valeur 2.4). Une fois les paramètres configurés, cliquez sur OK.
4. Cliquez sur OK.

Étape 3 : Interroger les données de séries temporelles

Interrogez les données d'une série temporelle dans une plage de temps spécifiée.

Pour interroger les données d'une table à l'aide de SQL, consultez la section Interrogation des données de séries temporelles à l'aide de SQL .

Si vous ne connaissez pas les informations de la série temporelle à interroger, vous pouvez récupérer des séries temporelles en spécifiant plusieurs conditions. Pour plus d'informations, consultez la section Récupération de séries temporelles .

Sous l'onglet Query Data de la table de séries temporelles, recherchez la série temporelle que vous souhaitez interroger et cliquez sur Query Data dans la colonne Actions.
Définissez les conditions de requête.
1. Par défaut, les résultats de la requête sont triés par ordre chronologique croissant. Pour interroger les données par ordre chronologique décroissant, définissez le paramètre Reverse Chronological Order sur Yes.
2. Sélectionnez une méthode de requête et spécifiez une plage de temps.
Cliquez sur Query.

Les données correspondant aux conditions de requête s'affichent sous l'onglet Query Data. Les résultats de la requête peuvent être affichés sous forme de liste ou de graphique.

Utilisation d'un index Lastpoint

Un index Lastpoint vous permet de récupérer rapidement le dernier point de données pour chaque série temporelle d'une table de séries temporelles.

Accédez à la page Instance Management.
1. Connectez-vous à la console Tablestore.
2. Dans la barre de navigation supérieure, sélectionnez un groupe de ressources et une région.
3. Sur la page Overview, cliquez sur le nom de l'instance ou sur Manage Instance dans la colonne Actions de l'instance.
Accédez à la page de gestion de la table de séries temporelles.
1. Sous l'onglet Instance Details, cliquez sur l'onglet Time Series Tables.
2. Sous l'onglet Time Series Tables, cliquez sur le nom de la table de séries temporelles.
Créez un index Lastpoint.
1. Sous l'onglet Basic Information de la page de gestion de la table de séries temporelles, cliquez sur Create Lastpoint Index.
2. Dans la boîte de dialogue Create Lastpoint Index, définissez le nom de l'index Lastpoint et le mode de synchronisation.
  
  Par exemple, définissez le paramètre Lastpoint Index Name sur lastpoint_car_example, définissez le paramètre Synchronization Mode sur Full Synchronization, puis cliquez sur Create.
3. Cliquez sur Create.
Interrogez les données à l'aide de l'index Lastpoint.
1. Dans la colonne Actions de l'index Lastpoint, cliquez sur Query.
2. Dans la boîte de dialogue Search, définissez le paramètre Mode sur Range Search et conservez les paramètres par défaut pour les autres options.
  
  Par défaut, les valeurs de clé primaire de début pour _#h , _m_name , _data_source et _tags sont définies sur la valeur minimale, et les valeurs de clé primaire de fin sont définies sur la valeur maximale.
3. Cliquez sur Query.
  
  Les données correspondant aux conditions de requête s'affichent dans la section Lastpoint Index sous l'onglet Basic Information.

Récupération de séries temporelles

Si vous ne connaissez pas le nom exact de la métrique ou la source de données d'une série temporelle, vous pouvez la rechercher en spécifiant plusieurs conditions.

Sous l'onglet Query Data de la table de séries temporelles, cliquez sur Query Time Series dans le coin supérieur droit.
Dans la boîte de dialogue Query Data, saisissez le nom de la métrique ou la source de données de la série temporelle, puis cliquez sur Add pour spécifier les conditions de correspondance pour les tags, les attributs ou l'heure de mise à jour.

La condition de cet exemple sert à interroger toutes les séries temporelles contenant le tag car_model=model_A.
Cliquez sur OK.

Les données correspondant aux conditions de requête s'affichent sous l'onglet Query Data.

Scénario d'exemple

Dans un scénario IoV (Internet of Vehicles), les véhicules utilisent des capteurs pour envoyer des données de séries temporelles vers le cloud. Le stockage, l'interrogation et l'analyse de ces données permettent des fonctionnalités métier telles que les rapports sur l'état des véhicules, la localisation des véhicules, la gestion du trafic et la projection de trajectoires. Cette rubrique utilise une table de séries temporelles dans un scénario IoV comme exemple pour décrire comment créer une table de séries temporelles et effectuer des opérations de lecture et d'écriture. La table de séries temporelles stocke les données de trajectoire des véhicules.

Parameter

Type

Description

_m_name

String

Le nom de la métrique, qui indique la quantité physique ou la métrique de surveillance mesurée par les données de séries temporelles.

_data_source

String

L'identifiant de la source de données qui génère la série temporelle. Ce champ peut être laissé vide.

_tags

String

Tags pour la série temporelle, définis sous la forme d'une ou plusieurs paires clé-valeur de type chaîne.

_time

Integer

L'heure à laquelle les données sont signalées.

vin_id

String

Le numéro d'identification unique du véhicule (VIN).

model

String

Le modèle du véhicule.

speed

Double

La vitesse actuelle.

gps

String

Les coordonnées GPS du véhicule, au format latitude,longitude. La latitude doit être une valeur comprise entre -90 et 90, et la longitude doit être une valeur comprise entre -180 et 180. Par exemple, 30.23,52.78.

current_mileage

Double

Le kilométrage actuel.

remaining_oil

Double

Le carburant restant.

available_mileage

Double

La distance restante pouvant être parcourue.

tire_pressure

Double

Les données de pression des pneus.

Documents connexes

Pour plus d'informations sur les index Lastpoint, consultez la section Index Lastpoint.