Trabajar con tablas

Vaya a Datos y abra Nexus Lakehouse. La lista muestra el Nombre, el Esquema y el número de Columnas de cada tabla; escriba en Buscar una tabla para acotarla. La página de una tabla tiene tres pestañas: Datos, Columnas e Historial.

El menú junto a una tabla también ofrece Consultar en el editor SQL o copiar su nombre.

from klarety import Nexus

with Nexus.connect() as nx:
    for table in nx.tables.list("default", search="order"):
        print(table)

    about = nx.tables.describe("orders", schema="default")
    print(about)

tables.list() lee todas las páginas de resultados. made_by="org" deja las tablas creadas fuera de cualquier proyecto, y made_by="system" las que administra Klarety.

La pestaña Datos muestra las filas. Una tabla grande muestra solo sus primeras filas y lo indica.

Seleccione Filtrar filas, elija una Columna, una Condición y un Valor, y luego Aplicar. Las condiciones son es, no es, contiene, mayor que, menor que, está vacío y no está vacío. Cada filtro es una etiqueta que puede quitar; Borrar los quita todos.

tables.rows() lee todas las filas, una página a la vez. Cada filtro se escribe column:op:value:

from klarety import Nexus

with Nexus.connect() as nx:
    for row in nx.tables.rows(
        "orders",
        where=["country:eq:CO"],
        order_by="ordered_at",
        descending=True,
    ):
        print(row)

Para traer muchas filas por clave en una sola lectura, use in: where=["order_id:in:1,2,3"].

from klarety import Nexus
from klarety.errors import ConflictError

with Nexus.connect() as nx:
    try:
        nx.tables.edit_rows(
            "orders",
            updated=[{"row": {"order_id": 3}, "values": {"amount": "75.00"}}],
            added=[{"order_id": 9, "customer": "Lucía", "country": "CO", "amount": "40.00"}],
            deleted=[{"order_id": 7}],
        )
    except ConflictError as changed:
        print("Someone changed these rows first:", changed)

Los valores se dan como texto. Una llamada acepta hasta 500 cambios, guardados juntos. Cada valor en row debe seguir igual a lo guardado; si no, no se guarda nada y ConflictError nombra cada fila cambiada: lea de nuevo y reintente. Tras un tiempo de espera agotado, reenvíe con el mismo write_id; nunca se aplica dos veces.

La pestaña Columnas lista cada columna con su tipo. Una columna que identifica una fila lleva la marca clave, y Tablas vinculadas muestra qué columnas coinciden con columnas de otras tablas. Agregar descripción escribe una línea sobre una columna, visible para quien lea la tabla.

nx.tables.set_column_doc("orders", "amount", "Order total in Colombian pesos, tax included")

Una descripción vacía la borra.

tables.expect() reemplaza las verificaciones de la tabla por la lista que envía. Una lista vacía las quita todas.

from klarety import Nexus

with Nexus.connect() as nx:
    nx.tables.expect(
        "orders",
        [
            {"column": "customer", "rule": "not_null"},
            {"column": "amount", "rule": "range", "minimum": 0},
            {"column": "status", "rule": "one_of", "values": ["paid", "refunded"]},
        ],
    )
    print(nx.tables.quality("orders"))

Una escritura que rompe una regla lanza TableRuleError, que nombra la regla. Corrija los datos en vez de reenviarlos igual.

La pestaña Historial lista cada versión, de la más reciente a la más antigua: cuántas filas se agregaron o si se actualizaron, el total de filas, quién hizo el cambio (Usted, Un compañero de equipo, Studio o Una clave de API) y cómo llegó (mediante SDK, mediante un agente, desde un Studio o importación automática). Seleccione Ver anteriores para ir más atrás.

Para deshacer, seleccione Volver a esta versión.

history = nx.tables.snapshots("orders")
authors = nx.tables.authors("orders", days=7)

snapshots() lista las versiones de la tabla; authors() muestra quién agregó y cambió filas, día a día.

Abra Más y elija Eliminar tabla. Podrá restaurarla durante un tiempo.

nx.tables.delete("orders_old")
print(nx.tables.deleted())
nx.tables.restore("orders_old")

Una tabla eliminada se puede restaurar mientras su plan conserve los elementos eliminados.