# Qué es Nexus

<Term id="nexus">Nexus</Term> es la base de datos de su <Term id="workspace">espacio de trabajo</Term>. Guarda **tablas**, que consulta con SQL, y **archivos**, que guarda en carpetas. Proyectos, agentes, apps y el SDK usan el mismo Nexus, cada uno con el acceso que usted le dio.

<TrustBadges />

## Qué guarda Nexus [#qué-guarda-nexus]

| | Qué es | Dónde lo ve |
| --- | --- | --- |
| Tablas | Filas y columnas que filtra, edita y consulta con SQL | **Datos**, **Nexus Lakehouse** |
| Archivos | Cualquier tipo de archivo, en carpetas y con todas sus versiones | **Datos**, **Almacenamiento de objetos** |
| Grafo de conocimiento | Las cosas de sus tablas y cómo se vinculan | **Datos**, **Grafo de conocimiento** |

Una hoja de cálculo subida se guarda como archivo y se puede convertir en tabla en un paso. Una carpeta puede importar cada archivo nuevo a una tabla automáticamente.

## Las tablas son tablas abiertas de Apache Iceberg [#las-tablas-son-tablas-abiertas-de-apache-iceberg]

Nexus guarda las tablas en el formato abierto <Term id="iceberg">Apache Iceberg</Term>. Eso le da:

- **Historial.** Cada cambio se guarda como una versión. Vea quién cambió qué y vuelva atrás si algo sale mal.
- **Sin dependencia.** Iceberg es un estándar abierto que leen muchas herramientas.
- **Una sola forma de trabajar.** Las tablas pequeñas y grandes se consultan, cambian y restauran igual.

El cómputo y el almacenamiento funcionan en AWS.

## Los esquemas agrupan tablas [#los-esquemas-agrupan-tablas]

Un <Term id="schema">esquema</Term> es un grupo de tablas con nombre, como `sales` o `marketing`. Todo espacio de trabajo tiene un esquema `default` que siempre existe. `sales.orders` es la tabla `orders` de `sales`; un nombre sin esquema, como `orders`, se refiere a la tabla en `default`.

Los esquemas separan áreas de trabajo y permiten dar acceso a toda un área a la vez (vea [Acceso a datos](/docs/es/data/data-access)). Un esquema solo se puede eliminar cuando no tiene tablas ni archivos.

## El motor de Nexus ejecuta sus consultas [#el-motor-de-nexus-ejecuta-sus-consultas]

Las consultas se ejecutan en el <Term id="nexus-engine">motor de Nexus</Term>, que habla **Spark SQL**: `SELECT`, joins, `GROUP BY`, funciones de ventana y el resto funcionan como espera. Cada consulta se revisa antes: solo alcanza las tablas a las que tiene acceso y solo lee la cantidad de datos que permite su plan. Puede preguntar cuánto leería una consulta antes de ejecutarla.

## Antes de empezar [#antes-de-empezar]

- **Un espacio de trabajo** del que sea miembro.
- **Acceso.** Propietarios y administradores alcanzan todo. Los miembros alcanzan todo, salvo que un administrador los limite. Vea [Acceso a datos](/docs/es/data/data-access).
- **Los límites de su plan.** El almacenamiento, cuánto puede leer una consulta y cuántas filas devuelve dependen de su plan. Véalos en <AppLink to="settings.usage" />, o en código con `nx.limits()`.

<Callout type="info" title="Límites del plan">
Los límites cambian según el plan. Revise siempre los suyos en <AppLink to="settings.usage" /> en vez de suponerlos.
</Callout>

## Cómo orientarse [#cómo-orientarse]

<ForEveryone>

Abra <AppLink to="data" />. El área de Datos tiene estas páginas:

- **Agregar datos**: suba archivos, convierta una hoja de cálculo en tabla o explore conectores.
- **Nexus Lakehouse**: todas las tablas que alcanza, por esquema.
- **Almacenamiento de objetos**: sus carpetas y archivos, con Papelera y Actividad.
- **Grafo de conocimiento**: las cosas de sus datos y cómo se conectan.
- **Editor SQL**: escriba y ejecute consultas.
- **Almacenamiento utilizado**: cuánto guarda cada esquema, día a día.
- **Gestión de datos**: qué cambió en sus datos y cómo restaurarlo.

<Screenshot src="/docs/_media/nexus-tables-list.png" alt="El área de Datos con Nexus Lakehouse abierto" />

</ForEveryone>

<ForDevelopers>

<Callout type="info" title="Disponible bajo solicitud">
El SDK y la CLI de Klarety están disponibles bajo solicitud. Para solicitar acceso para su espacio de trabajo, [contáctenos](https://klarety.ai/contact).
</Callout>

Instale el <Term id="sdk">SDK</Term> y conéctese con una <Term id="api-key">clave de API</Term> de <AppLink to="settings.sdk-api" />:

```bash
pip install klarety
```

```python title="nexus_tour.py"
from klarety import Nexus

nx = Nexus.connect("YOUR_API_KEY")

for schema in nx.schemas.list():
    print("schema", schema)

for table in nx.tables.list("default"):
    print("table", table)

result = nx.sql("SELECT 1 AS ok")
print(result.rows)

nx.close()
```

`Nexus.connect()` también lee la clave de `KLARETY_API_KEY`. El objeto `Nexus` agrupa todo por área: `nx.tables`, `nx.schemas`, `nx.folders`, `nx.files`, `nx.knowledge_graph`, `nx.restores` y `nx.access`.

</ForDevelopers>

<Screenshot src="/docs/_media/nexus-data-usage.png" alt="Almacenamiento usado, con cuántos datos guarda el espacio de trabajo" />

<Screenshot src="/docs/_media/nexus-sidebar-compute-cpu-memory-usage-quick-overview.png" alt="La barra lateral con una vista rápida del cómputo, la CPU y la memoria" />

## Cómo se protegen sus datos [#cómo-se-protegen-sus-datos]

- **Cada cambio se guarda.** Las tablas guardan su historial y los archivos todas sus versiones. Las tablas, carpetas y archivos eliminados se pueden restaurar durante un tiempo.
- **El acceso se revisa en cada solicitud.** Personas, proyectos y claves de API alcanzan solo lo que se les dio.
- **Los secretos se cifran** con un servicio de claves administrado.
- **Verificación de lectura.** Gestión de datos muestra cuánto tiempo se guardan los cambios, cuánto tiempo se pueden restaurar los elementos eliminados y cuándo se verificó por última vez que cada archivo se puede leer.

## Siguientes pasos [#siguientes-pasos]

- [Agregar datos](/docs/es/data/add-data): traiga su primer archivo u hoja de cálculo.
- [Trabajar con tablas](/docs/es/data/tables): explore, edite, verifique y vea el historial.
- [Consultar con SQL](/docs/es/data/sql-editor): ejecute su primera consulta.
- [Acceso a datos](/docs/es/data/data-access): elija quién alcanza qué.