Comando EXTRACT
Extrae datos de una tabla de Analytics y envía esos datos a una tabla de Analytics nueva o los anexa a una tabla de Analytics existente. Puede extraer registros completos o campos seleccionados.
Sintaxis
EXTRACT {RECORD | FIELDS nombre_campo <AS nombre_visible> <...n>|FIELDS ALL} TO nombre_tabla <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango> <EOF> <APPEND> <OPEN> <LOCAL>
Parámetros
Nombre | Descripción |
---|---|
RECORD | FIELDS nombre_campo |FIELDS ALL |
Los campos que se deben incluir en la salida:
|
AS nombre_visible opcional |
Se utiliza únicamente al extraer por medio de FIELDS nombre_campo. El nombre visible (título de columna alternativo) para el campo en la vista de la nueva tabla de Analytics. Si desea que el nombre visible sea el mismo que el nombre del campo o un nombre visible existente en la tabla de origen, no use AS. Especifique nombre_visible como una cadena entre comillas. Utilice un punto y coma (;) entre las palabras si desea que haya un salto de línea en el título de la columna. Nota
AS solo funciona cuando se extrae a una nueva tabla. Si está agregando a una tabla existente, los títulos de columna alternativos de la tabla existente tienen prioridad. |
TO nombre_tabla |
El lugar al que se deben enviar los resultados del comando:
|
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). |
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. |
EOF opcional |
Ejecute el comando una vez más después de que se alcance el final del archivo. De esta manera, se asegura de que se procese el registro final de la tabla cuando se encuentra dentro de un comando GROUP. Utilice EOF solo si todos los campos son campos calculados que hacen referencia a registros anteriores. |
APPEND opcional |
Anexa la salida del comando al final de un archivo existente en lugar de sobrescribir el archivo. Nota Debe asegurarse de que la estructura de la salida del comando y del archivo existente sean idénticas:
Analytics anexa la salida a un archivo existente sin importar cuál sea su estructura. Si la estructura de la salida y la del archivo existente no coinciden, es posible que los datos que se obtengan estén incompletos, mezclados o sean imprecisos. |
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. |
LOCAL opcional |
Guarda el archivo de salida en la misma ubicación que el proyecto de Analytics. Nota Aplicable únicamente al ejecutar el comando en una tabla de servidor con un archivo de salida que es una tabla de Analytics. |
Ejemplos
Extracción de todos los registros de una tabla a una nueva tabla
Usted crea un duplicado exacto de la tabla Cuentas_por_cobrar_Cliente extrayendo todos los registros a una nueva tabla de Analytics. Todos los campos calculados se conservan como campos calculados:
OPEN Cuentas_por_cobrar_Cliente EXTRACT RECORD TO "Cuentas_por_cobrar_Cliente_2"
Extracción de todos los campos de una tabla a una nueva tabla
Usted extrae todos los campos definidos de la tabla Cuentas_por_cobrar_Cliente a una nueva tabla de Analytics. Los campos calculados se convierten en campos físicos y se completan con los valores calculados reales:
OPEN Cuentas_por_cobrar_Cliente EXTRACT FIELDS ALL TO "Cuentas_por_cobrar_Cliente_2"
Extracción de todos los registros de una tabla y anexión a una tabla existente
Usted extrae todos los registros de la tabla Cuentas_por_cobrar_Cliente y los anexa a un grupo al final de la tabla Cuentas_por_cobrar_cliente_maestra:
OPEN Cuentas_por_cobrar_Cliente EXTRACT RECORD TO "Cuentas_por_cobrar_Cliente_maestra" APPEND
Extracción de todos los registros de una tabla y anexión a una tabla existente en una carpeta diferente
Usted extrae todos los registros de la tabla Cuentas_por_cobrar_Cliente y los anexa a un grupo al final de la tabla Cuentas_por_cobrar_cliente_maestra, que se encuentra en una carpeta diferente de la carpeta del proyecto de Analytics:
OPEN Cuentas_por_cobrar_Cliente EXTRACT RECORD TO ""C:\Usuarios\Datos del Cliente\Cuentas_por_cobrar_maestra" APPEND
Extracción de un subconjunto de campos de una tabla a una nueva tabla
Usted extrae tres campos de la tabla Cuentas_por_cobrar_Cliente a una nueva tabla de Analytics:
OPEN Cuentas_por_cobrar_Cliente EXTRACT FIELDS Nombre Vencimiento Fecha TO "Cuentas_por_cobrar_cliente_fechas.fil"
Creación de nombres visibles para los campos extraídos
Usted extrae tres campos de la tabla Cuentas_por_cobrar_Cliente y crea nombres visibles para los campos de la nueva tabla de Analytics:
OPEN Cuentas_por_cobrar_Cliente EXTRACT FIELDS Nombre AS "Cliente;Nombre" Vencimiento AS "Vencimiento;Fecha" Date AS "Factura;Fecha" TO "Cuentas_por_cobrar_cliente_fechas.fil"
Extracción de campos sobre la base de una condición
Usted extrae tres campos de la tabla Cuentas_por_cobrar_Cliente a una nueva tabla de Analytics si la fecha de la columna Vencimiento es anterior al 1 de julio de 2014:
OPEN Cuentas_por_cobrar_Cliente EXTRACT FIELDS Nombre Vencimiento Fecha IF Vencimiento < `20140701` TO "Vencido.fil"
Observaciones
Nota
Si desea obtener más información sobre la forma en la que funciona este comando, consulte Guía de ayuda.
Comparación entre EXTRACT y la copia de una tabla
EXTRACT crea un nuevo archivo de datos de origen (.fil) además de un nuevo formato de tabla.
Al copiar una tabla con el Navegador ( ), se crea un nuevo formato de tabla que permanece asociado al archivo de datos original. No se crea un nuevo archivo de datos.