Herramienta Escribir datos En-BD
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.
Review the tool configuration options below.
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.
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.
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.
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.
Use this section to define Pre- and Post-SQL statements to execute. This option is compatible with all of the above output modes. 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. Note that Stored Procedures are not currently supported.
Pre- and Post-SQL statements are compatible with the following technologies: Bulk Loaders, OCI, ODBC, and OleDB.
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.
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.
Nota
When the workflow runs, the Results window displays messages to show that the tool is executing SQL statements, along with a label (PreSQL, PostSQL).
All SQL statements are sent directly to the database. Pre- and Post-SQL statements do not return data. While SQL can return data, Designer doesn't do anything with that data.
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.
Consultas de muestra para las opciones Actualizar y Eliminar filas del modo de salida:
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 ... )
WITH upstream AS ( ... ) DELETE t from target_ t WHERE EXISTS ( SELECT * FROM upstream u WHERE u.col1 = t.col1 AND ... )
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.