Comando REFRESH

Atualiza os dados em uma tabela do Analytics com a origem de dados associada.

Sintaxe

REFRESH <nome_tabela> <PASSWORD num>

Parâmetros

Nome	Descrição
nome_tabela opcional	O nome da tabela do Analytics a ser atualizada. Se você não especificar um nome_tabela, a tabela aberta será atualizada.
PASSWORD num opcional	A definição de senha a ser usada. PASSWORD num não é usado para solicitar ou especificar uma senha real. A definição de senha faz referência a uma senha previamente fornecida ou definida com o comando PASSWORD, o comando SET PASSWORD ou a tag de análise PASSWORD. num é o número da definição de senha. Por exemplo, se as duas senhas foram previamente fornecidas ou definidas em um script, ou no agendamento de uma análise, PASSWORD 2 especifica o uso da senha nº 2. Para obter mais informações sobre o fornecimento ou a definição de senhas, consulte: Comando PASSWORD Comando SET Tag de análise PASSWORD Nota A senha é usada para acessar o sistema de dados de origem original. Não é possível usar REFRESH com uma senha para fontes de dados baseadas em arquivos, com a exceção de PDFs.

Nome

Descrição

nome_tabela

opcional

O nome da tabela do Analytics a ser atualizada. Se você não especificar um nome_tabela, a tabela aberta será atualizada.

PASSWORD num

opcional

A definição de senha a ser usada.

PASSWORD num não é usado para solicitar ou especificar uma senha real. A definição de senha faz referência a uma senha previamente fornecida ou definida com o comando PASSWORD, o comando SET PASSWORD ou a tag de análise PASSWORD.

num é o número da definição de senha. Por exemplo, se as duas senhas foram previamente fornecidas ou definidas em um script, ou no agendamento de uma análise, PASSWORD 2 especifica o uso da senha nº 2.

Para obter mais informações sobre o fornecimento ou a definição de senhas, consulte:

Nota

A senha é usada para acessar o sistema de dados de origem original.

Não é possível usar REFRESH com uma senha para fontes de dados baseadas em arquivos, com a exceção de PDFs.

Exemplos

Atualização de uma tabela sem necessidade de senha

Se uma senha não é necessária para a fonte de dados, basta especificar o comando REFRESH e o nome da tabela do Analytics a ser atualizada.

REFRESH Faturas

Atualização de uma tabela com uma senha em um script interativo

Se estiver criando um script interativo, você poderá solicitar que o usuário digite a senha:

PASSWORD 1 "Digite sua senha:"
REFRESH Faturas PASSWORD 1

Se estiver atualizando uma tabela originalmente importada de uma fonte de dados protegida por senha usando o comando ACCESSDATA, a solicitação da senha é automática e não precisa ser especificada separadamente:

REFRESH Faturas

Atualização de uma tabela com uma senha em um script não interativo

Você pode definir a senha em um script se não quiser solicitar o valor ao usuário:

SET PASSWORD 1 TO "senha"
REFRESH Faturas PASSWORD 1

A desvantagem desse método é que a senha é exibida como um texto claro no script.

Atualização de uma tabela com uma senha em uma análise do Servidor AX

Se estiver criando uma análise no Servidor AX, você poderá solicitar que o usuário insira a senha quando a análise for agendada ou executada ad hoc:

COMMENT
//ANALYTIC Atualizar Tabela
//PASSWORD 1 "Digite sua senha:"
END
REFRESH Faturas PASSWORD 1

Observações

Nota

Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.

Como funciona?

O comando REFRESH atualiza o conteúdo de uma tabela executando de novo o comando IMPORT, ou o comando ACCESSDATA, inicialmente usado para definir e importar a tabela.

REFRESH atualiza apenas o conteúdo da tabela

O comando REFRESH atualiza apenas o conteúdo dos campos existentes em uma tabela do Analytics. Ele não pode atualizar o layout da tabela do Analytics.

Não é possível usar REFRESH se a estrutura dos dados de origem tiver sido alterada. Por exemplo, se os campos tiverem sido adicionados ou removidos. Você deverá reimportar os dados.

Origens de dados compatíveis com a atualização

Você pode usar o comando REFRESH para atualizar o conteúdo de uma tabela do Analytics criada usando qualquer um dos seguintes comandos:

IMPORT ACCESS
IMPORT DELIMITED
IMPORT EXCEL
IMPORT ODBC (comando ODBC herdado)
IMPORT PDF
IMPORT PRINT
IMPORT SAP
IMPORT XBRL
IMPORT XML
ACCESSDATA (origens de dados ODBC)

REFRESH e ACCESSDATA

As seguintes diretrizes se aplicam ao atualizar uma tabela importada de uma origem de dados ODBC usando o comando ACCESSDATA.

Tabela aberta Se a tabela estiver aberta quando você atualizá-la, você precisará temporariamente de espaço em disco igual ao dobro do tamanho da tabela. Se o espaço em disco for limitado, feche a tabela antes de atualizá-la.
Analytics 12 As tabelas que foram importadas usando o comando ACCESSDATA na versão 12 do Analytics não podem ser atualizadas, mesmo se você estiver usando uma versão mais recente do Analytics.
Se quiser poder atualizar essas tabelas, reimporte-as usando o Analytics 12.5 ou posterior.

REFRESH e senhas

Você pode usar o comando REFRESH com origens de dados protegidas por senha existentes em um banco de dados ou em um serviço de dados em nuvem.

Você não pode usar o comando REFRESH com origens de dados baseadas em arquivos protegidos por senha, como arquivos do Excel. A única exceção são os PDFs protegidos por senha.

REFRESH e a janela Aplicativo de análise

Não use o comando REFRESH em scripts que serão executados na janela Aplicativo de análise.

Dependendo da forma como uma tabela é importada, a atualização de dados na tabela não é permitida ou pode gerar resultados imprevisíveis, se executada na janela Aplicativo de análise.

Se você quiser atualizar dados como parte de um script executado na janela Aplicativo de análise, use o comando IMPORT ou o comando ACCESSDATA e sobrescreva a tabela.

[ Voltar ao início ]

Guia de scripting do ACL 14.1