Visualize Tablestore data with DataV - Tablestore - Centro de documentación de Alibaba Cloud

Después de agregar un origen de datos de Tablestore en la consola de DataV, puede visualizar los datos de Tablestore con DataV.

Requisitos previos

Complete las siguientes operaciones en la consola de Resource Access Management (RAM):
- Cree un usuario de RAM y otórguele permisos para gestionar Tablestore (AliyunOTSFullAccess) y DataV (AliyunDataVFullAccess). Para obtener más información, consulte Create a RAM user y Grant permissions to a RAM user.
  
  Aviso
  La filtración del par de AccessKey de su cuenta de Alibaba Cloud puede comprometer todos sus recursos. Para reducir este riesgo, utilice el par de AccessKey de un usuario de RAM para realizar las operaciones.
- Cree un par de AccessKey para el usuario de RAM. Para obtener más información, consulte Create an AccessKey pair.
Complete las siguientes operaciones en la consola de Tablestore:
- Active Tablestore y cree una instancia. Para obtener más información, consulte Activate Tablestore and create an instance.
- Cree una tabla de datos. Para obtener más información, consulte Data table operations.
Complete la siguiente operación en la consola de DataV:

Active DataV. Para obtener más información, consulte Activate DataV.

Contexto

DataV es una herramienta de visualización de datos que convierte datos sin procesar en gráficos dinámicos e interactivos. Para obtener más información, consulte What is DataV?. Una vez que conecte sus datos de Tablestore a DataV, podrá crear un panel para mostrarlos en tiempo real.

Notas

Esta función solo aplica al modelo de columna ancha. Para obtener más información, consulte Wide column model.
DataV solo admite tablas de datos y tablas de índice secundario de Tablestore como orígenes de datos.

Paso 1: Agregar un origen de datos de Tablestore

Inicie sesión en la consola de DataV.

En la pestaña Data Sources, seleccione Data Sources y luego haga clic en Add Source.
En la lista Type, seleccione TableStore.

Introduzca los valores de Name, AccessKey ID, AccessKey Secret y Public endpoint, y luego haga clic en OK.

Configure los parámetros del origen de datos de Tablestore. Para obtener más información, consulte la siguiente tabla.

Parámetro	Descripción
Name	El nombre para mostrar del origen de datos.
AccessKey ID	El AccessKey ID de la cuenta de Alibaba Cloud o del usuario de RAM que tiene permisos para acceder a Tablestore.
AccessKey Secret	El AccessKey Secret de la cuenta de Alibaba Cloud o del usuario de RAM que tiene permisos para acceder a Tablestore.
Public endpoint	El endpoint de la instancia de Tablestore a la que desea acceder. Para obtener más información, consulte Endpoints.

Haga clic en OK.

DataV agrega automáticamente el origen de datos a su lista de orígenes de datos.

Paso 2: Configurar el origen de datos de Tablestore

Inicie sesión en la consola de DataV.

En la página Projects, cree un proyecto de visualización o seleccione uno existente.
- Para usar un proyecto de visualización existente, localice el proyecto y haga clic en Edit en su tarjeta para abrir el editor.
- Si es la primera vez que utiliza DataV o los proyectos existentes no satisfacen sus necesidades, cree un nuevo proyecto.
  
  Nota
  Este tema utiliza un proyecto para PC como ejemplo.
  1. Haga clic en PC.
  2. En la lista de plantillas para PC, seleccione una plantilla y haga clic en Create Project.
    
    DataV le permite crear una aplicación de visualización a partir de una plantilla o de un lienzo en blanco.
  3. En el cuadro de diálogo Create Project, introduzca un nombre y seleccione un grupo para su proyecto de visualización. Luego, haga clic en Create.

Configure el origen de datos de Tablestore.

En la página del editor de lienzo, haga clic en un widget del lienzo.

Nota
Si no hay widgets en el lienzo, agregue uno primero. Para obtener más información, consulte Asset management (Enterprise Edition).
En el panel de configuración del widget a la derecha, haga clic en el icono Data.
En la pestaña Data, haga clic en Configure Data Source.
En la sección Set Data Source, establezca Data Source Type como TableStore.
En la lista Select an Existing Data Source, elija su origen de datos de Tablestore.
En la lista Select Action, seleccione una operación.
Se admiten las siguientes operaciones:
- getRow: corresponde a la API GetRow de Tablestore. Para obtener más información, consulte GetRow API reference.
- getRange: corresponde a la API GetRange de Tablestore. Para obtener más información, consulte GetRange API reference.
- SQL: una operación de consulta SQL.

En el editor Select Action, introduzca una consulta.

`getRow`

Los parámetros de consulta deben ser un objeto JSON.

La operación getRow lee una sola fila de datos según su clave principal.

A continuación se muestra el formato de los parámetros en un código de ejemplo.

{
    "table_name": "test",
    "rows": {
        "id": 1,
        "pk": "1",
    },
    "columns": [
        "id",
        "pk",
        "test"
    ]
}

Parámetro	Descripción
table_name	El nombre de la tabla que se va a consultar.
rows	La clave principal de la fila. Importante Si la tabla tiene varias columnas de clave principal, la cantidad y los tipos de datos de las columnas que especifique deben coincidir con los de la tabla de datos.
columns	Los nombres de las columnas que se van a devolver.

`getRange`

Los parámetros de consulta deben ser un objeto JSON.

La operación getRange lee datos dentro de un rango de claves principales especificado. A continuación se muestra el formato de los parámetros en un código de ejemplo.

{
    "table_name": "test",
    "direction": "FORWARD",
    "columns": [
        "id",
        "test"
    ],
    "range": {
        "limit": 4,
        "start": {
            "id": "InfMin"
        },
        "end": {
            "id": "3"
        }
    }
}

Parámetro	Descripción
`table_name`	El nombre de la tabla que se va a consultar.
`direction`	La dirección en la que se leerán las filas. FORWARD: La clave inicial debe ser menor que la clave final. Las filas devueltas se ordenan de forma ascendente según la clave principal. BACKWARD: La clave inicial debe ser mayor que la clave final. Las filas devueltas se ordenan de forma descendente según la clave principal. Por ejemplo, suponga que una tabla contiene dos valores de clave principal, A y B, donde A es menor que B. Si realiza una lectura ascendente desde [A, B), se devuelven las filas cuya clave principal sea mayor o igual que A y menor que B. Si realiza una lectura descendente desde [B, A), se devuelven las filas cuya clave principal sea mayor que A y menor o igual que B.
`columns`	Las columnas que se van a leer. Los nombres de columna pueden corresponder a columnas de clave principal o a columnas de atributos. Si no especifica ninguna columna, Tablestore devuelve la fila completa. Si la clave principal de una fila está dentro del rango de lectura, pero la fila no contiene las columnas especificadas, el resultado no incluirá dicha fila.
`limit`	El número máximo de filas que se van a devolver. Este valor debe ser mayor que 0. Tablestore detiene la operación después de devolver el número máximo de filas especificado, incluso si existen más datos dentro del rango.
`start`	Las claves principales inicial y final para la lectura por rango. Ambas claves deben ser claves principales válidas o puntos virtuales compuestos por InfMin e InfMax. La cantidad de columnas en los puntos virtuales debe coincidir con la cantidad de columnas de clave principal. InfMin representa infinito negativo y es menor que cualquier otro valor. InfMax representa infinito positivo y es mayor que cualquier otro valor. Importante Si la tabla tiene varias columnas de clave principal, la cantidad y los tipos de datos de las columnas que especifique deben coincidir con los de la tabla de datos. start: La clave principal inicial. Si esta fila existe, el resultado la incluye. end: La clave principal final. El resultado nunca incluye esta fila, independientemente de si existe o no.
`end`

`SQL`

Consulte los datos mediante instrucciones SQL personalizadas.

Haga clic en Preview Data Response para consultar los datos devueltos.

Obtenga una vista previa y publique el panel.
1. En la esquina superior derecha del editor de lienzo, haga clic en el icono para obtener una vista previa de la aplicación de visualización.
2. En la esquina superior derecha del editor de lienzo, haga clic en el icono para publicar el panel.
  1. En el cuadro de diálogo Publish, haga clic en Publish Project.
  2. Cierre el cuadro de diálogo Published.
    
    Nota
    Después de la publicación, el contenido queda bloqueado. Puede utilizar la gestión de instantáneas para actualizar rápidamente el contenido publicado con sus ediciones más recientes. También puede hacer clic en Manage Snapshots para consultar las instantáneas creadas.
  3. Haga clic en el icono de copia junto a Sharing URL.
    
    Esta opción se encuentra en la pestaña Sharing URL del panel Publish. El formato del enlace es https://datav.aliyuncs.com/share/xxx.
  4. Abra un navegador y pegue el enlace copiado en la barra de direcciones para consultar el panel publicado en línea.

Facturación

Tablestore

Tablestore utiliza un método de facturación postpago de tipo pay-as-you-go. Se le cobra por hora según los recursos que utilice después de crear una tabla. Para obtener más información, consulte Billing overview.

DataV

DataV se factura bajo el modelo de subscription, con un período mínimo de compra de un mes. Usted puede elegir la edición y la duración de la suscripción. Para obtener más información, consulte Pricing.

Preguntas frecuentes

Why does the GetRange operation return data that is outside the specified range?

Documentos relacionados

También puede utilizar Grafana para visualizar datos. Conéctese a Grafana si necesita mostrar datos de una tabla de series temporales en un modelo TimeSeries. Para obtener más información, consulte Connect to Grafana.