Comando REFRESH

Información de concepto

Actualizar datos en las tablas de Analytics

Actualiza los datos de una tabla de Analytics desde su origen de datos asociado.

Sintaxis

REFRESH <nombre_tabla> <PASSWORD núm>

Parámetros

Nombre	Descripción
nombre_tabla opcional	El nombre de la tabla de Analytics que se actualizará. Si no especifica un nombre_tabla, se actualiza la tabla abierta.
PASSWORD núm opcional	La definición de contraseña que se debe usar. No se utiliza PASSWORD núm para solicitar o especificar una contraseña real. La definición de contraseña hace referencia a una contraseña proporcionada o configurada previamente con el comando PASSWORD, el comando SET PASSWORD o la etiqueta de estudio analítico PASSWORD. núm es el número de la definición de contraseña. Por ejemplo, si se proporcionaron o configuraron dos contraseñas previamente en un script, o al programar un script de estudio analítico, PASSWORD 2 especifica que se utiliza la contraseña número 2. Si desea obtener más información acerca de la especificación o configuración de contraseñas, consulte: Comando PASSWORD Comando SET PASSWORD Etiqueta de estudio analítico PASSWORD Nota La contraseña se utiliza para acceder al sistema de datos de origen original. No puede utilizar REFRESH con una contraseña para orígenes de datos basados en archivos, con la excepción de archivos PDF.

Nombre

Descripción

nombre_tabla

opcional

El nombre de la tabla de Analytics que se actualizará. Si no especifica un nombre_tabla, se actualiza la tabla abierta.

PASSWORD núm

opcional

La definición de contraseña que se debe usar.

No se utiliza PASSWORD núm para solicitar o especificar una contraseña real. La definición de contraseña hace referencia a una contraseña proporcionada o configurada previamente con el comando PASSWORD, el comando SET PASSWORD o la etiqueta de estudio analítico PASSWORD.

núm es el número de la definición de contraseña. Por ejemplo, si se proporcionaron o configuraron dos contraseñas previamente en un script, o al programar un script de estudio analítico, PASSWORD 2 especifica que se utiliza la contraseña número 2.

Si desea obtener más información acerca de la especificación o configuración de contraseñas, consulte:

Nota

La contraseña se utiliza para acceder al sistema de datos de origen original.

No puede utilizar REFRESH con una contraseña para orígenes de datos basados en archivos, con la excepción de archivos PDF.

Ejemplos

Actualización de una tabla sin necesidad de una contraseña

Si no se requiere una contraseña para el origen de datos, puede ingresar el comando REFRESH y el nombre de la tabla de Analytics que desea actualizar.

REFRESH Facturas

Actualización de una tabla con una contraseña en un script interactivo

Si está creando un script interactivo, puede solicitar la contraseña al usuario:

PASSWORD 1 "Ingrese su contraseña:"
REFRESH Facturas PASSWORD 1

Si está actualizando una tabla importada originalmente de un origen de datos protegido por contraseña mediante el comando ACCESSDATA, la solicitud de contraseña es automática y no necesita especificarse por separado:

REFRESH Facturas

Actualización de una tabla con una contraseña en un script no interactivo

Puede configurar la contraseña en un script si no desea solicitar el valor al usuario:

SET PASSWORD 1 TO "contraseña"
REFRESH Facturas PASSWORD 1

La desventaja de este método es que la contraseña aparece como texto claro en el script.

Observaciones

Si desea obtener más información sobre la forma en la que funciona este comando, consulte Actualizar datos en las tablas de Analytics.

Cómo funciona

El comando REFRESH actualiza el contenido de una tabla volviendo a ejecutar el comando IMPORT o el comando ACCESSDATA utilizado inicialmente para definir e importar la tabla.

REFRESH actualiza únicamente el contenido de la tabla

El comando REFRESH actualiza únicamente el contenido de los campos existentes de una tabla de Analytics. No puede actualizar un formato de tabla de Analytics.

No puede utilizar REFRESH si la estructura de los datos de origen ha cambiado; por ejemplo, si se han agregado o quitado campos. Debe volver a importar los datos.

Orígenes de datos que permiten la actualización

Puede utilizar el comando REFRESH para actualizar el contenido de una tabla de Analytics creada utilizando cualquiera de los siguientes comandos:

IMPORT ACCESS
IMPORT DELIMITED
IMPORT EXCEL
IMPORT ODBC (antes comando ODBC)
IMPORT PDF
IMPORT PRINT
IMPORT SAP
IMPORT XBRL
IMPORT XML
ACCESSDATA (orígenes de datos ODBC)

Nota

Para que el comando REFRESH funcione con archivos de Excel de versiones anteriores (*.xls) y archivos de Microsoft Access (*.mdb), debe estar instalado el motor de base de datos de Microsoft Access de 32 bits. Si desea obtener más información, consulte Excluir el motor de base de datos de Microsoft Access opcional.

REFRESH y ACCESSDATA

Las siguientes pautas se aplican al actualizar una tabla importada de un origen de datos ODBC mediante el comando ACCESSDATA.

Tabla abierta Si la tabla está abierta al actualizarla, necesitará temporalmente espacio en disco igual al doble del tamaño de la tabla. Si tiene espacio en disco limitado, cierre la tabla primero antes de actualizarla.
Las tablas de Analytics 12 que se importaron mediante el comando ACCESSDATA en la versión 12 de Analytics no se pueden actualizar, incluso si está utilizando una versión más reciente de Analytics.
Si desea poder actualizar estas tablas, vuelva a importarlas utilizando Analytics 12.5 o posterior.

REFRESH y contraseñas

Puede utilizar el comando REFRESH con orígenes de datos protegidos por contraseña que existen en una base de datos o en un servicio de datos en la nube.

No puede utilizar el mandato REFRESH con orígenes de datos basados en archivos protegidos por contraseña, como archivos de Excel. La única excepción son los archivos PDF protegidos por contraseña.