Introducción a las transferencias de datos de PostgreSQL

Puedes cargar datos de PostgreSQL a BigQuery con el conector del Servicio de transferencia de datos de BigQuery para PostgreSQL. El conector admite instancias de PostgreSQL alojadas en tu entorno local, Cloud SQL y otros proveedores de servicios en la nube públicos, como Amazon Web Services (AWS) y Microsoft Azure. En este documento, se proporciona una descripción general de las opciones de transferencia de datos para tu transferencia de PostgreSQL, así como información sobre la asignación de tipos de datos y los precios.

Para obtener información sobre cómo programar una transferencia de PostgreSQL, consulta Carga datos de PostgreSQL en BigQuery.

Opciones de transferencia de datos

En las siguientes secciones, se proporciona información sobre las opciones de transferencia de datos cuando configuras una transferencia de datos de PostgreSQL.

Configuración de TLS

El conector de PostgreSQL admite la configuración de la seguridad a nivel de transporte (TLS) para encriptar las transferencias de datos a BigQuery. El conector de PostgreSQL admite los siguientes parámetros de configuración de TLS:

  • El modo Encriptar datos y verificar la AC y el nombre de host En este modo, se realiza una validación completa del servidor con TLS a través del protocolo TCPS. Encripta todos los datos en tránsito y verifica que el certificado del servidor de la base de datos esté firmado por una autoridad certificadora (AC) de confianza. Este modo también verifica que el nombre de host al que te conectas coincida exactamente con el nombre común (CN) o un nombre alternativo del sujeto (SAN) en el certificado del servidor. Este modo evita que los atacantes usen un certificado válido para un dominio diferente con el objetivo de suplantar la identidad de tu servidor de base de datos.

    Si tu nombre de host no coincide con el CN o el SAN del certificado, la conexión fallará. Debes configurar una resolución de DNS para que coincida con el certificado o usar un modo de seguridad diferente. Usa este modo para obtener la opción más segura y evitar ataques de intermediario (PITM).

  • El modo Encriptar datos y verificar solo la AC. Este modo encripta todos los datos con TLS a través del protocolo TCPS y verifica que el certificado del servidor esté firmado por una AC en la que confía el cliente. Sin embargo, este modo no verifica el nombre de host del servidor. Este modo se conecta de forma correcta siempre que el certificado sea válido y lo emita una AC de confianza, sin importar si el nombre de host del certificado coincide con el nombre de host al que te conectas.

    Usa este modo si quieres asegurarte de conectarte a un servidor cuyo certificado esté firmado por una CA de confianza, pero el nombre de host no se pueda verificar o no tengas control sobre la configuración del nombre de host.

  • El modo Solo encriptación. Este modo encripta todos los datos transferidos entre el cliente y el servidor. No realiza ninguna validación de certificado ni de nombre de host.

    Este modo proporciona cierto nivel de seguridad, ya que protege los datos en tránsito, pero puede ser vulnerable a los ataques de PITM.

    Usa este modo si necesitas asegurarte de que todos los datos estén encriptados, pero no puedes o no quieres verificar la identidad del servidor. Te recomendamos que uses este modo cuando trabajes con VPC privadas.

  • El modo Sin encriptación ni verificación Este modo no encripta ningún dato ni realiza ninguna verificación de certificado o nombre de host. Todos los datos se envían como texto sin formato.

    No recomendamos usar este modo en un entorno en el que se manejen datos sensibles. Solo recomendamos usar este modo para realizar pruebas en una red aislada en la que la seguridad no sea un problema.

Certificado de servidor de confianza (PEM)

Si usas el modo Encriptar datos y verificar la AC y el nombre de host o el modo Encriptar datos y verificar la AC, también puedes proporcionar uno o más certificados codificados en PEM. Estos certificados son obligatorios en algunas situaciones en las que el Servicio de transferencia de datos de BigQuery necesita verificar la identidad de tu servidor de base de datos durante la conexión TLS:

  • Si usas un certificado firmado por una CA privada dentro de tu organización o un certificado autofirmado, debes proporcionar la cadena de certificados completa o el certificado autofirmado único. Esto es necesario para los certificados emitidos por las AC internas de los servicios administrados del proveedor de servicios en la nube, como Amazon Relational Database Service (RDS).
  • Si el certificado del servidor de la base de datos está firmado por una AC pública (por ejemplo, Let's Encrypt, DigiCert o GlobalSign), no es necesario que proporciones un certificado. Los certificados raíz de estas AC públicas están preinstalados y son de confianza para el Servicio de transferencia de datos de BigQuery.

Puedes especificar certificados con codificación PEM en el campo Certificado PEM de confianza de la configuración de transferencia, con los siguientes requisitos:

  • El certificado debe ser una cadena de certificados válida con codificación PEM.
  • El certificado debe ser completamente correcto. Cualquier certificado faltante en la cadena o contenido incorrecto hace que falle la conexión TLS.
  • En el caso de un solo certificado, puedes proporcionar un certificado autofirmado único desde el servidor de la base de datos.
  • Para una cadena de certificados completa emitida por una CA privada, debes proporcionar la cadena de confianza completa. Esto incluye el certificado del servidor de la base de datos y cualquier certificado de la AC intermedio y raíz.

Transferencias completas o incrementales

Para especificar cómo se cargan los datos en BigQuery, selecciona la preferencia de escritura Completa o Incremental en la configuración de transferencia cuando configures una transferencia de PostgreSQL.

Puedes configurar una transferencia de datos completa para transferir todos los datos de tus conjuntos de datos de PostgreSQL con cada transferencia de datos.

Como alternativa, puedes configurar una transferencia de datos incremental para transferir solo los datos que se modificaron desde la última transferencia de datos, en lugar de cargar todo el conjunto de datos con cada transferencia de datos. Si seleccionas Incremental para la transferencia de datos, debes especificar los modos de escritura Append o Upsert para definir cómo se escriben los datos en BigQuery durante una transferencia de datos incremental. En las siguientes secciones, se describen los modos de escritura disponibles.

Modo de escritura de anexado

El modo de escritura de anexión solo inserta filas nuevas en la tabla de destino. Esta opción agrega estrictamente los datos transferidos sin verificar los registros existentes, por lo que este modo puede causar la duplicación de datos en la tabla de destino.

Cuando seleccionas el modo de anexar, debes seleccionar una columna de marca de agua. Se requiere una columna de marca de agua para que el conector de PostgreSQL haga un seguimiento de los cambios en la tabla de origen.

Para las transferencias de PostgreSQL, te recomendamos que selecciones una columna que solo se actualice cuando se creó el registro y que no cambie con las actualizaciones posteriores, por ejemplo, la columna CREATED_AT.

Modo de escritura de actualización o inserción

El modo de escritura de actualización o inserción actualiza una fila o inserta una nueva en la tabla de destino verificando una clave primaria. Puedes especificar una clave primaria para permitir que el conector de PostgreSQL determine qué cambios son necesarios para mantener actualizada tu tabla de destino con tu tabla de origen. Si la clave primaria especificada está presente en la tabla de BigQuery de destino durante una transferencia de datos, el conector de PostgreSQL actualiza esa fila con datos nuevos de la tabla de origen. Si no hay una clave primaria durante una transferencia de datos, el conector de PostgreSQL inserta una fila nueva.

Cuando seleccionas el modo de upsert, debes seleccionar una columna de marca de agua y una clave primaria:

  • Se requiere una columna de marca de agua para que el conector de PostgreSQL haga un seguimiento de los cambios en la tabla de origen.
    • Selecciona una columna de marca de agua que se actualice cada vez que se modifique una fila. Recomendamos columnas similares a las columnas UPDATED_AT o LAST_MODIFIED.

  • La clave primaria puede ser una o más columnas de tu tabla que son necesarias para que el conector de PostgreSQL determine si necesita insertar o actualizar una fila.

    Selecciona columnas que contengan valores no nulos que sean únicos en todas las filas de la tabla. Te recomendamos que incluyas columnas con identificadores generados por el sistema, códigos de referencia únicos (por ejemplo, IDs de incremento automático) o IDs de secuencia inmutables basados en el tiempo.

    Para evitar la posible pérdida o corrupción de datos, las columnas de clave primaria que selecciones deben tener valores únicos. Si tienes dudas sobre la singularidad de la columna de clave primaria que elegiste, te recomendamos que uses el modo de escritura de incorporación.

Comportamiento de la transferencia incremental

Cuando realizas cambios en el esquema de la tabla en tu fuente de datos, las transferencias de datos incrementales de esas tablas se reflejan en BigQuery de las siguientes maneras:

Cambios en la fuente de datos Comportamiento de transferencia incremental
Cómo agregar una columna nueva Se agrega una columna nueva a la tabla de BigQuery de destino. Los registros anteriores de esta columna tendrán valores nulos.
Borrar una columna La columna borrada permanece en la tabla de BigQuery de destino. Las entradas nuevas de esta columna borrada se propagan con valores nulos.
Cómo cambiar el tipo de datos en una columna El conector solo admite conversiones de tipos de datos que admite la declaración DDL ALTER COLUMN. Cualquier otra conversión de tipo de datos provoca un error en la transferencia de datos.

Si tienes algún problema, te recomendamos que crees una nueva configuración de transferencia.
Cómo cambiar el nombre de una columna La columna original permanece en la tabla de BigQuery de destino tal como está, mientras que se agrega una columna nueva a la tabla de destino con el nombre actualizado.

Asignación de tipos de datos

En la siguiente tabla, se asignan los tipos de datos de PostgreSQL a los tipos de datos de BigQuery correspondientes:

Tipo de datos de PostgreSQL Tipo de datos de BigQuery Tipo de datos de BigQuery actualizado
array STRING
bigint INTEGER
bigserial INTEGER
bit(n) STRING
bit varying(n) STRING
boolean BOOLEAN
box STRING
bytea BYTES
character STRING
character varying STRING
cidr STRING
circle STRING
circularstring STRING
compoundcurve STRING
curvepolygon STRING
date DATE
double precision FLOAT
enum STRING
geometrycollection STRING
inet STRING
integer INTEGER
interval STRING
json STRING JSON
jsonb STRING JSON
line STRING
linestring STRING
lseg STRING
macaddr STRING
macaddr8 STRING
money STRING
multicurve STRING
multilinestring STRING
multipoint STRING
multipolygon STRING
multisurface STRING
numeric(precision, scale)/decimal(precision, scale) NUMERIC
path STRING
point STRING
polygon STRING
polyhedralsurface STRING
range STRING
real FLOAT
serial INTEGER
smallint INTEGER
smallserial INTEGER
text STRING
time [ (p) ] [ without timezone ] TIMESTAMP
time [ (p) ] with time zone TIMESTAMP
tin STRING
timestamp [ (p) ] [ without timezone ] TIMESTAMP DATETIME
timestamp [ (p) ] with time zone TIMESTAMP
triangle STRING
tsquery STRING
tsvector STRING
uuid STRING
xml STRING

Precios

Para obtener información sobre los precios de las transferencias de PostgreSQL, consulta Precios del Servicio de transferencia de datos.

¿Qué sigue?