Use the TimeSeries model from the console - Tablestore - Centro de documentación de Alibaba Cloud

El modelo TimeSeries está diseñado para datos de series temporales. Por ello, resulta ideal para escenarios como el monitoreo de dispositivos del Internet de las cosas (IoT), la recopilación de datos de dispositivos y el monitoreo de máquinas. Este modelo ofrece escrituras y consultas de alta concurrencia, además de almacenamiento de bajo costo para petabytes de datos. En este tema se explica cómo usar el modelo TimeSeries en la consola de Tablestore.

Importante

Para usar el modelo TimeSeries con una herramienta de línea de comandos, consulte Use the TimeSeries model with a command-line tool.

Notas

El modelo TimeSeries es compatible con las siguientes regiones: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Chengdu), China (Hong Kong), Japan (Tokyo), Malaysia (Kuala Lumpur), Germany (Frankfurt), Indonesia (Jakarta), UK (London), US (Silicon Valley), US (Virginia), SAU (Riyadh - Partner Region), y Singapore.

Funciones como el índice Lastpoint, el almacenamiento de análisis de series temporales, los identificadores personalizados de series temporales y los campos de datos como claves primarias solo están disponibles en las regiones China (Hangzhou), China (Shanghai), China (Beijing) y China (Zhangjiakou). Para utilizar estas funciones, cree su instancia en alguna de estas regiones.

Requisitos previos

Activó el servicio Tablestore. Para obtener más información, consulte Activate Tablestore.
Creó una instancia del modelo TimeSeries.
1. Inicie sesión en la consola de Tablestore.
2. En la barra de navegación superior, seleccione un resource group y una región.
3. En la página Overview, haga clic en Create Instance for TimeSeries Model.
4. En el cuadro de diálogo Create Instance for TimeSeries Model, seleccione una especificación de instancia, introduzca un nombre de instancia y agregue una descripción de la instancia.
5. Haga clic en OK.

Procedimiento

Paso 1: Crear una tabla de series temporales

Cree una tabla de series temporales para almacenar datos de series temporales.

Para obtener información sobre el escenario de ejemplo y el esquema de la tabla, consulte Sample scenario .

Vaya a la página Instance Management.
1. Inicie sesión en la consola de Tablestore.
2. En la barra de navegación superior, seleccione un resource group y una región.
3. En la página Overview, haga clic en el nombre de la instancia o en Manage Instance dentro de la columna Actions de la instancia.
En la pestaña Instance Details, haga clic en la pestaña Time Series Tables.
En la pestaña Time Series Tables, haga clic en Create Time Series Table.

Nota
También puede hacer clic en Generate Demo with One Click para crear una tabla de ejemplo con datos de muestra y probar rápidamente las funciones. Es posible que transcurran algunos segundos antes de que aparezca una nueva serie temporal, ya que el sistema inicializa la tabla de ejemplo.
En el cuadro de diálogo Create Time Series Table, establezca Time Series Table Name como car_example y conserve la configuración predeterminada de los demás parámetros.
Haga clic en Create.

Una vez creada la tabla de series temporales, podrá consultarla en la pestaña Time Series Tables. Si la nueva tabla no aparece en la lista, haga clic en el icono para actualizar la lista de tablas de series temporales.

Paso 2: Escribir datos

Escriba datos en la tabla de series temporales. Los datos de series temporales se componen de metadatos y puntos de datos. Si no crea los metadatos de antemano, el sistema los extrae automáticamente de los datos que escriba.

En la pestaña Time Series Tables, haga clic en el nombre de la tabla de series temporales y luego en la pestaña Query Data. También puede hacer clic en Manage Data dentro de la columna Actions de la tabla de series temporales.
(Opcional) Cree una serie temporal.
1. En la pestaña Query Data, haga clic en Add Time Series.
2. En el cuadro de diálogo Add Time Series, agregue metadatos para la serie temporal, como el nombre de la métrica y el origen de datos.
  
  En este ejemplo, establezca Metric Name como car_tsdata, seleccione un Data Source y, en la sección Tag, agregue una condición de filtro donde la clave sea car_model, el operador sea = y el valor sea model_A. Luego, haga clic en Add.
3. Haga clic en Add.
Inserte datos.
1. En la columna Actions de la serie temporal que desea gestionar, haga clic en Query Data.
2. Haga clic en Insert Data.
  
  El sistema obtiene automáticamente los metadatos de la serie temporal seleccionada.
3. En el cuadro de diálogo Insert Data, configure la hora y las columnas de atributos.
  
  Establezca el nombre de la métrica como car_tsdata. Agregue una etiqueta cuya clave sea car_model y cuyo valor sea model_A. Establezca la hora como February 5, 2025, 00:00:00. Las columnas de atributos obligatorias incluyen: vin_id (cadena), model (cadena, valor model_A), speed (double, valor 75.90), gps (cadena, valor 30.23,52.78), current_mileage (double, valor 10), remaining_oil (double, valor 20), available_mileage (double, valor 198) y tire_pressure (double, valor 2.4). Después de configurar los parámetros, haga clic en OK.
4. Haga clic en OK.

Paso 3: Consultar datos de series temporales

Consulte los datos de una serie temporal dentro de un intervalo de tiempo específico.

Para consultar datos de una tabla mediante SQL, consulte Query time series data by using SQL .

Si no conoce con certeza la información de la serie temporal que desea consultar, puede recuperar series temporales si especifica varias condiciones. Para obtener más información, consulte Retrieve time series .

En la pestaña Query Data de la tabla de series temporales, busque la serie temporal que desea consultar y haga clic en Query Data dentro de la columna Actions.
Configure las condiciones de consulta.
1. De forma predeterminada, los resultados de la consulta se ordenan por hora en sentido ascendente. Para consultar los datos en orden descendente, establezca Reverse Chronological Order como Yes.
2. Seleccione un método de consulta y especifique un intervalo de tiempo.
Haga clic en Query.

Los datos que cumplen las condiciones de consulta se muestran en la pestaña Query Data. Los resultados de la consulta pueden mostrarse en una lista o en un gráfico.

Usar un índice Lastpoint

Un índice Lastpoint le permite recuperar rápidamente el punto de datos más reciente de cada serie temporal en una tabla de series temporales.

Vaya a la página Instance Management.
1. Inicie sesión en la consola de Tablestore.
2. En la barra de navegación superior, seleccione un resource group y una región.
3. En la página Overview, haga clic en el nombre de la instancia o en Manage Instance dentro de la columna Actions de la instancia.
Vaya a la página de administración de la tabla de series temporales.
1. En la pestaña Instance Details, haga clic en la pestaña Time Series Tables.
2. En la pestaña Time Series Tables, haga clic en el nombre de la tabla de series temporales.
Cree un índice Lastpoint.
1. En la pestaña Basic Information de la página de administración de la tabla de series temporales, haga clic en Create Lastpoint Index.
2. En el cuadro de diálogo Create Lastpoint Index, configure el nombre del índice Lastpoint y el modo de sincronización.
  
  Por ejemplo, establezca Lastpoint Index Name como lastpoint_car_example, configure Synchronization Mode como Full Synchronization y luego haga clic en Create.
3. Haga clic en Create.
Consulte datos mediante el índice Lastpoint.
1. En la columna Actions del índice Lastpoint, haga clic en Query.
2. En el cuadro de diálogo Search, establezca Mode como Range Search y conserve la configuración predeterminada de los demás parámetros.
  
  De forma predeterminada, los valores de clave primaria iniciales para _#h , _m_name , _data_source y _tags se configuran con el valor mínimo, mientras que los valores de clave primaria finales se configuran con el valor máximo.
3. Haga clic en Query.
  
  Los datos que cumplen las condiciones de consulta se muestran en la sección Lastpoint Index de la pestaña Basic Information.

Recuperar series temporales

Si no conoce con exactitud el nombre de la métrica o el origen de datos de una serie temporal, puede buscarla si especifica varias condiciones.

En la pestaña Query Data de la tabla de series temporales, haga clic en Query Time Series en la esquina superior derecha.
En el cuadro de diálogo Query Data, introduzca el nombre de la métrica o el origen de datos de la serie temporal y luego haga clic en Add para especificar condiciones de coincidencia para etiquetas, atributos u hora de actualización.

La condición de este ejemplo sirve para consultar todas las series temporales que contienen la etiqueta car_model=model_A.
Haga clic en OK.

Los datos que cumplen las condiciones de consulta se muestran en la pestaña Query Data.

Escenario de ejemplo

En un escenario del Internet de los vehículos (IoV), los vehículos usan sensores para reportar datos de series temporales a la nube. Almacenar, consultar y analizar estos datos habilita funciones de negocio como reportes de estado del vehículo, localización de vehículos, gestión del tráfico y proyección de trayectorias. En este tema se utiliza como ejemplo una tabla de series temporales en un escenario IoV para explicar cómo crear una tabla de series temporales y ejecutar operaciones de lectura y escritura. La tabla de series temporales almacena datos de trayectoria de vehículos.

Parámetro	Tipo	Descripción
_m_name	Cadena	El nombre de la métrica, que indica la magnitud física o la métrica de monitoreo medida por los datos de la serie temporal.
_data_source	Cadena	El identificador del origen de datos que genera la serie temporal. Este campo puede dejarse vacío.
_tags	Cadena	Las etiquetas de la serie temporal, definidas como uno o varios pares clave-valor de tipo cadena.
_time	Entero	La hora en la que se reportan los datos.
vin_id	Cadena	El número de identificación vehicular (VIN) único.
model	Cadena	El modelo del vehículo.
speed	Double	La velocidad actual.
gps	Cadena	Las coordenadas GPS del vehículo, con el formato `latitude,longitude`. La latitud debe ser un valor de -90 a 90, y la longitud debe ser un valor de -180 a 180. Por ejemplo, `30.23,52.78`.
current_mileage	Double	El kilometraje actual.
remaining_oil	Double	El combustible restante.
available_mileage	Double	La distancia restante que se puede recorrer.
tire_pressure	Double	Los datos de presión de los neumáticos.

Documentos relacionados

Para obtener más información sobre los índices Lastpoint, consulte Lastpoint index.