Comando SPLITVALUES
Información de concepto
Divide una tabla en dos o más tablas usando valores únicos de un campo clave. Las tablas de salida usan el valor único como nombre de la tabla, con un prefijo de texto opcional.
Nota
La cantidad máxima de valores de campo clave únicos admitida al dividir una tabla es 450.
Sintaxis
SPLITVALUES ON campo_clave <PREFIX texto_prefijo> {FIELDS nombre_campo <AS nombre_nuevo_campo> <...n>|FIELDS ALL} <nombre_tabla_relacionada.ALL <...n>">">">">> <IF prueba> <TO nombre_carpeta> <WHILE prueba> <FIRST intervalo|NEXT intervalo>
Parámetros
| Nombre | Descripción |
|---|---|
|
ON campo_clave |
El campo clave que se usará para dividir la tabla. El campo clave puede ser de caracteres, numérico, de fechahora o lógico. Para usar varios campos clave, cree un campo calculado que concatene los campos clave y úselo como campo clave. Nota El campo clave se incluye automáticamente en la tabla de salida y no es necesario especificarlo mediante FIELDS. |
|
PREFIX texto_prefijo opcional |
Cadena alfanumérica que se usa como prefijo para todos los nombres de la tabla de salida. Si omite PREFIX, las tablas de salida usan solo el valor único del campo clave como nombre de la tabla. El prefijo del nombre de tabla está limitado a 32 caracteres alfanuméricos. En total, los nombres de tabla están limitados a 64 caracteres alfanuméricos. Si la combinación del prefijo del nombre de una tabla y un valor del campo clave excede los 64 caracteres, el nombre de la tabla se trunca a la derecha. El prefijo del nombre de tabla puede incluir un guion bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El prefijo no puede comenzar con un número. Consejo Si usa un campo clave numérico o de fechahora, use un prefijo del estilo D_ o N_ para asegurarse de que se conserve el primer número de los valores del campo clave en los nombres de las tablas de salida. |
|
FIELDS nombre_campo | FIELDS ALL |
Los campos que se deben incluir en la salida:
|
|
AS nombre_nuevo_campo opcional |
Solo es válido si se usa FIELDS nombre_campo. El nuevo nombre físico y el nombre visible (título de columna alternativo) del campo en la tabla salida. Los caracteres especiales o los espacios que indique se conservan en el nombre visible y se convierten automáticamente en guiones bajos (_) en el nombre de campo físico en el formato de tabla. Especifique nombre_nuevo_campo como una cadena entre comillas. Utilice un punto y coma (;) entre las palabras si desea que haya un salto de línea en el nombre visible. |
| nombre_tabla_relacionada.ALL opcional |
Use todos los campos de la tabla relacionada especificada. |
|
IF prueba opcional |
Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta únicamente en los registros que cumplen la condición. Nota El parámetro IF se evalúa únicamente con los registros que quedan en la tabla después de aplicar los parámetros de alcance (WHILE, FIRST, NEXT). |
|
TO nombre_carpeta opcional |
Carpeta de destino para las tablas de salida. Si omite TO, las tablas se guardan en la carpeta donde se encuentra el proyecto de Analytics. |
|
WHILE prueba opcional |
Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta hasta que la condición se evalúa como falsa o hasta que se llega al final de la tabla. Nota Si usa WHILE junto con FIRST o NEXT, el procesamiento de registros se detiene al llegar a un límite. |
|
FIRST rango | NEXT rango opcional |
La cantidad de registros que se procesarán:
Utilice intervalo para especificar la cantidad de registros que se deben procesar. Si omite FIRST y NEXT, se procesan todos los registros de forma predeterminada. |
Ejemplos
Dividir una tabla a partir de un único campo clave
Genera varias tablas de salida a partir de valores únicos del campo Nombre_proveedor en la tabla Ap_Trans:
OPEN Trans_Cp
SPLITVALUES ON Nombre_proveedor PREFIX Proveedor_ FIELDS Proveedor_núm Ciudad_proveedor Factura_núm Fecha_factura Importe_factura NúmProd Cantidad Costo_unidad TO "Tablas_proveedor"
Cada tabla de salida incluye todos los registros que comparten el valor clave único. Las tablas reciben los nombres Proveedor_nombre_proveedor. Por ejemplo, una tabla llamada Proveedor_Koro_International incluye todos los registros en los que Koro International sea el valor de Nombre_proveedor.
Las tablas se guardan en la carpeta Tablas_proveedor del directorio de trabajo en Analytics.Analytics
Dividir una tabla a partir de varios campos clave
Genera varias tablas de salida a partir de combinaciones de valores únicos de los campos Nombre_proveedor y Fecha_factura en la tabla Ap_Trans.
La función ALLTRIM( ) elimina los espacios iniciales y finales innecesarios de los valores de nombre de proveedor. Si no elimina los espacios, se convierten en varios caracteres de guion bajo (_), lo que consume caracteres de la cantidad permitida para los nombres de las tablas de salida.
La función DATE( ) convierte el campo Fecha_factura al tipo de datos de caracteres, que es obligatorio para la concatenación.
OPEN Trans_Cp
SPLITVALUES ON ALLTRIM(Nombre_proveedor)+"_"+DATE(Fecha_factura; "MM/DD/YY") FIELDS Proveedor_núm Nombre_proveedor Factura_núm Fecha_factura Importe_factura NúmProd Cantidad Costo_unidad TO "Tablas_fecha_proveedor"
Cada tabla de salida incluye todos los registros que comparten una combinación única de valores clave. Las tablas reciben los nombres nombre_proveedor_fecha_factura. Por ejemplo, una tabla llamada Koro_International_06_15_23 incluye todos los registros en los que Koro International sea el valor de Nombre_proveedor y 06_15_23 sea el valor de Fecha_factura.
Las tablas se guardan en la carpeta Tablas_proveedor_fecha del directorio de trabajo en Analytics.Analytics
