Obtener filas

# Obtener filas
Puedes recuperar una fila individual o múltiples filas de datos de una tabla en el {{%link href="/es/cloud-scale/help/data-store/introduction" %}}Catalyst Data Store{{%/link%}}. La referencia {{%badge%}}table_service{{%/badge%}} utilizada en estos fragmentos de código puede ser una instancia de tabla o metadatos de tabla.
### Obtener una fila individual
Puedes obtener una fila individual de la tabla usando el método {{%badge%}}get_row(){{%/badge%}}. Debes pasar el RowID único de la fila a este método como se muestra en el fragmento de código a continuación. Para saber más sobre la {{%link href="/es/sdk/python/v1/cloud-scale/data-store/get-component-instance/" %}}instancia de componente{{%/link%}}{{%badge%}}datastore_service{{%/badge%}} y la {{%link href="/es/sdk/python/v1/cloud-scale/data-store/get-table-instance/" %}}instancia de tabla{{%/link%}}{{%badge%}}table_service{{%/badge%}} utilizadas a continuación, consulta sus respectivas secciones de ayuda.
**Parámetros utilizados**
<table class="content-table">
        <thead>
                <tr>
                        <th class="w20p">Nombre del parámetro</th>
            <th class="w20p">Tipo de dato</th>
            <th class="w60p">Definición</th>
                </tr>
        </thead>
        <tbody>
  <tr>
                        <td>{{%badge%}}rowID{{%/badge%}}</td>
            <td>String</td>
                        <td>Un parámetro {{%bold%}}obligatorio{{%/bold%}}. Almacenará el ID de la fila cuyos detalles deben recuperarse.</td>
                </tr>
        </tbody>
</table>
{{%code class="language-python" scroll="set-scroll" %}} # Obtener una sola fila
datastore_service = app.datastore()
table_service = datastore_service.table("CITY")
row_data = table_service.get_row(5249000000032385)
{{% /code%}} 
A continuación se muestra una respuesta de ejemplo:
{{%code class="language-javascript line-numbers" scroll="set-scroll" %}}{
  CREATORID: "2136000000006003",
  MODIFIEDTIME: "2021-08-17 13:02:11:184",
  CREATEDTIME: "2021-08-16 16:29:10:499",
  CITYNAME: "Pune",
  ROWID: "5249000000032385"
}
{{% /code%}} 
### Obtener todas las filas mediante paginación
Puedes recuperar todas las filas de datos de una tabla en el Data Store incorporando paginación en tu código usando la función {{%badge%}}get_paged_rows(){{%/badge%}}. 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 una simple condición if, como se muestra en el código a continuación. Puedes referirte a la tabla por su nombre de tabla ú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 {{%badge%}}max_rows{{%/badge%}} como 100.
{{%note%}}{{%bold%}}Note:{{%/bold%}} El parámetro {{%badge%}}maxRows{{%/badge%}} es opcional. La llamada del SDK devolverá 200 filas en una sola página por defecto si este valor no se especifica.{{%/note%}}
Adicionalmente, recibirás una cadena de token en los datos de respuesta que autoriza la obtención subsiguiente de datos. Puedes obtener este token a través de {{%badge%}}next_token{{%/badge%}}, y pasarlo como valor para {{%badge%}}next_token{{%/badge%}} 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 {{%badge%}}next_token{{%/badge%}} se asigna como None. El siguiente conjunto de registros se obtiene a través de {{%badge%}}more_records{{%/badge%}} en los datos de respuesta.
{{%note%}}{{%bold%}}Note:{{%/bold%}} La paginación está disponible desde la actualización del SDK de Node.js v2.1.0. Esto no estará disponible en las versiones anteriores del SDK de Node.js.{{%/note%}}
**Parámetros utilizados**
<table class="content-table">
        <thead>
                <tr>
                        <th class="w20p">Nombre del parámetro</th>
            <th class="w20p">Tipo de dato</th>
      <th class="w60p">Definición</th>
                </tr>
        </thead>
        <tbody>
  <tr>
                        <td>{{%badge%}}next_token{{%/badge%}}</td>
            <td>String</td>
                        <td>Un parámetro {{%bold%}}obligatorio{{%/bold%}}. Almacenará el token de los datos de respuesta, autorizando la recuperación subsiguiente de datos.</td>
                </tr>
                <tr>
                        <td>{{%badge%}}max_rows{{%/badge%}}</td>
            <td>Numeric</td>
                        <td>Un parámetro {{%bold%}}opcional{{%/bold%}}. Contendrá el número de lotes en los que se deben obtener las filas.</td>
                </tr>
        </tbody>
</table>
{{%code class="language-python" scroll="set-scroll" %}}datastore_service = app.datastore()
table_service = datastore_service.table("Aliens")
def getMyPagedRows(next_token=None, more_records=True):
    rows = table_service.get_paged_rows(next_token, max_rows=100)
    more_records = rows['more_records']
    if not more_records:
        return None
    next_token = rows['next_token']
    return getMyPagedRows(next_token, more_records)
 getMyPagedRows(){{% /code%}} 
Cuando el parámetro {{%badge%}}more_records{{%/badge%}} está establecido en true, la respuesta de ejemplo se muestra a continuación:
{{%code class="language-json line-numbers" scroll="set-scroll" %}}{
    "status": 200,
    "content": [
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:24:855",
            "CITYNAME": "New York",
            "CREATEDTIME": "2022-01-11 18:18:24:855",
            "ROWID": "5249000000032385"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:25:117",
            "CITYNAME": "Houston",
            "CREATEDTIME": "2022-01-11 18:18:25:117",
            "ROWID": "5249000000032386"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:25:120",
            "CITYNAME": "Chicago",
            "CREATEDTIME": "2022-01-11 18:18:25:120",
            "ROWID": "5249000000032387"
        }
    ],
    "message": "OK",
    "more_records": true,
    "next_token": "{{token}}"
}
{{%/code%}} 
Cuando el parámetro {{%badge%}}more_records{{%/badge%}} está establecido en false, la respuesta de ejemplo se muestra a continuación:
{{%code class="language-json line-numbers" scroll="set-scroll" %}}{
    "status": 200,
    "content": [
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:556",
            "name": "San Diego",
            "CREATEDTIME": "2022-01-11 18:18:43:556",
            "ROWID": "5249000000032385"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:557",
            "name": "Phoenix",
            "CREATEDTIME": "2022-01-11 18:18:43:557",
            "ROWID": "5249000000032386"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:568",
            "name": "Seattle",
            "CREATEDTIME": "2022-01-11 18:18:43:568",
            "ROWID": "5249000000032387"
        }
    ],
    "message": "OK",
    "more_records": false
}
{{% /code%}} 
{{%note%}}{{%bold%}}Info :{{%/bold%}} Consulta la {{%link href="/es/sdk/python/v1/sdk-scopes" %}}tabla de alcances del SDK{{%/link%}} para determinar el nivel de permiso requerido para realizar la operación anterior.{{%/note%}}

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

Obtener una fila individual

Puedes obtener una fila individual de la tabla usando el método get_row(). Debes pasar el RowID único de la fila a este método como se muestra en el fragmento de código a continuación. Para saber más sobre la instancia de componentedatastore_service y la instancia de tablatable_service utilizadas a continuación, consulta sus respectivas secciones de ayuda. Parámetros utilizados

Nombre del parámetro	Tipo de dato	Definición
rowID	String	Un parámetro obligatorio. Almacenará el ID de la fila cuyos detalles deben recuperarse.

copy

          # Obtener una sola fila
datastore_service = app.datastore()
table_service = datastore_service.table("CITY")
row_data = table_service.get_row(5249000000032385)

    

A continuación se muestra una respuesta de ejemplo:

copy

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

    

Obtener todas las filas mediante paginación

Puedes recuperar todas las filas de datos de una tabla en el Data Store incorporando paginación en tu código usando la función get_paged_rows(). 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 una simple condición if, como se muestra en el código a continuación. Puedes referirte a la tabla por su nombre de tabla ú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 max_rows como 100.

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

Adicionalmente, recibirás una cadena de token en los datos de respuesta que autoriza la obtención subsiguiente de datos. Puedes obtener este token a través de next_token, y pasarlo como valor para next_token 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 next_token se asigna como None. El siguiente conjunto de registros se obtiene a través de more_records en los datos de respuesta.

Note: La paginación está disponible desde la actualización del SDK de Node.js v2.1.0. Esto no estará disponible en las versiones anteriores del SDK de Node.js.

**Parámetros utilizados**

Nombre del parámetro	Tipo de dato	Definición
next_token	String	Un parámetro obligatorio. Almacenará el token de los datos de respuesta, autorizando la recuperación subsiguiente de datos.
max_rows	Numeric	Un parámetro opcional. Contendrá el número de lotes en los que se deben obtener las filas.

copy

         datastore_service = app.datastore()
table_service = datastore_service.table("Aliens")
def getMyPagedRows(next_token=None, more_records=True):
    rows = table_service.get_paged_rows(next_token, max_rows=100)
    more_records = rows['more_records']
    if not more_records:
        return None
    next_token = rows['next_token']
    return getMyPagedRows(next_token, more_records)
 getMyPagedRows()
    

Cuando el parámetro more_records está establecido en true, la respuesta de ejemplo se muestra a continuación:

copy

         {
    "status": 200,
    "content": [
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:24:855",
            "CITYNAME": "New York",
            "CREATEDTIME": "2022-01-11 18:18:24:855",
            "ROWID": "5249000000032385"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:25:117",
            "CITYNAME": "Houston",
            "CREATEDTIME": "2022-01-11 18:18:25:117",
            "ROWID": "5249000000032386"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:25:120",
            "CITYNAME": "Chicago",
            "CREATEDTIME": "2022-01-11 18:18:25:120",
            "ROWID": "5249000000032387"
        }
    ],
    "message": "OK",
    "more_records": true,
    "next_token": "{{token}}"
}

    

Cuando el parámetro more_records está establecido en false, la respuesta de ejemplo se muestra a continuación:

copy

         {
    "status": 200,
    "content": [
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:556",
            "name": "San Diego",
            "CREATEDTIME": "2022-01-11 18:18:43:556",
            "ROWID": "5249000000032385"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:557",
            "name": "Phoenix",
            "CREATEDTIME": "2022-01-11 18:18:43:557",
            "ROWID": "5249000000032386"
        },
        {
            "CREATORID": "3359000000006003",
            "MODIFIEDTIME": "2022-01-11 18:18:43:568",
            "name": "Seattle",
            "CREATEDTIME": "2022-01-11 18:18:43:568",
            "ROWID": "5249000000032387"
        }
    ],
    "message": "OK",
    "more_records": false
}

    

Info : Consulta la tabla de alcances del SDK para determinar el nivel de permiso requerido para realizar la operación anterior.

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

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Get Rows - API Data Store Help SDK Scopes

SDK de Python

Operaciones del SDK

Obtener filas

Obtener una fila individual

Obtener todas las filas mediante paginación