Commande REFRESH

Information de concept

Mise à jour des données d'une table Analytics

Met à jour les données d'une table Analytics depuis sa source de données associée.

Syntaxe

REFRESH <nom_table> <PASSWORD num>

Paramètres

Nom	Description
nom_table optionnel	Nom de la table Analytics à actualiser. Si vous n'indiquez pas de nom_table, la table ouverte est actualisée.
PASSWORD num optionnel	Définition de mot de passe à utiliser. Vous n'utilisez pas PASSWORD num pour inviter à saisir ou pour spécifier un mot de passe réel. La définition de mot de passe renvoie à un mot de passe fourni ou défini auparavant à l'aide de la commande PASSWORD, de la commande SET PASSWORD ou de la balise d'outil d'analyse PASSWORD. num correspond au numéro de la définition de mot de passe. Par exemple, si deux mots de passe ont été fournis ou définis auparavant dans un script, ou lors de la planification d'un script d'analyse de données, PASSWORD 2 indique que le mot de passe n° 2 est utilisé. Pour plus d'informations sur la fourniture ou définition de mots de passe, consultez les rubriques : Commande PASSWORD Commande SET PASSWORD Balise d'outil d'analyse PASSWORD Remarque Le mot de passe est utilisé pour accéder au système de données source d'origine. Vous ne pouvez pas utiliser la commande REFRESH avec un mot de passe pour les sources de données sur fichier, à l'exception des PDF.

Nom

Description

nom_table

optionnel

Nom de la table Analytics à actualiser. Si vous n'indiquez pas de nom_table, la table ouverte est actualisée.

PASSWORD num

optionnel

Définition de mot de passe à utiliser.

Vous n'utilisez pas PASSWORD num pour inviter à saisir ou pour spécifier un mot de passe réel. La définition de mot de passe renvoie à un mot de passe fourni ou défini auparavant à l'aide de la commande PASSWORD, de la commande SET PASSWORD ou de la balise d'outil d'analyse PASSWORD.

num correspond au numéro de la définition de mot de passe. Par exemple, si deux mots de passe ont été fournis ou définis auparavant dans un script, ou lors de la planification d'un script d'analyse de données, PASSWORD 2 indique que le mot de passe n° 2 est utilisé.

Pour plus d'informations sur la fourniture ou définition de mots de passe, consultez les rubriques :

Remarque

Le mot de passe est utilisé pour accéder au système de données source d'origine.

Vous ne pouvez pas utiliser la commande REFRESH avec un mot de passe pour les sources de données sur fichier, à l'exception des PDF.

Exemples

Actualisation d'une table sans mot de passe requis

Si un mot de passe n'est pas requis pour la source de données, spécifiez simplement la commande REFRESH et le nom de la table Analytics à actualiser.

REFRESH Factures

Actualisation d'une table avec un mot de passe dans un script interactif

Si vous créez un script interactif, vous pouvez inviter l'utilisateur à saisir un mot de passe :

PASSWORD 1 "Saisissez votre mot de passe :"
REFRESH Factures PASSWORD 1

Si vous actualisez une table ayant été importée à l'origine à partir d'une source de données protégée par un mot de passe à l'aide de la commande ACCESSDATA, l'invite de mot de passe est automatique et ne doit pas être spécifiée séparément :

REFRESH Factures

Actualisation d'une table avec un mot de passe dans un script non interactif

Vous pouvez définir le mot de passe dans un script si vous ne souhaitez pas inviter l'utilisateur à saisir la valeur :

SET PASSWORD 1 TO "mot de passe"
REFRESH Factures PASSWORD 1

L'inconvénient de cette méthode est que le mot de passe apparaît sous forme de texte en clair dans le script.

Remarques

Pour plus d'informations sur le fonctionnement de cette commande, consultez Mise à jour des données d'une table Analytics.

Fonctionnement

La commande REFRESH met à jour le contenu d'une table en réexécutant la commande IMPORT ou ACCESSDATA, qui a été utilisée à l'origine pour définir et importer la table.

REFRESH met à jour le contenu de la table uniquement

La commande REFRESH met uniquement à jour le contenu des champs existants dans une table Analytics. Elle ne peut pas mettre à jour un format de table Analytics.

Vous ne pouvez pas utiliser REFRESH si la structure des données source a changé : par exemple, si des champs ont été ajoutés ou supprimés. Vous devez réimporter les données.

Sources de données prenant en charge l'actualisation

La commande REFRESH permet de mettre à jour le contenu d'une table Analytics créée à l'aide de l'une des commandes suivantes :

IMPORT ACCESS
IMPORT DELIMITED
IMPORT EXCEL
IMPORT ODBC (commande ODBC héritée)
IMPORT PDF
IMPORT PRINT
IMPORT SAP
IMPORT XBRL
IMPORT XML
ACCESSDATA (sources de données ODBC)

Remarque

La version 32 bits du moteur de base de données Microsoft Access doit être installée pour que la commande REFRESH puisse fonctionner avec des fichiers Excel utilisant l'ancien format (*.xls) et des fichiers Microsoft Access (*.mdb). Pour plus d'informations, consultez la section Exclure le moteur de base de données Microsoft Access facultatif.

REFRESH et ACCESSDATA

Les instructions suivantes s'appliquent lors de l'actualisation d'une table importée à partir d'une source de données ODBC à l'aide de la commande ACCESSDATA.

Ouvrir la table Si la table est ouverte lorsque vous l'actualisez, il vous faudra temporairement un espace disque égal à deux fois la taille de la table. Si votre espace disque est limité, fermez d'abord la table avant de l'actualiser.
Les tables Analytics 12 ayant été importées à l'aide de la commande ACCESSDATA dans la version 12 d'Analytics ne sont pas actualisables, même si vous utilisez une version plus récente d'Analytics.
Si vous souhaitez pouvoir actualiser ces tables, ré-importez-les à l'aide d'Analytics 12.5 ou version ultérieure.

REFRESH et mots de passe

Vous pouvez utiliser la commande REFRESH avec des sources de données protégées par mot de passe qui existent dans une base de données ou dans un service de données cloud.

Vous ne pouvez pas utiliser la commande REFRESH avec des sources de données sur fichiers protégées par mot de passe, comme des fichiers Excel. Les PDF protégés par mot de passe constituent la seule exception.