---
title: "Cláusula JOIN"
url: https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/joins/
description: "ZCQL es el lenguaje de consulta propio de Catalyst, inspirado en lenguajes de consulta conocidos, que puedes utilizar para consultar la base de datos de tu aplicación de manera eficiente."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: general
---

# Cláusula JOIN

### Introducción

La cláusula `JOIN` se utiliza para combinar filas de dos o más tablas en una consulta `SELECT`, basándose en una columna relacionada entre ellas. Las filas de todas las tablas se generan juntas con la columna común fusionada.

Antes de aprender más sobre la cláusula `JOIN`, comprendamos algunos términos clave relacionados con los joins:

1. **Clave primaria:** Una clave primaria es un identificador único de un registro en una tabla. Una tabla puede tener una columna como columna de clave primaria, y el valor de cada registro en esta columna debe ser único, es obligatorio y no puede duplicarse.
2. **Clave foránea**: Una columna de clave foránea en una tabla identifica de manera única una fila en otra tabla o en la misma tabla. La clave foránea de la segunda tabla hace referencia a la clave primaria de la primera tabla.
3. **Tabla padre**: En la cláusula `JOIN`, la tabla padre es la tabla base sobre la cual se realiza el join.
4. **Tabla de unión**: La tabla de unión es la tabla secundaria o la tabla hija que se fusiona con la tabla padre en la cláusula `JOIN`.

> **Nota:** Los joins entre dos tablas solo son posibles si existe una relación entre ellas. Una de las tablas debe hacer referencia a la columna de clave primaria de la otra tabla, por lo que la tabla de unión debe tener una columna de clave foránea de la tabla padre, o la tabla padre debe tener una columna de clave foránea de la tabla de unión.

En nuestro ejemplo, la columna _MovieID_ es la clave primaria de la tabla _Movies_ ya que contiene el número de identificación único de una película.

**Base de datos de ejemplo:**

Creemos una tabla llamada "Theaters" en la aplicación de reserva de entradas que especifica las ubicaciones de todos los cines registrados en la aplicación.

A continuación se muestran registros de ejemplo de la tabla **Theaters**:
<table class="content-table">
<thead>
<tr>
<th><strong>TheaterID</strong></th>
<th><strong>TheaterName</strong></th>
<th><strong>Location</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>047</td>
<td>The Express Cinemas</td>
<td>New York City</td>
</tr>
<tr>
<td>048</td>
<td>ANC Cinemas</td>
<td>Rochester</td>
</tr>
<tr>
<td>052</td>
<td>Cosmos Theater</td>
<td>Albany</td>
</tr>
<tr>
<td>053</td>
<td>FunTime Cinemas</td>
<td>Buffalo</td>
</tr>
</tbody>
</table>

La columna _TheaterID_ es la clave primaria de la tabla _Theaters_ ya que contiene los números de identificación únicos de los cines. La columna _TheaterID_ en la tabla _Movies_ es la clave foránea de la columna _TheaterID_ en la tabla _Theaters_.

> **Nota:** Cuando usas una cláusula `JOIN`, debes especificar los nombres de las columnas y sus nombres de tabla para cada columna en la consulta como: **'_table\_name.column\_name_'**'. Por ejemplo: '_Movies.MovieName_', '_Theaters.Location_'

Si no especificas el nombre de la tabla junto con el nombre de la columna en una consulta, por defecto se considera que es una columna en la tabla base.

### Tipos de Joins

Existen dos tipos de Joins que se pueden realizar en ZCQL.

#### INNER JOIN

El `INNER JOIN` devuelve los registros que tienen valores coincidentes tanto en la tabla padre como en la tabla de unión. Cuando usas un inner join en dos tablas, solo se producen como salida los registros cuyos valores coinciden para las columnas especificadas en ambas tablas.
 La sintaxis para usar un `INNER JOIN` es:

```sql
SELECT column_name(s)
FROM parent_table_name
INNER JOIN join_table_name
ON parent_table_name.column_name = join_table_name.column_name
```

**Ejemplo:**

Para ver una lista de los nombres de películas, fechas de proyección y horarios de la tabla _Movies_ junto con los nombres de los cines de la tabla _Theaters_, ejecuta la siguiente consulta:

```sql
SELECT Movies.MovieName, Theatres.TheaterName, Movies.ShowDate, Movies.ShowTime, 
FROM Movies INNER JOIN Theatres ON Movies.TheaterID = Theatres.TheaterID
```

Esto generará la siguiente salida:

<table class="content-table">
<thead>
<tr>
<th><strong>MovieName</strong></th>
<th><strong>TheaterName</strong></th>
<th><strong>ShowDate</strong></th>
<th><strong>ShowTime</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>Ant-Man and the Wasp</td>
<td>The Express Cinemas</td>
<td>2018-07-13</td>
<td>13:30:00</td>
</tr>
<tr>
<td>Hotel Transylvania 3: Summer Vacation</td>
<td>Cosmos Theater</td>
<td>2018-07-13</td>
<td>14:20:00</td>
</tr>
<tr>
<td>The First Purge</td>
<td>Cosmos Theater</td>
<td>2018-07-14</td>
<td>17:00:00</td>
</tr>
<tr>
<td>The First Purge</td>
<td>FunTime Cinemas</td>
<td>2018-07-14</td>
<td>21:30:00</td>
</tr>
</tbody>
</table>

#### LEFT JOIN 

El `LEFT JOIN` devuelve todos los registros de la tabla padre y los registros coincidentes de la tabla de unión. Cuando usas un left join en dos tablas, se devuelven todos los registros de la tabla padre, incluso si no tienen coincidencias en la tabla de unión. El resultado se muestra como 'NULL' para los registros que no tienen coincidencia en la tabla de unión.

La sintaxis para usar un `LEFT JOIN` es:

```sql
SELECT column_name(s)
			FROM parent_table_name
			LEFT JOIN join_table_name
			ON parent_table_name.column_name = join_table_name.column_name
```

**Ejemplo:**

Para ver una lista de cines y sus ubicaciones de la tabla _Theaters_ junto con las películas que se proyectan en los cines de la tabla _Movies_, ejecuta la siguiente consulta:

```sql
SELECT Theaters.TheaterName, Theaters.Location, Movies.MovieName
FROM Theaters
LEFT JOIN Movies
ON Theaters.TheaterID = Movies.TheaterID
```

Esto generará la siguiente salida:

<table class="content-table">
<thead>
<tr>
<th><strong>TheaterName</strong></th>
<th><strong>Location</strong></th>
<th><strong>MovieName</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>The Express Cinemas</td>
<td>New York City</td>
<td>The First Purge</td>
</tr>
<tr>
<td>ANC Cinemas</td>
<td>Rochester</td>
<td><strong>NULL</strong></td>
</tr>
<tr>
<td>Cosmos Theater</td>
<td>Albany</td>
<td>Hotel Transylvania 3: Summer Vacation</td>
</tr>
<tr>
<td>FunTime Cinemas</td>
<td>Buffalo</td>
<td>Skyscraper</td>
</tr>
</tbody>
</table>

Dado que no hay registros coincidentes para ANC Cinemas en la tabla Movies, el resultado se muestra como 'NULL'.

### Joins múltiples

Puedes combinar un máximo de **cuatro** joins en una sola consulta ZCQL. Sin embargo, solo puedes escribir **una** condición `JOIN` para cada cláusula de join. Esto mostrará los resultados de cuatro tablas diferentes, donde una está vinculada a otra usando un `INNER JOIN` o un `LEFT JOIN`.

**Base de datos de ejemplo**:

Creemos una tabla llamada 'Pricing' en la aplicación de reserva de entradas que muestra el precio del boleto en dólares de una entrada individual para una película y un cine en particular. Esta tabla hace referencia a _TheaterID_ de la tabla _Theaters_ y _MovieID_ de la tabla _Movies_ como claves foráneas.

A continuación se muestran registros de ejemplo de la tabla **Pricing**:

<table class="content-table">
<thead>
<tr>
<th><strong>TheaterID</strong></th>
<th><strong>MovieID</strong></th>
<th><strong>Price</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>047</td>
<td>2056</td>
<td>9.20</td>
</tr>
<tr>
<td>048</td>
<td>NULL</td>
<td><strong>NULL</strong></td>
</tr>
<tr>
<td>052</td>
<td>2057</td>
<td>8.64</td>
</tr>
<tr>
<td>052</td>
<td>2058</td>
<td>11.50</td>
</tr>
<tr>
<td>053</td>
<td>2059</td>
<td>7.44</td>
</tr>
</tbody>
</table>

Puedes ejecutar una consulta para mostrar el _TheaterName_ de la tabla _Theaters_, _MovieName_, _ShowDate_ y _ShowTime_ de la tabla _Movies_, y _Price_ de la tabla _Pricing_, ejecutando la siguiente consulta:

```sql
SELECT Theaters.TheaterName,Movies.MovieName, Movies.ShowDate, 
Movies.ShowTime, Pricing.Price
FROM Pricing
LEFT JOIN Movies
ON Theaters.TheaterID = Movies.TheaterID
INNER JOIN Theaters
ON Movies.MovieID = Pricing.MovieID
```

Esto generará la siguiente salida:

<table class="content-table">
<thead>
<tr>
<th><strong>TheaterName</strong></th>
<th><strong>MovieName</strong></th>
<th><strong>ShowDate</strong></th>
<th><strong>ShowTime</strong></th>
<th><strong>Price</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>The Express Cinemas</td>
<td>The First Purge</td>
<td>2018-07-13</td>
<td>13:00:00</td>
<td>9.20</td>
</tr>
<tr>
<td>ANC Cinemas</td>
<td>NULL</td>
<td>NULL</td>
<td>NULL</td>
<td>NULL</td>
</tr>
<tr>
<td>Cosmos Theater</td>
<td>Ant-Man and the Wasp</td>
<td>2018-07-13</td>
<td>14:20:00</td>
<td>8.64</td>
</tr>
<tr>
<td>Cosmos Theater</td>
<td>Hotel Transylvania 3: Summer Vacation</td>
<td>2018-07-14</td>
<td>17:00:00</td>
<td>11.50</td>
</tr>
<tr>
<td>FunTime Cinemas</td>
<td>Skyscraper</td>
<td>2018-07-14</td>
<td>21:30:00</td>
<td>7.44</td>
</tr>
</tbody>
</table>

> **Nota:** 

* Para utilizar todas las funcionalidades de la cláusula `JOIN`, te recomendamos migrar tu código base de **ZCQL V1** a **ZCQL V2**.

* A partir del **1 de diciembre de 2024**, todos tus proyectos actuales en todas tus [organizaciones](https://docs.catalyst.zoho.com/es/getting-started/catalyst-organizations/) presentes en el [entorno de desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/) se mapearán automáticamente al **ZCQL V2 Parser**.

* A partir del **1 de abril de 2025**, todos los proyectos presentes en todas las *organizaciones* que ya hayan sido mapeados al **ZCQL V2 Parser** en el *entorno de desarrollo* se mapearán automáticamente al **ZCQL V2 Parser** en el [entorno de producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/production-environment/), si y cuando se habilite producción para el proyecto.

* Puedes obtener más información sobre las mejoras y funcionalidades de **ZCQL V2** en este [documento de ayuda](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/syntax-exceptions/).