Comando REFRESH

Informações do conceito

Atualizar dados nas tabelas do Analytics

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 um script de 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 PASSWORD Tag de análise PASSWORD Observação 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 um script de 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:

Observação

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 não criptografado no script.

Observações

Para obter mais informações sobre como este comando funciona, consulte Atualizar dados nas tabelas 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)

Observação

É preciso ter o Microsoft 365 Access Runtime (32-bit) instalado para que o comando REFRESH funcione com arquivos antigos do Excel (*.xls) e arquivos do Microsoft Access (*.mdb). Para obter mais informações, consulte Trabalhar com arquivos antigos do Excel (.xls) ou Access (.mdb).

REFRESH e ACCESSDATA

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

Abrir tabelaSe 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 12As 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.