> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sincronizar con ClickHouse mediante WalShadow

> Replique sus datos de Postgres en ClickHouse con WalShadow, un motor de replicación nativo que lee directamente del WAL de PostgreSQL

export const Image = ({img, alt, size = "lg", background}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} style={{
    backgroundColor
  }} />
      </Frame>
    </div>;
};

export const PrivatePreviewBadge = () => {
  return <div className="privatePreviewBadge">
            <div className="privatePreviewIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5.33301 6.66667V4.66667V4.66667C5.33301 3.194 6.52701 2 7.99967 2V2C9.47234 2 10.6663 3.194 10.6663 4.66667V4.66667V6.66667" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path d="M8.00033 9.33337V11.3334" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path fillRule="evenodd" clipRule="evenodd" d="M11.333 14H4.66634C3.92967 14 3.33301 13.4033 3.33301 12.6666V7.99996C3.33301 7.26329 3.92967 6.66663 4.66634 6.66663H11.333C12.0697 6.66663 12.6663 7.26329 12.6663 7.99996V12.6666C12.6663 13.4033 12.0697 14 11.333 14Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'Vista previa privada'}
        </div>;
};

<PrivatePreviewBadge />

`WalShadow` es un motor de replicación nativo para ClickHouse Managed Postgres que lee directamente del registro de escritura anticipada (WAL) de PostgreSQL. Está optimizado para cargas de trabajo de baja latencia y alto rendimiento, y ofrece un retraso de replicación inferior a un segundo entre Postgres y ClickHouse. Su desarrollo es abierto y se realiza en [ClickHouse/walshadow](https://github.com/ClickHouse/walshadow).

`WalShadow` es uno de los dos métodos de replicación disponibles en **Sync to ClickHouse**. El otro, [ClickPipes](/es/cloud/managed-postgres/clickpipes), es una canalización de datos totalmente gestionada. Elija `WalShadow` cuando necesite la menor latencia posible y la mínima sobrecarga de replicación.

Cuando `WalShadow` está disponible para su servicio, aparece un banner de **Private Preview** en la página **Overview**. Haga clic en **Configure WalShadow** para comenzar.

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/_zeYYhn8mtbf0rOY/images/managed-postgres/walshadow/overview-banner.webp?fit=max&auto=format&n=_zeYYhn8mtbf0rOY&q=85&s=81dfbd1832e869ec28da2fa33a3c6d9e" alt="Página de resumen del servicio Postgres que muestra el banner de private preview de WalShadow con los enlaces Learn more y Configure WalShadow" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/overview-banner.webp" />

<Note>
  Antes de continuar, asegúrese de que su servicio Postgres sea accesible para ClickHouse. `WalShadow` se conecta directamente a su servicio ClickHouse de destino, por lo que necesitará un usuario y una contraseña de ClickHouse con permisos para crear bases de datos y tablas.
</Note>

Para configurar la replicación, haga clic en **Sync to ClickHouse** en la barra lateral de su instancia de Postgres y, a continuación, en **Replicate data in ClickHouse**.

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/_zeYYhn8mtbf0rOY/images/managed-postgres/walshadow/sync-landing.webp?fit=max&auto=format&n=_zeYYhn8mtbf0rOY&q=85&s=78e1892ef7a31503586a0635e18be6fa" alt="Página de inicio de Sync to ClickHouse que muestra los métodos de replicación ClickPipes y WalShadow" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/sync-landing.webp" />

<Steps>
  <Step title="Seleccione el motor de replicación" id="select-replication-engine">
    Elija **WalShadow** como motor de replicación y luego haga clic en **Next**.

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/_zeYYhn8mtbf0rOY/images/managed-postgres/walshadow/select-engine.webp?fit=max&auto=format&n=_zeYYhn8mtbf0rOY&q=85&s=f8300818381fe1cbf5ea52562b50f62b" alt="Paso de selección del motor de replicación que muestra las opciones ClickPipes y WalShadow, con WalShadow seleccionado" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/select-engine.webp" />
  </Step>

  <Step title="Configure el servicio de replicación" id="configure-replication-service">
    Complete los ajustes de replicación:

    * **ClickHouse service**: seleccione un servicio ClickHouse existente o cree uno nuevo
    * **Postgres database**: seleccione la base de datos de origen desde la que replicar, o cree una nueva
    * **Replication method**: elija una de estas opciones:
      * **Initial load + CDC**: importa los datos existentes y mantiene las tablas actualizadas con los nuevos cambios (recomendado)
      * **Initial load only**: importación única de los datos existentes, sin actualizaciones posteriores
      * **CDC only**: omite la importación inicial y captura únicamente los nuevos cambios a partir de ese momento

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/_zeYYhn8mtbf0rOY/images/managed-postgres/walshadow/configure-service.webp?fit=max&auto=format&n=_zeYYhn8mtbf0rOY&q=85&s=94a0c71c28ef3a31e2cfa0daa551ea81" alt="Paso de configuración del servicio de replicación que muestra las opciones de servicio ClickHouse, base de datos Postgres y método de replicación" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/configure-service.webp" />

    Haga clic en **Next** para continuar.
  </Step>

  <Step title="Seleccione las tablas que se van a replicar" id="select-tables">
    Elija una base de datos de destino y seleccione qué tablas replicar:

    * **Destination database**: seleccione una base de datos en ClickHouse existente o cree una nueva
    * **Tables**: expanda cada esquema y seleccione tablas individuales, o active **Select all tables**. Para cada tabla puede personalizar el **Destination table name** y ajustar las **Column settings**.
    * **ClickHouse user** y **ClickHouse password**: `WalShadow` se conecta directamente al servicio ClickHouse de destino, por lo que necesita credenciales con permiso para crear la base de datos y las tablas de destino.

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/_zeYYhn8mtbf0rOY/images/managed-postgres/walshadow/select-tables.webp?fit=max&auto=format&n=_zeYYhn8mtbf0rOY&q=85&s=29b010e450a6340a932aedcda3fae1b9" alt="Paso de selección de tablas que muestra la selección de esquemas y tablas, los nombres de las tablas de destino y las credenciales de ClickHouse" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/select-tables.webp" />

    Haga clic en **Replicate data to ClickHouse** para iniciar la replicación.
  </Step>

  <Step title="Monitorice WalShadow" id="monitor-walshadow">
    Después de iniciar la replicación, `WalShadow` aparece en la página **Sync to ClickHouse**. Su estado es **Creating** mientras se aprovisiona la canalización y se prepara la carga inicial.

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/_zeYYhn8mtbf0rOY/images/managed-postgres/walshadow/walshadow-creating.webp?fit=max&auto=format&n=_zeYYhn8mtbf0rOY&q=85&s=5b95c778db8d48a093a6a32a9bcca30b" alt="Página Sync to ClickHouse que muestra WalShadow en estado Creating" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/walshadow-creating.webp" />

    Una vez completado el aprovisionamiento, el estado cambia a **Running**. La página muestra métricas en tiempo real de la replicación:

    * **Status**: el estado actual de la canalización (por ejemplo, `Running`)
    * **Filas sincronizadas**: el número total de filas replicadas en ClickHouse
    * **Backfills pending**: el número de tablas que aún esperan su carga inicial
    * **Lag**: el volumen de datos del WAL pendientes de aplicar
    * **Lag time**: cuánto retraso acumula actualmente el destino respecto a Postgres
    * **Uptime**: cuánto tiempo lleva ejecutándose la canalización
    * **Last updated**: cuándo se informaron las métricas por última vez

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/_zeYYhn8mtbf0rOY/images/managed-postgres/walshadow/walshadow-running.webp?fit=max&auto=format&n=_zeYYhn8mtbf0rOY&q=85&s=e2383f118f630d59f4f3e6de0185b519" alt="Página Sync to ClickHouse que muestra WalShadow en estado Running con las métricas de filas sincronizadas, retraso y tiempo de actividad" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/walshadow-running.webp" />
  </Step>
</Steps>

<h2 id="caveats">
  Advertencias
</h2>

Algunos aspectos a tener en cuenta mientras `WalShadow` se encuentra en Private Preview:

* Por ahora, solo se admite un `WalShadow` por servicio Postgres.
* Las Operations y métricas más detalladas forman parte del roadmap.
