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:

  • RECORD utilice el registro completo del campo de datos de origen: todos los campos de la tabla y todas las partes sin definir del registro

    Los campos se utilizan en el orden en el que aparecen en el formato de tabla.

    Conserva los campos calculados.

  • FIELDS nombre_del_campo usar los campos especificados

    Los campos se utilizan en el orden en el que usted los indica.

    Convierte los campos calculados en campos físicos del tipo de datos adecuado en la tabla de destino: ASCII o Unicode (de acuerdo con la edición de Analytics), ACL (el tipo de datos numéricos nativo), Fechahora o Lógico. Completa los campos físicos con los valores calculados reales.

  • FIELDS ALL usa todos los campos de tabla

    Los campos se utilizan en el orden en el que aparecen en el formato de tabla.

    Convierte los campos calculados en campos físicos del tipo de datos adecuado en la tabla de destino: ASCII o Unicode (de acuerdo con la edición de Analytics), ACL (el tipo de datos numéricos nativo), Fechahora o Lógico. Completa los campos físicos con los valores calculados reales.

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:

  • nombre_tabla guarda los resultados en una tabla de Analytics

    Especifique el nombre_tabla como una cadena entre comillas con la extensión de archivo .FIL. Por ejemplo: TO "Salida.FIL"

    Por valor predeterminado, el archivo de datos de la tabla (.FIL) se guarda en la carpeta que contiene el proyecto de Analytics.

    Utilice una ruta de archivo absoluta o relativa para guardar el archivo de datos en una carpeta existente o una diferente:

    • TO "C:\Salida.FIL"
    • TO "Resultados\Salida.FIL"

    Nota

    Los nombres de las tablas tienen un límite de 64 caracteres alfanuméricos, sin incluir la extensión .FIL. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

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:

  • FIRST comienza a procesar desde el primer registro hasta que se llega al número de registros especificado
  • NEXT comienza a procesar desde el registro seleccionado actualmente hasta que se llega al número de registros especificado

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:

  • los mismos campos
  • el mismo orden de campos
  • los campos coincidentes son de la misma longitud
  • los campos coincidentes tienen el mismo tipo de datos

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 (Editar > Copiar), se crea un nuevo formato de tabla que permanece asociado al archivo de datos original. No se crea un nuevo archivo de datos.

Guía de creación de scripts de ACL 14.1