Hágale una pregunta a sus datos

Qué va a construirCopiar el enlace

Tres consultas SQL sobre una tabla real: un vistazo a las filas, un conteo y un resumen agrupado que responde una pregunta de negocio. Además, cómo leer resultados grandes y qué hacer cuando se rechaza una consulta.

Los ejemplos usan una tabla orders con las columnas order_id, customer, amount y created_at. Use los nombres de su propia tabla.

Antes de empezarCopiar el enlace

• Una tabla en Nexus. Si no tiene, siga primero Convierta una hoja de cálculo en tabla.
• Acceso para leer esa tabla. Los propietarios y administradores leen todo; los miembros necesitan Leer sus datos en Acceso a datos.
• Para desarrolladores: el SDK instalado y una clave de API. Vea el Inicio rápido.

PasosCopiar el enlace

Abra el Editor SQLCopiar el enlace

Vaya a DatosEditor SQL. El panel lateral muestra sus esquemas y tablas, con un buscador. Haga clic en un nombre para insertarlo, o parta de una consulta lista para ver filas o contarlas.

Mire las filasCopiar el enlace

Copiar el texto

SELECT * FROM orders LIMIT 100

Seleccione Ejecutar o pulse Cmd Enter (Ctrl Enter en Windows). Las filas aparecen debajo, con el número de filas.

CuéntelasCopiar el enlace

Copiar el texto

SELECT COUNT(*) AS orders FROM orders

Responda una preguntaCopiar el enlace

¿Qué clientes gastaron más el mes pasado?

Copiar el texto

SELECT customer, SUM(amount) AS total
FROM orders
WHERE created_at >= DATE '2026-10-01' AND created_at < DATE '2026-11-01'
GROUP BY customer
ORDER BY total DESC
LIMIT 10

Vea el costo antes de ejecutarCopiar el enlace

El editor muestra cuántos datos lee la consulta y avisa antes de ejecutar una que su plan no permite. Acótela con un WHERE sobre una fecha o una clave.

from klarety import Nexus

nx = Nexus.connect()  # reads KLARETY_API_KEY

result = nx.sql("SELECT * FROM orders LIMIT 100")
print(len(result), "rows, read", result.bytes_scanned, "bytes")
for row in result.rows[:5]:
    print(row)

top = nx.sql(
    """
    SELECT customer, SUM(amount) AS total
    FROM orders
    WHERE created_at >= CAST(:start AS DATE) AND created_at < CAST(:end AS DATE)
    GROUP BY customer
    ORDER BY total DESC
    LIMIT 10
    """,
    params={"start": "2026-10-01", "end": "2026-11-01"},
)
print(top.rows)

print(nx.estimate("SELECT * FROM orders"))

result = nx.sql("SELECT * FROM orders", max_rows=10000)
if result.truncated:
    for row in nx.result_rows(result):
        ...

Compruebe que funcionóCopiar el enlace

• El conteo coincide con el número de filas que espera en la tabla.
• La consulta agrupada devuelve como mucho diez filas, el total mayor primero.
• Desde código, result.rows es una lista de diccionarios con el nombre de cada columna.

Si algo sale malCopiar el enlace

Siguientes pasosCopiar el enlace

• Editor SQL: todo lo que hace el editor.
• SQL desde código: parámetros, paginación y errores a fondo.
• Envíe un informe diario: que un agente ejecute una consulta así cada mañana.