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.

Obtener filas

Puedes obtener una fila individual o múltiples filas de datos de una tabla en Catalyst Data Store. Puedes obtener las filas pasando el Table ID único de la tabla al método getTable() como se muestra en el código de ejemplo a continuación.

Obtener una fila individual

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

Primero debes obtener una instancia de objeto base usando getInstance(). Usando la instancia del objeto base, debes obtener una instancia de tabla que se pueda usar para obtener la fila.

Fragmento de código de ejemplo


Package Imports
copy
import com.zc.component.object.ZCObject; 
import com.zc.component.object.ZCRowObject;
import com.zc.component.object.ZCTable; 
copy
//Crear una instancia del objeto base ZCObject
ZCObject obj = ZCObject.getInstance(); 
//Obtener una instancia de tabla referenciando el ID de tabla usando el objeto base 
ZCTable tab = obj.getTable(1510000000110121L); 
//Obtener una fila individual de la tabla pasando el Row ID 
ZCRowObject row = tab.getRow(1510000000108103L);

Obtener todas las filas mediante paginación

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

Por ejemplo, si necesitas que las filas se obtengan en lotes de 100 como páginas individuales, puedes definir una variable para el número 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 al SDK devolverá 200 filas en una sola página de forma predeterminada si no se especifica este valor.

Adicionalmente, después de cada ejecución del bucle, recibirás una cadena de token en la respuesta que autoriza la obtención subsiguiente de datos. Puedes obtener este token a través del método getNextToken(), y pasarlo como valor para nextToken durante la iteración subsiguiente, 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 null.

Esta iteración se ejecuta hasta que se obtienen todas las filas, lo cual se valida mediante el método moreRecordsAvailable().

Puedes especificar el nombre de la tabla y los nombres de las columnas a obtener como se muestra en el código de ejemplo.

Nota: La paginación está disponible desde la actualización Java SDK v1.7.0. No estará disponible en las versiones anteriores de Java SDK.

Fragmento de código de ejemplo


Package Imports
copy
import com.zc.component.object.ZCObject; 
import com.zc.component.object.ZCRowObject;
import com.zc.component.object.ZCRowPagedResponse;  
copy
String nextToken = null; 
//Declarar el valor de nextToken como null para la primera
iteration ZCRowPagedResponse pagedResp; 
//Definir el objeto de respuesta paginada 
Long maxRows = 100; 
//Definir el máximo de filas a obtener en una sola página 
do
{ 
pagedResp = ZCObject.getInstance().getTable(empDetails).getPagedRows(nextToken,
maxRows); 
//Especificar el nombre de la tabla y obtener la respuesta paginada pasando nextToken y maxRows 
//Obtener las columnas de la tabla pasando los nombres de columna 
for(ZCRowObject row : pagedResp.getRows())
{ 
basicIO.write("Employee ID: " +row.get("empID") + ","); 
basicIO.write("Name: " +row.get("empName") + ","); 
basicIO.write("Department: " +row.get("empDept") + ","); } 
//Validar la iteración y pasar la cadena de token obtenida en la respuesta para la siguiente iteración 
if(pagedResp.moreRecordsAvailable())
{ 
nextToken = pagedResp.getNextToken(); 
}
}
while(pagedResp.moreRecordsAvailable());
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 está ahora disponible como una mejora que te permite obtener todas las filas, sin limitaciones en el número de filas obtenidas. El método getAllRows() será eliminado 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