Crear y rellenar tablas HubDB

HubDB es una herramienta de base de datos utilizada para crear y administrar tablas de datos estructuradas. Puedes utilizar tablas HubDB para crear páginas dinámicas y tablas de consulta externamente a través del HubDB API . HubDB almacena datos estructurados (por ejemplo, listas de productos, directorios de equipo o programaciones de eventos) para que la información se pueda actualizar en un lugar central en lugar de actualizar varias páginas individualmente. Más información sobre HubDB en la documentación para desarrolladores de HubSpot.

Antes de empezar

Antes de comenzar a trabajar con esta característica, asegúrate de que comprendes perfectamente qué pasos hay que dar con antelación, así como las limitaciones de la función y las posibles consecuencias de utilizarla. 

Comprender las limitaciones y consideraciones

• Todas las nuevas tablas creadas se establecen con un estado de borrador. Las tablas no se pueden usar para generar datos con HubL o la API hasta que se publique la tabla.
• Revisa los límites técnicos de HubDB.

Crear una tabla

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en Crear tabla.
3. En el cuadro de diálogo, introduce una etiqueta de Tabla  y un nombre de Tabla  . No puedes cambiar el nombre de una tabla después de publicarla.
4. Haz clic en Crear.

Agregar o importar datos de tablas

Una vez creada una tabla, puedes agregar nuevas columnas y filas para estructurar los datos utilizados en las páginas de tu sitio web o a través del HubDB API . También puedes importar un archivo CSV para combinar sus datos en una tabla de HubDB.

Agregar columnas de tabla

Las columnas definen el tipo de datos almacenados en cada parte de la tabla. Cuando agregas una columna, seleccionas un tipo de columna y configuras los ajustes que determinan cómo se introducen y utilizan los datos.

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre de una tabla.
3. En la parte superior derecha, haz clic en el menú desplegable Acciones y selecciona Agregar columna.
4. En el cuadro de diálogo, introduce una etiqueta Columna.
5. Introduce un nombre de columna. Puedes utilizar este nombre para consultar tus datos con el HubDB API .
6. Introduce una descripción de columna. Esta descripción aparecerá cuando un usuario pase el cursor sobre el icono de info información junto al nombre de la columna.
7. Haz clic en el menú desplegable Tipo de columna y selecciona un tipo de columna. Algunos tipos de columnas mostrarán opciones adicionales (por ejemplo, Seleccionar o Selección múltiple) para configurar.
8. Cuando termines, haz clic en Agregar columna.

Añadir filas a la tabla

Las filas almacenan registros individuales en la tabla. Agrega filas para enriquecer la tabla con datos estructurados o actualiza las filas existentes a medida que cambien los datos.

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre de una tabla.
3. En la parte superior derecha, haz clic en el menú desplegable Acciones y selecciona Agregar fila.
4. Se creará una nueva fila. Si tienes filas existentes en la tabla, la nueva fila se agregará debajo de cualquier fila existente. Introduce un valor para cada columna que hayas configurado para la tabla.

Importar datos de tablas con un archivo CSV

Importa datos desde un archivo CSV para agregar varias filas a tu tabla de HubDB a la vez. Esto es útil cuando trabajas con grandes conjuntos de datos o migras información existente a HubDB.

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre de una tabla.
3. En la parte superior derecha, haz clic en el menú desplegable Acciones y selecciona Importar.
4. Haz clic en el mosaico Agregar o Reemplazar :
   • Añadir: las filas de tu hoja de cálculo se añadirán a los datos existentes.
   • Reemplazar: filas de tu hoja de cálculo sobrescribirá y reemplazará cualquier dato existente en tu tabla. Si se incluyen ID de filas en la hoja de cálculo, las filas se actualizarán en lugar de reemplazarse.
5. Haz clic en Siguiente.
6. En la página Seleccionar archivo , haz clic en Elegir archivo.
7. Busca el archivo CSV en tu sistema de archivos y luego haz clic en Abrir.
8. Por defecto, HubSpot detectará la codificación de los datos de tu CSV. Para especificar manualmente la codificación de los datos:
   • Haz clic en Opciones avanzadas.
   • Haz clic en el menú desplegable Personalizar codificación de datos y, a continuación, selecciona una codificación.
9. Haz clic en Siguiente.
10. En la página Asignar columnas , especifica cómo deseas asignar cada campo de tu CSV a la columna de la tabla de HubDB correspondiente:
    • Haz clic en el menú desplegable Columna de tabla HubDB y selecciona una columna .
    • Si no has configurado una columna asociada para el campo CSV, haz clic en Añadir columna. En el cuadro de diálogo, introduce una etiqueta, un nombre y selecciona un tipo. Cuando hayas terminado, haz clic en Añadir columna.
11. Cuando hayas terminado, haz clic en Importar.
12. Cuando la importación haya finalizado, haz clic en Hecho.

Administrar los datos de las tablas

Administra la estructura y el contenido de tu tabla de HubDB eliminando columnas o filas y ajustando su orden. Estas acciones ayudan a mantener la tabla organizada y garantizan que los datos estén estructurados correctamente para su uso en el sitio web o en el HubDB API.

Eliminar columnas de la tabla

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre de una tabla.
3. Coloca el cursor sobre la etiqueta de una columna y haz clic en el menú desplegable y luego selecciona Eliminar.
4. En el cuadro de diálogo, haga clic en Eliminar.

Eliminar filas de tablas

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre de una tabla.
3. Coloca el cursor sobre el ID de una fila y haz clic en el menú desplegable y luego selecciona Eliminar.

Reordenar columnas y filas de tablas

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre de una tabla.
3. Para cambiar el orden de una fila, coloca el cursor sobre el número de fila y haz clic en el icono de dragHandleIcon arrastrar y soltar. A continuación, mueva la fila hacia arriba o hacia abajo a una nueva posición.

4. Para cambiar el orden de una columna, coloca el cursor sobre ella y haz clic en el icono de dragHandleIcon arrastrar y soltar. A continuación, mueve la columna a la izquierda o a la derecha a una nueva posición.

Administrar la configuración de la tabla

Gestiona la configuración individual de las tablas de HubDB, incluyendo las opciones de acceso público a la API y si los datos pueden utilizarse para crear páginas dinámicas.

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre  de una tabla.
3. En la parte superior derecha, haz clic en el menú desplegable Acciones y selecciona Administrar configuración.
4. En el panel derecho, activa el interruptor Permitir acceso público a la API para activar las llamadas no autenticadas a la API para consultar los datos de la tabla.
   • Por opción predeterminada, sólo se puede acceder a los datos de la tabla en HubSpot a través de HubL o llamadas autenticadas a la API.
   • Para consultar los datos, tendrás que incluir el ID de la cuenta de HubSpot en un portalId parámetro de consulta.
5. Para crear páginas dinámicas utilizando la tabla, activa el interruptor Activar la creación de páginas dinámicas utilizando datos de filas. A continuación, puedes configurar las siguientes opciones adicionales:
   • En la sección Metadatos , haz clic en los menús desplegables y selecciona qué columnas rellenarán las páginas dinámicas con metadescripción, imagen destacada y datos de URL canónica. En las nuevas tablas, deberás crear nuevas columnas para contener estos datos.
     • Meta descripción: debe ser una columna de tipo texto.
     • Imagen destacada: debe ser una columna de tipo imagen.
     • URL canónica: debe ser una columna de tipo URL.
   • En la sección Tablas secundarias , selecciona la casilla de verificación Permitir el uso de tablas secundarias para activar las referencias a otras tablas de HubDB en esta tabla.
   • Para crear automáticamente páginas de contenido intermedias, selecciona la casilla de verificación Crear automáticamente páginas de contenido para tablas secundarias .Más información sobre cómo crear páginas dinámicas de múltiples niveles con HubDB .
6. Cuando hayas terminado, haz clic en Guardar.

Nota: una tabla padre no puede hacer referencia a una tabla hija que también haga referencia a la tabla padre. Esto creará un bucle que da como resultado un error al intentar seleccionar la tabla secundaria dentro de la tabla principal.

Publicar una tabla

Publica una tabla HubDB para que la estructura y los datos más recientes estén disponibles para su uso en tu sitio web o a través de la HubDB API. Después de crear una tabla o de actualizar las columnas o filas, publica la tabla para que se apliquen los cambios.

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre de una tabla.
3. En la parte superior derecha, haz clic en Publicar.
4. En el cuadro de diálogo, haz clic en Publicar para activar tus cambios.

Exportar datos de la tabla

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el nombre de una tabla.
3. En la parte superior derecha, haz clic en el menú desplegable Acciones y selecciona Exportar. A continuación, selecciona una opción de formato de archivo (por ejemplo, CSV). Los datos de la tabla de HubDB comenzarán a descargarse inmediatamente.

Nota: Las imágenes de exportadas desde una tabla HubDB se formatearán como URLs de imágenes. Si se han personalizado las dimensiones de la imagen, aparecerán al final de la URL.

Ver tabla dependientes

Antes de actualizar o eliminar una tabla de HubDB, ve qué activos dependen de ella. Ver los dependientes de la tabla te ayuda a comprender el efecto de los cambios en el contenido de tu sitio web o el uso de la API.

1. En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
2. Haz clic en el menú desplegable Acciones y selecciona Mostrar dependientes.
3. En el cuadro de diálogo, haz clic en un tipo de recurso (por ejemplo, Publicaciones de blog o Módulos) para ampliar la sección y ver los recursos individuales.