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

Obtener una fila específica

Puedes recuperar una fila específica de una tabla de Data Store de la instancia dada usando el método getRow(). Esto se hace pasando el ROWID único de la fila como argumento a este método, como se muestra en la sintaxis de código a continuación.

El <TABLE_INSTANCE> utilizado en el código a continuación es la instancia definida en la página de instancia de tabla.

copy
<TABLE_INSTANCE>.getRow(
    id: Long,
    success: (ZCatalystRow) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ZCatalystRow>>?

Parámetros:

  • id: El ROWID único de la fila particular que necesita recuperarse

A continuación se muestra un fragmento de código de ejemplo:

copy
val table = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails") //Reemplaza esto con el nombre de tu tabla
    table.getRow(2823000000014176, //Reemplazar con el ID de la fila
        {
            row -> println("Get Row Success")
            println(" The row details are: ${row.getData()}")
        },
        {
            exception ->
            println("Get row failed! $exception")
        })

Obtener filas mediante paginación

Puedes recuperar todas las filas de una tabla en Data Store incorporando paginación en tu código. 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 el número máximo de filas a obtener en cada página y especificar la cantidad usando maxRows como se muestra a continuación.

El <TABLE_INSTANCE> utilizado en los fragmentos de código a continuación es la instancia definida en la página de instancia de tabla.

copy
<TABLE_INSTANCE>.getRows(maxRows: Int, success: (List<ZCatalystRow>, ResponseInfo) -> Unit, failure: ((ZCatalystException) -> Unit)? = null): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

Parámetros:

  • maxRows: El número máximo de filas a obtener en esta iteración

A continuación se muestra un fragmento de código de ejemplo:

copy
ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").getRows( 10,
    {
           rows, info  ->{
        println("The token for next set of rows -  ${info.nextToken}")
        println("Boolean to know if there are records in next page - ${info.moreRecords}")
    } 
    },
    {
        exception -> println("Failed to get the rows! $exception")
})

Además, 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 de info.nextToken y pasarlo como valor para nextToken durante la iteración subsiguiente. Durante la primera ejecución del bucle, la cadena nextToken no se pasa.

También puedes verificar el número de filas pendientes por obtener a través de info.moreRecords como se muestra en el fragmento de código.

Puedes obtener el siguiente conjunto de filas pasando el nextToken así como maxRows si necesitas que la paginación continúe. Esto se puede hacer como se muestra a continuación.

copy
<TABLE_INSTANCE>.getRows(nextToken: String, maxRows: Int, success: (List<ZCatalystRow>, ResponseInfo) -> Unit, failure: ((ZCatalystException) -> Unit)? = null): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

Parámetros:

  • maxRows: El número máximo de filas a obtener en esta iteración
  • nextToken: El token de autorización para obtener el siguiente conjunto de filas

A continuación se muestra un fragmento de código de ejemplo:

copy
ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").getRows( "1000.6f********" , 20 ,
    {
        rows, info  ->{
        println("The token for next set of rows -  ${info.nextToken}")
        println("Boolean to know if there are records in next page - ${info.moreRecords}")
    } 
    },
    {
        exception -> println("Failed to get the rows! $exception")
})

Puedes obtener la información de nextToken y moreRecords hasta que info.moreRecords devuelva FALSE.

Si prefieres obtener todas las filas pendientes después de la primera iteración y no deseas establecer un límite de maxRows, puedes hacerlo de la siguiente manera:

copy
<TABLE_INSTANCE>.getRows(nextToken: String, success: (List<ZCatalystRow>, ResponseInfo) -> Unit, failure: ((ZCatalystException) -> Unit)? = null):  ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

Parámetros:

  • nextToken: El token de autorización para obtener el siguiente conjunto de filas

A continuación se muestra un fragmento de código de ejemplo:

copy
ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").getRows( "1000.6f********", 
    {
          rows, info  ->{
        println("The token for next set of rows -  ${info.nextToken}")
        println("Boolean to know if there are records in next page - ${info.moreRecords}")
    } 
    },
    {
        exception -> println("Failed to get the rows! $exception")
})

Esto hará que info.moreRecords devuelva FALSE.


Obtener todas las filas

Puedes recuperar todas las filas de una tabla de la instancia dada usando el método getRows(), como se muestra en la sintaxis de código a continuación. Si la operación es exitosa, este método devolverá todas las filas de la tabla sin filtros ni condiciones.

El <TABLE_INSTANCE> utilizado en la sintaxis de código a continuación es la instancia definida en la página de instancia de tabla.

copy
<TABLE_INSTANCE>.getRows(
    success: (List<ZCatalystRow>,ResponseInfo) → Unit,
    failure: ((ZCatalystException) → Unit)?= null):
): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

A continuación se muestra un fragmento de código de ejemplo:

copy
val table = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails") //Reemplaza esto con el nombre de tu tabla
        table.getRows(
            {
            rows, info  ->{
        		println("The token for next set of rows -  ${info.nextToken}")
        		println("Boolean to know if there are records in next page - ${info.moreRecords}")
    } 
    },
    {
        exception -> println("Failed to get the rows! $exception")
    })
Nota: Dado que esta es una operación para obtener todas las filas, puedes ignorar el info.nextToken. Esto devolverá todas las filas disponibles sin paginación. El info.moreRecords también devolverá FALSE si se obtuvieron todas las filas.

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