Combina los registros de dos o más tablas de Analytics anexándolas a una nueva tabla de Analytics.
Sintaxis
APPEND tabla_1; tabla_2; <...n> TO nombre_de_tabla <COMMONFIELDS> <OPEN> <ASCHAR> <ALLCHAR> <SOURCETABLE>
Parámetros
| Nombre | Descripción |
|---|---|
| tabla_1; tabla_2; <...n> |
Las tablas que se deben anexar. Los registros de cada tabla se anexan en el orden en el que usted especifique las tablas. La tabla de salida contiene los registros de la tabla_1, seguidos de los registros de la tabla_2, etc. Las tablas de origen pueden tener estructuras de registros diferentes o idénticas y pueden estar ordenadas o desordenadas. |
| TO nombre_tabla |
El lugar al que se deben enviar los resultados del comando:
|
|
COMMONFIELDS opcional |
Solo aquellos campos que son comunes a todas las tablas que se están anexando se incluirán en la tabla de salida. Si omite COMMONFIELDS, se incluyen todos los campos de todas las tablas en la tabla de salida. Cuando no existen campos en las tablas de origen, la tabla de salida incluye valores en blanco. Consejo Si desea ver diagramas y capturas de pantallas que muestran las dos opciones, consulte Anexión de tablas. Nota El comando APPEND no permite anexar campos calculados. Si desea obtener más información, consulte No se admiten campos calculados. ¿Qué convierte a los campos en comunes?Para que los campos se consideren comunes, deben reunir las siguientes condiciones:
Nombre idéntico, diferente categoría de datosSi dos campos tienen un nombre idéntico pero pertenecen a diferentes categorías de datos, aparece un mensaje de error y el comando APPEND no se ejecuta. El mensaje de error contiene todos los conflictos de categorías de datos del conjunto de tablas que se especificaron con el comando APPEND. El mensaje se guarda en el log de comandos. Nota Puede evitar esta situación si usa ASCHAR o ALLCHAR para unificar las categorías de los datos. |
|
OPEN opcional |
Abre la tabla creada por el comando después de la ejecución del comando. Solo es válido si el comando crea una tabla de salida. |
|
opcional |
Armoniza los campos con nombres idénticos pero diferentes categorías de datos convirtiendo los campos que no son de caracteres en la categoría de datos de caracteres. Por ejemplo, anexa dos tablas en las cuales el campo ID_empleado contiene datos de caracteres en una tabla y datos numéricos en la otra. El campo ID_empleado numérico se convierte en datos de caracteres y los dos campos se anexan sin ningún error. ASCHAR se ignora si también se especifica ALLCHAR. |
|
opcional |
Convierte todos los campos que no son de caracteres de todas las tablas que se están anexando en categoría de datos de caracteres. Esta conversión global a datos de caracteres permite asegurarse de que todos los campos con el mismo nombre se anexen sin errores. Nota Después de anexar las tablas, puede cambiar la categoría de datos de un campo anexado completo si es lo que corresponde para los datos del campo. |
|
SOURCETABLE opcional |
Incluya el campo Tabla de origen ( Tabla_de_origen ) en la tabla de salida. Para cada registro de la tabla de salida, el campo Tabla de origen identifica la tabla desde la cual se originó el registro. Consejo Incluir los nombres de las tablas de origen que está anexando permite proporcionar información útil al analizar los datos en la tabla de salida. |
Ejemplos
Anexar tres tablas de transacciones mensuales
El ejemplo que se incluye a continuación anexa tres tablas de transacciones mensuales y genera una tabla de transacciones trimestrales de salida que incluye todos los campos de las tres tablas de origen:
APPEND Trans_ene; Trans_feb; Trans_mar TO Trans_T1
Anexar tres tablas de empleados e incluir únicamente los campos comunes
El siguiente ejemplo anexa tres tablas de empleados de divisiones y genera una tabla maestra de empleados que incluye únicamente los campos comunes de las tres tablas de origen:
APPEND Empleados_central; Empleados_este; Empleados_oeste TO Empleados_maestro COMMONFIELDS
Anexar tres tablas de empleados y unificar los campos con diferentes categorías de datos
Los siguientes ejemplos anexan tres tablas de empleados de divisiones en las cuales algunos campos con el mismo nombre usan diferentes categorías de datos.
El primer ejemplo convierte los campos que no son de caracteres en la categoría de datos de caracteres únicamente cuando es necesario para unificar los datos:
APPEND Empleados_central; Empleados_este; Empleados_oeste TO Empleados_maestro ASCHAR
El segundo ejemplo convierte todos los campos que no son de caracteres en la categoría de datos de caracteres sin importar si es necesario hacerlo para unificar los datos o no lo es:
APPEND Empleados_central; Empleados_este; Empleados_oeste TO Empleados_maestro ALLCHAR
Observaciones
Nota
Si desea obtener más información sobre la forma en la que funciona este comando, consulte Guía de ayuda.
Cómo funciona
El comando APPEND combina los registros de dos o más tablas anexándolas y creando una nueva tabla. Anexar significa agregar un grupo de registros a la parte inferior de otro grupo de registros.
Los campos de la tabla de origen con nombres físicos idénticos y categorías de datos idénticas se anexan directamente entre sí.
Los campos con nombres físicos exclusivos en todas las tablas de origen se agregan a la tabla de salida pero no se anexan directamente a ningún otro campo.
Consejo
Si desea anexar directamente los campos con nombres que no coinciden absolutamente, estandarice los nombres físicos de los campos en los formatos de tabla antes de anexarlos. (Da por sentado que los campos pertenecen a la misma categoría de datos o que usted usa ASCHAR o ALLCHAR para unificar la categoría de datos de los campos).
Cuándo usar APPEND
Utilice APPEND cuando quiera combinar datos de varias tablas con una estructura idéntica o similar. Por ejemplo, APPEND es una buena opción para combinar las tablas mensuales o trimestrales en una tabla anual.
Consejo
Una sola ejecución del comando APPEND puede reemplazar varias ejecuciones del comando EXTRACT con la opción APPEND.
No es un reemplazo de JOIN o DEFINE RELATION
En general, APPEND no es un reemplazo de los comandos JOIN o DEFINE RELATION porque no permite incluir o excluir registros sobre la base de valores coincidentes o no coincidentes en un campo clave común. Con APPEND, todos los registros de cada tabla de origen se incluyen en la tabla de salida.
Anexión de tablas absolutamente disímiles
Puede anexar tablas totalmente disímiles (es decir dos o más tablas que no tienen ningún campo en común). Si bien no es el principal uso del comando APPEND, se lo puede utilizar para anexar tablas disímiles con un fin analítico.
Anexar campos de fechahora
Para que se anexen dos o más campos de fechahora, deben cumplir las siguientes condiciones:
- nombres físicos idénticos
- categoría de datos idéntica (Fechahora)
- subtipos de datos idénticos (fecha, fechahora u hora)
- uso idéntico del indicador de zona (ya sea usado o no usado por todos los campos que se están anexando)
Si dos campos de fechahora tienen un nombre idéntico pero no reúnen una de las demás condiciones, aparece un mensaje de error y el comando APPEND no se ejecuta.
El mensaje de error contiene todas las condiciones que no se cumplieron en el conjunto de tablas que se especificaron con el comando APPEND. El mensaje se guarda en el log de comandos.
Nota
Puede unificar campos de fechahora diferentes convirtiéndolos en la categoría de datos de caracteres y luego anexarlos. Este enfoque le permite combinar los datos en una misma tabla. Sin embargo, según la naturaleza de los datos de origen, es posible que no pueda convertir los datos combinados nuevamente en datos de fechachora.
Armonización automática
En algunas situaciones, el comando APPEND armoniza automáticamente los campos para anexarlos:
| Categoría de datos de los campos | Armonización realizada |
|---|---|
| Carácter |
|
| Numérico |
|
| Fechahora |
|
Cuándo no se realiza la armonización automática
Analytics no armoniza los campos automáticamente en las siguientes situaciones. Aparece un mensaje de error y no se ejecuta la operación de anexión.
- Hay dos campos con un nombre idéntico pero pertenecen a diferentes categorías de datos.
- Dos campos de fechahora con un nombre idéntico pertenecen a subtipos diferentes de fechahora (fecha, fechahora u hora).
- Dos campos de fechahora con un nombre idéntico no hacen el mismo uso del indicador de zona horaria.
No se admiten campos calculados
El comando APPEND no permite anexar campos calculados. Al anexar tablas, los campos calculados de las tablas de origen se excluyen automáticamente de la tabla de salida.
Si un campo calculado de una tabla de origen tiene el mismo nombre que un campo físico de otra tabla de origen, aparece un mensaje de error y no se ejecuta el comando APPEND.
Consejo
Puede anexar un campo calculado extrayéndolo primero para convertir el campo en un campo físico. (Si desea obtener más información, consulte Comando EXTRACT). A continuación, utilizará la tabla extraída para la operación de anexión.
Otro enfoque consiste en volver a crear el campo calculado en la tabla de salida anexada.
No se admiten los campos de notas de registros
El comando APPEND no permite anexar campos de Notas de registro. Al anexar tablas, los campos de Nota de registro de las tablas de origen se excluyen automáticamente de la tabla de salida.
Si un campo de Nota de registro de una tabla de origen tiene el mismo nombre que un campo físico de otra tabla de origen, aparece un mensaje de error y no se ejecuta el comando APPEND.
Los campos de Nota de registro son generados automáticamente por Analytics cuando usted agrega una nota a un registro.
Longitud de registro
Si incluye todos los campos de las tablas de origen al anexar, la longitud del registro de la tabla de salida puede ser más extensa que el registro más extenso de las tablas de origen.
Si la longitud de los registros de salida supera el máximo de 32 KB de Analytics, aparece un mensaje de error.
Anexión y lugares decimales
La anexión de campos numéricos que incluyen lugares decimales se rige por un comportamiento específico.
La configuración Decimal
El comando APPEND utiliza la cantidad de lugares decimales que se definieron en el ajuste Dec en la definición de campo del formato de tabla.
Nota
El ajuste Dec puede no ser el mismo que el número real de lugares decimales en los datos de origen. Los lugares decimales que superan el ajuste Dec no se definen y se redondean en los cálculos.
Ajustes dispares de Decimal
Si los campos numéricos anexados tienen ajustes dispares de Dec, los campos se convierten al tipo de datos de ACL y se armonizan automáticamente al ajuste Dec más extenso.
Los lugares decimales de los archivos de datos de origen que superen el ajuste Dec más extenso se excluyen de la tabla de salida generada por el comando APPEND.
Ajustes uniformes de Decimal
Si lo campos numéricos anexados tienen un ajuste uniforme de Dec, no se lleva a cabo ninguna conversión del tipo de datos ni ninguna armonización.
Los lugares decimales de los archivos de datos de origen que superen el ajuste Dec se incluyen en la tabla de salida generada por el comando APPEND.
Ordenación
Cualquier criterio de ordenamiento existente en las tablas de origen se mantiene por separado en los conjuntos de registros correspondientes en la tabla de salida.
Incluso si los registros de todas las tablas de salida están ordenados, la tabla de salida se considera sin ordenar porque los registros de origen se anexan como grupos, sin considerar ningún criterio de ordenamiento existente en otras tablas de origen.
Por ejemplo, si anexa tablas mensuales o trimestrales para crear una tabla anual, se mantiene cualquier ordenamiento interno de los datos mensuales o trimestrales. Si es necesario, puede ordenar la tabla de salida después de realizar la operación de anexión.
Cómo funciona el orden de los campos
Campos comunes
Los campos comunes en las tablas de origen no tienen que estar en el mismo orden para ser anexados.
Por ejemplo, estos campos se anexan correctamente aun cuando se encuentran en un orden diferente:
| Tabla | Campos |
|---|---|
| tabla_1 | Apellido | Primer_nombre | Segundo_nombre |
| tabla_2 | Primer_nombre | Segundo_nombre | Apellido |
La primera tabla especificada en el comando APPEND indica el orden de los campos en la tabla de salida. Por lo tanto, en el ejemplo anterior, el orden de la tabla de salida es el siguiente:
- Apellido | Primer_nombre | Segundo_nombre
Campos no comunes
Los campos no comunes en las tablas de origen aparecen en la tabla de salida en el orden en que aparecen en el grupo seleccionado de tablas de origen.
Por ejemplo, al anexar estas dos tablas:
| Tabla | Campos |
|---|---|
| tabla_1 | Título | Apellido | Primer_nombre | Segundo_nombre |
| tabla_2 | Primer_nombre | Segundo_nombre | Apellido | Fecha_de_nacimiento |
el orden en la tabla de salida es el siguiente:
- Título | Apellido | Primer_nombre | Segundo_nombre | Fecha_de_nacimiento
Título de columna alternativo
Los títulos de columna alternativos de las tablas de origen aparecen en la tabla de salida. Si más de una tabla de origen tiene un título de columna alternativo para el mismo campo, el título de la primera tabla seleccionada tiene prioridad.
