IMPORTRANGE

Importa um intervalo de células a partir de uma folha de cálculo especificada.

Exemplos de utilização

IMPORTRANGE("https://docs.google.com/spreadsheets/d/abcd123abcd123"; "página1!A1:C10")

IMPORTRANGE(A2;"B2")

Sintaxe

IMPORTRANGE(url_folha_de_cálculo, string_intervalo)

• url_folha_de_cálculo – o URL da folha de cálculo a partir da qual os dados serão importados.

  • O valor de url_folha_de_cálculo tem de estar entre aspas ou ser uma referência a uma célula que contém o URL de uma folha de cálculo.

• string_intervalo – uma string com o formato "[nome_página!]intervalo" (por exemplo, "Página1!A2:B6" ou "A2:B6") a especificar o intervalo a importar.

  • O componente nome_página de string_intervalo é opcional; por predefinição, IMPORTRANGE irá importar do intervalo definido na primeira página.

  • O valor de string_intervalo tem de estar entre aspas ou ser uma referência a uma célula que contém o texto adequado.

Detalhes técnicos e práticas recomendadas

Qualquer atualização ao documento de origem IMPORTRANGE irá fazer com que todos os documentos de receção abertos sejam atualizados e apresentem uma barra de carregamento verde. A função IMPORTRANGE também aguarda que os cálculos sejam concluídos no documento de origem antes de devolver resultados para o documento de receção, mesmo que não existam cálculos a serem feitos no intervalo de origem.

Práticas recomendadas

• Limite o número de páginas de receção porque cada página de receção tem de ser lida a partir da página de origem
• Reestruture e condense o resultado antes de usar a função IMPORTRANGE, especialmente se fizer importações a partir de uma página atualizada com frequência.
  • Por exemplo, o objetivo é calcular a soma de 1 000 000 de linhas de outra folha de cálculo. É mais rápido calcular a soma nessa folha de cálculo e, em seguida, usar a função IMPORTRANGE para obter essa soma numerada do que usar a função IMPORTRANGE para transferir diretamente 1 000 000 linhas de dados e calcular a soma na folha de cálculo. Este método condensa e agrega as informações da função IMPORTRANGE antes da transferência.

As atualizações da função IMPORTRANGE podem ser propagadas para outras páginas ao agrupar as mesmas. Se a página B tiver uma função IMPORTRANGE(página A) e a página C tiver uma função IMPORTRANGE(página B), é criada uma cadeia. Qualquer atualização à página A faz com que a página B e a página C sejam atualizadas.

Práticas recomendadas

• Limite as cadeias da função IMPORTRANGE em várias páginas.
• Evite ciclos da função IMPORTRANGE. Por exemplo, é criado um ciclo se usar a função IMPORTRANGE em várias folhas de cálculo que se referem entre si: os dados da folha de cálculo A usam a função IMPORTRANGE nos dados da folha de cálculo B e a folha de cálculo B também usa a função IMPORTRANGE para obter dados da folha de cálculo A. Isto provoca uma repetição entre ambas. Cada uma tenta referenciar continuamente a outra e não existe um resultado de dados real.
• Existe um atraso entre a alteração na página de origem e a página afetada. Isto significa que várias camadas da função IMPORTRANGE em vários documentos em cadeia podem causar longos atrasos entre as atualizações da página de origem e os resultados da página afetada.

A função IMPORTRANGE é atualizada quando um documento é aberto pela primeira vez ou foi aberto nos últimos 5 minutos. Tal como acontece com a cadeia de atualizações, isto requer que a função IMPORTRANGE ative todos os documentos a partir dos quais faz importações.

Práticas recomendadas

• Tenha em atenção que a atualização da ativação dos documentos pode demorar algum tempo. Pondere limitar as cadeias da função IMPORTRANGE. 

Autorização e acesso

As folhas de cálculo têm de ter autorização explícita para extrair dados de outras folhas de cálculo através de IMPORTRANGE. Quando a página de destino obtém dados de uma nova página de origem pela primeira vez, é pedido ao utilizador que conceda autorização.

Se tentar usar a função IMPORTRANGE para transferir os dados da sua folha de cálculo, é apresentada esta mensagem:

1. Aguarde alguns segundos depois de concluir a função IMPORTRANGE.
2. É apresentado o erro #REF! e o aviso "Precisa de ligar estas folhas de cálculo. Permitir acesso".
3. Para conceder autorização à folha de cálculo de origem, clique em Permitir acesso.

Se tentar usar a função IMPORTRANGE para transferir dados de uma folha de cálculo que não lhe pertence, a seguinte mensagem aparece em alguns segundos: 

1. Introduza o URL da folha de cálculo de origem no navegador.
2. Peça acesso à folha de cálculo.
3. Aguarde até o proprietário da folha de cálculo lhe conceder acesso.

Assim que o acesso for concedido, qualquer editor na folha de cálculo de destino pode usar a função IMPORTRANGE para extrair dados de qualquer parte da folha de cálculo de origem. O acesso permanece ativo até o utilizador que concedeu o mesmo ser removido da origem. Tenha em atenção que o acesso concedido à página de destino é contabilizado no limite de partilha de 600 utilizadores da página de origem.

Desempenho

A função IMPORTRANGE é uma função de dados externa, tal como as funções IMPORTXML e GOOGLEFINANCE. Isto significa que requer uma ligação à Internet para funcionar. O Sheets tem de transferir todo o intervalo para o computador e será afetado se a rede for lenta, além de que está limitado a 10 MB de dados recebidos por pedido. Se verificar que a função IMPORTRANGE está a ter um desempenho lento, pondere limitar o tamanho dos intervalos importados. Em alternativa, coloque os cálculos de resumo no documento de origem, de modo a que menos dados tenham de ser transferidos para a sua página local e mais cálculos possam ser feitos remotamente.

Sugestão: pode utilizar outras ferramentas. O Apps Script pode ler a partir de outros documentos e pode ser acionado ao editar e num horário predefinido. As páginas associadas têm atualizações agendadas e também estão preparadas para suportar maiores carregamentos e importações de conjuntos de dados.

Limites de utilização

Quando as funções IMPORTRANGE criam demasiado tráfego, poderá ver a mensagem "A carregar…" na célula com a seguinte mensagem de erro detalhada: "Erro: O carregamento de dados pode demorar algum tempo devido ao grande número de pedidos. Tente reduzir a quantidade de funções IMPORTHTML, IMPORTDATA, IMPORTFEED ou IMPORTXML nas folhas de cálculo que criou". 

Os limites são aplicados ao criador do documento. Um utilizador tem de considerar a soma de toda a utilização das funções de importação em todos os documentos abertos que criar. Uma edição feita por um colaborador também pode ser contabilizada na sua quota.

Para resolver a mensagem de erro, recomendamos que os utilizadores reduzam a utilização de várias funções de importação. Por exemplo, se o valor resolvido para arg em =IMPORTRANGE(arg) mudar frequentemente, podem ser emitidas muitas chamadas externas, o que pode provocar a limitação. 

Atualização dos dados

O Google Sheets garante que os respetivos utilizadores obtêm os dados atualizados e mantêm uma utilização razoável. A função IMPORTRANGE verifica automaticamente a existência de atualizações a cada hora enquanto o documento está aberto, mesmo que a fórmula e a folha de cálculo não sejam alteradas. Se eliminar, ler ou substituir as células com a mesma fórmula, a atualização das funções é acionada. Se abrir e atualizar o documento, não é acionada uma atualização na função IMPORTRANGE.

Volatilidade

Ao usar a função IMPORTRANGE, poderá receber a mensagem "#ERROR!" na célula com uma mensagem de erro detalhada "Erro: Esta função não tem permissão para fazer referência a uma célula com NOW, RAND ou RANDBETWEEN". As funções de importação não podem referenciar direta ou indiretamente uma função volátil como AGORA, ALEATÓRIO ou ALEATÓRIOENTRE. Isto impede a sobrecarga da folha de cálculo dos utilizadores, uma vez que estas funções voláteis são atualizadas com frequência.

Sugestão: a única exceção a esta regra é a função HOJE porque, embora seja volátil, não é atualizada mais do que uma vez por dia.

Recomendamos que:

1. Copie o resultado dessas funções voláteis.
2. Use a opção Colar especial Apenas valores.
3. Faça referência a esses valores estáticos. 

Se o fizer, todos os valores tornam-se estáticos. Por exemplo, se copiar e usar a colagem especial nos resultados da função AGORA como valores, os valores colados já não serão alterados.

Se ainda tiver dúvidas, visite a Comunidade de ajuda dos editores do Google Docs para obter ajuda.

Veja também

IMPORTXML: Importa dados de qualquer um dos vários tipos de dados estruturados, incluindo XML, HTML, CSV, TSV e feeds RSS e ATOM XML.

IMPORTHTML: Importa dados de uma tabela ou de uma lista numa página HTML.

IMPORTFEED: Importa um feed RSS ou ATOM.

IMPORTDATA: Importa dados de um determinado URL no formato .csv (valores separados por vírgulas) ou .tsv (valores separados por tabulação).

Saiba como otimizar a sua referência de dados.