Aviso:

Para brindarle información de soporte completa de manera más rápida, el contenido de esta página ha sido traducido al español mediante traducción automática. Para consultar la información de soporte más precisa, consulte la versión en inglés de este contenido.

Get Rows

Puedes obtener una fila individual o múltiples filas de datos de una tabla en Catalyst Data Store. La referencia table utilizada en estos fragmentos de código puede ser una instancia de tabla o el metadato de tabla.

Obtener una sola fila

Puedes obtener una fila individual de una tabla usando el método getRow(). Debes pasar el Row ID único de la fila a este método como se muestra en el código de ejemplo a continuación.

La promesa retornada aquí se resolverá en un objeto JSON de fila.

copy
 //Usar la instancia de la tabla o el objeto de metadatos de la tabla para obtener una fila pasando el ID de fila 
let rowPromise = table.getRow(1510000000109476);

A continuación se muestra una respuesta de ejemplo. La respuesta es la misma para ambas versiones de Node.js.

copy
{ 
CREATORID: "2136000000006003", 
MODIFIEDTIME: "2021-08-17 13:02:11:184", 
CREATEDTIME: "2021-08-16
16:29:10:499", 
CityName: "Pune", 
ROWID: "2136000000011011" 
}

Obtener todas las filas mediante paginación

Puedes obtener todas las filas de datos de una tabla en Data Store incorporando paginación en tu código usando la función getMyPagedRows(). La paginación te permite obtener las filas de una tabla en lotes o páginas a través de iteraciones.

Esta iteración se ejecuta hasta que se obtienen todas las filas, lo cual se valida mediante hasNext,como se muestra en el código a continuación. Puedes hacer referencia a la tabla por su Table ID único.

Por ejemplo, si necesitas que las filas se obtengan en lotes de 100 como páginas individuales, puedes definir una variable para el máximo de filas a obtener en cada página y especificar la cantidad. El código de ejemplo a continuación asigna maxRows como 100.

Nota: El parámetro maxRows es opcional. La llamada del SDK retornará 200 filas en una sola página por defecto si no se especifica este valor.

Además, después de cada ejecución del bucle, recibirás una cadena de token en los datos de respuesta que autoriza la obtención subsecuente de datos. Puedes obtener este token a través de next_token, y pasarlo como valor para nextToken durante la iteración subsecuente, como se muestra en el código a continuación. Durante la primera ejecución del bucle, el valor para la cadena nextToken se asigna como undefined. El siguiente conjunto de registros se obtiene a través de more_records en los datos de respuesta.

Nota: La paginación está disponible desde la actualización del SDK de Node.js v2.1.0. No estará disponible en las versiones anteriores del SDK de Node.js.
copy
//Obtener filas mediante paginación y declarar el valor de nextToken como undefined en la primera iteración function
getMyPagedRows(hasNext = true, nextToken = undefined) 
{ 
if (!hasNext) 
{ 
return; 
} 
dataStore.table(195000000042025)
//Especificar el Table ID de la tabla de la cual obtener los registros 
.getPagedRows({ nextToken, maxRows: 100 }) 
//Definir el máximo de filas a obtener en una sola página and pass it along with nextToken 
.then(({ data, next_token, more_records
}) => { console.log('rows : ', data); 
//Obtener las filas de la tabla 
return getMyPagedRows(more_records, next_token);
//Obtener el siguiente conjunto de registros y la cadena de token para la siguiente iteración 
}) .catch((err) => {
console.log(err.toString()); }); 
}

A continuación se muestra una respuesta de ejemplo que recibirás si hay más registros disponibles. El parámetro more_records se establecerá en true en este caso.

Node.js v2.1.0

copy
{
    "status": 200,
    "data": [
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:24:855",
            "name": "Alex Jones",
            "CREATEDTIME": "2022-01-11 18:18:24:855",
            "ROWID": "3359000000108111"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:25:117",
            "name": "Robert Neal",
            "CREATEDTIME": "2022-01-11 18:18:25:117",
            "ROWID": "3359000000108114"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:25:120",
            "name": "Roslyn Gunn",
            "CREATEDTIME": "2022-01-11 18:18:25:120",
            "ROWID": "3359000000108117"
        }
    ],
    "message": "OK",
    "more_records": true,
    "next_token": "{{token}}"
}

A continuación se muestra una respuesta de ejemplo que recibirás si no hay más registros disponibles. El parámetro more_records se establecerá en false en este caso.

Node.js v2.1.0

copy
{
    "status": 200,
    "data": [
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:556",
            "name": "Alex Jones",
            "CREATEDTIME": "2022-01-11 18:18:43:556",
            "ROWID": "3359000000108410"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:557",
            "name": "Robert Neal",
            "CREATEDTIME": "2022-01-11 18:18:43:557",
            "ROWID": "3359000000108413"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:568",
            "name": "Roslyn Gunn",
            "CREATEDTIME": "2022-01-11 18:18:43:568",
            "ROWID": "3359000000108417"
        }
    ],
    "message": "OK",
    "more_records": false
}
Nota: Hemos dejado de dar soporte al método getAllRows() que estaba disponible anteriormente para obtener múltiples filas de datos de una tabla. La paginación ahora está disponible como una mejora que te permite obtener todas las filas sin limitaciones en la cantidad de filas obtenidas. El método getAllRows() se eliminará de todas las versiones futuras del SDK. Asegúrate de actualizar tu código en consecuencia.

Última actualización 2026-03-30 13:40:30 +0530 IST