Skip to main content

Blue icon with floppy disk. Herramienta Escribir datos En-BD

Requisitos del rol de usuario

Rol de usuario*

Acceso a herramientas/características

Usuario completo

✓

Usuario básico

X

* Se aplica a los clientes de las ediciones profesional y empresarial de Alteryx One en las versiones 2025.1 o posteriores de Designer.

Utiliza la herramienta Escribir datos En-BD para crear o actualizar una tabla directamente en la base de datos.

Las herramientas de la categoría En base de datos permiten combinar y analizar grandes conjuntos de datos sin tener que mover la información fuera de la base de datos, y pueden proporcionar importantes mejoras de rendimiento en comparación con los métodos de análisis tradicionales. Para obtener más información sobre la categoría de herramientas En base de datos, consulta Descripción general del procesamiento en base de datos.

Configure the Tool

Review the tool configuration options below.

Configurar la herramienta

Modo de salida: selecciona la opción adecuada para escribir los datos. Las opciones son:

  • Anexar existente: anexa todos los datos a una tabla existente. La salida consta de registros anteriores + registros posteriores.

  • Eliminar datos y anexar: elimina todos los registros originales de la tabla y, luego, anexa los datos a la tabla existente. Ten en cuenta que este modo es diferente según la base de datos en la que escribas:

    • Bases de datos de Oracle: utilizan la instrucción DELETE.

    • Bases de datos de SQL Server: utilizan la instrucción TRUNCATE TABLE, porque es un método más eficiente. Necesitas los permisos ALTER TABLE o TRUNCATE en la tabla.

  • Sobrescribir tabla (descartar): borra completamente la tabla existente y crea una nueva.

  • Crear tabla nueva: crea una nueva tabla. No sobrescribe una tabla existente.

  • Crear tabla temporal: escribe a una tabla temporal que está disponible hasta el final de la sesión. Esta opción es útil para crear macros predictivas en la base de datos, porque mantiene los metadatos en su lugar temporalmente. Si seleccionas esta opción, el campo Nombre de tabla se desactiva y muestra “[se genera un nombre de tabla temporal único en cada ejecución]".

  • Actualizar filas: actualiza las filas existentes en una tabla según los registros entrantes.

  • Eliminar filas: elimina las filas existentes de una tabla según los registros entrantes.

  • Combinar tablas: combina los datos entrantes con la tabla especificada en la herramienta. Admite Eliminar y Actualizar en función de los campos de combinación seleccionados.

  • Nombre de tabla: ingresa el nombre de la tabla de base de datos que se va a crear o actualizar.

Append Fields Mapping

Mapeo de campos para agregar (o Mapa de campos SET cuando Actualizar filas sea el Modo de salida seleccionado): esta área se activa cuando se elige Anexar existente o Eliminar datos y anexar.

Elige un modo de configuración:

  • Configurar automáticamente por nombre: alinea los campos según el nombre del campo.

  • Configurar automáticamente por posición: alinea los campos según su orden de campo en el flujo.

When Fields are Different

Cuando los campos son diferentes: selecciona cómo manejar los campos de datos no compatibles en las opciones que aparecen en el menú desplegable.

  • Error: detener el procesamiento: produce un error en la ventana Resultados y finaliza el procesamiento.

  • Emitir campos aplicables como salida: se incluyen los campos aplicables. Los valores nulos rellenan campos vacíos.

Options

Opciones: esta área se activa cuando se elige Actualizar filas o Eliminar filas como Modo de salida.

  • Mapa de campos WHERE: forma la instrucción condicional para el modo de salida Actualizar filas y Eliminar filas.

Advanced Query Options

Use this section to define Pre- and Post-SQL statements to execute. This option is compatible with all of the above output modes. Pre- and Post-SQL statements are compatible with Bulk Loaders, OCI, ODBC, and OLE DB technologies.

To configure your SQL statements...

  1. Use the 3-dot menu associated with either the Pre- or Post-SQL Statement fields to launch the Configure Pre/Post-SQL Statements window, which includes the SQL Editor and Stored Procedures tabs.

  2. Next, define SQL statements as needed:

    • Pre-SQL Statement: Define a SQL statement to execute before running the in-database statement/query and before appending to or creating the output table.

    • Post-SQL Statement: Define a SQL statement to execute after running the in-database statement/query and after appending to or creating the output table.

    Nota

    Most Pre/Post-SQL use cases involve the Write Data In-DB tool. If your workflow doesn't include a Data Stream In tool, then the next best place for session variables is the Write Data In-DB tool.

  3. To configure Pre-SQL and Post-SQL statements...

    • Use the SQL Editor tab to define a SQL statement to execute before/after the In-DB execution. When the workflow runs, the Results window displays messages to show that the tool is executing SQL statements, along with a label (PreSQL or PostSQL). All SQL statements are sent directly to the database.

      • Pre-SQL/Post-SQL statements do not return data. While SQL can return data, Designer doesn't do anything with it.

      • If there are multiple streams of In-DB tools, there is no guaranteed order of execution between different streams. The Results window displays the order.

    • Use the Stored Procedures tab to select and configure a stored procedure call for your database. You can select a Parameter and set a Value for your stored procedures if needed. All stored procedures are sent directly to the database.

      • If a stored procedure is executed successfully, it returns any necessary status messages or warnings in the Results window.

      • If a stored procedure returns data, Designer does not return it anywhere. The data is not displayed in the Results window.

      Importante

      Stored procedures are supported for these connections:

      • SQL Server for ODBC and Bulk Writer

      • Oracle for ODBC Only

  4. Select OK when you're finished or Cancel to return to the tool configuration window.

Estructura de consulta

Consultas de muestra para las opciones Actualizar y Eliminar filas del modo de salida:

Actualizar filas

WITH upstream AS ( ... ) UPDATE t SET t.col2 = (SELECT col2 FROM upstream u WHERE u.col1 = t.col1 AND ...), ... FROM target_ t WHERE EXISTS ( SELECT * FROM upstream u WHERE u.col1 = t.col1 AND ... )

Eliminar filas

WITH upstream AS ( ... ) DELETE t from target_ t WHERE EXISTS ( SELECT * FROM upstream u WHERE u.col1 = t.col1 AND ... )

Limitaciones

  • Actualizar/Eliminar opciones de salida actualmente no admite alias de columna.

  • La opción para actualizar salida actualmente requiere que todos los nombres de campo coincidan con los nombres de campo de la tabla de destino (para la opción Configurar automáticamente por nombre en Anexar mapeo de campos) y que el número de campos coincida con el número de campos de la tabla de destino (opción Configurar automáticamente por posición en Anexar mapeo de campos).

  • Actualizar/Eliminar solo es compatible con las conexiones ODBC de SQL Server.

  • Actualizar/Eliminar opciones de salida actualmente no admiten actualizar o eliminar valores nulos. Los operadores de comparación (como = o !=) que se utilizan para las consultas de actualización y eliminación de Alteryx devuelven “desconocido” en los valores nulos. Para obtener más información, consulta Documentación de Microsoft SQL Server.

  • Cuando se anexan datos mediante la herramienta Escribir datos En-BD, todas las columnas de la tabla objetivo deben incluirse en la instrucción INSERT para que INSERT sea válida. Las columnas ausentes se agregarán con un valor nulo.

  • Combinar datos en-BD solo es compatible con Databricks Unity Catalog.

En esta sección: