IMPORTRANGE

Importuje rozsah buněk ze zadané tabulky.

Příklady použití

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

IMPORTRANGE(A2;"B2")

Syntaxe

IMPORTRANGE(url_tabulky; řetězec_rozsahu)

• url_tabulky – adresa URL tabulky, ze které budou importována data.

  • Hodnota pro url_tabulky musí být uzavřena v uvozovkách nebo musí odkazovat na buňku obsahující adresu URL tabulky.

• řetězec_rozsahu – řetězec ve formátu "[název_listu!]rozsah" (např. "List1!A2:B6" nebo "A2:B6") označující rozsah, který se má importovat.

  • Část název_listu argumentuřetězec_rozsahu je nepovinná. Ve výchozím nastavení importuje funkce IMPORTRANGE data z daného rozsahu na prvním listu.

  • Hodnota pro řetězec_rozsahu musí být vložena do uvozovek nebo musí odkazovat na buňku obsahující náležitý text.

Technické podrobnosti a doporučené postupy

IMPORTRANGE při každé aktualizaci zdrojového dokumentu způsobí, že se všechny otevřené přijímající dokumenty obnoví a zobrazí se u nich zelená lišta načítání. IMPORTRANGE také čeká na dokončení výpočtů ve zdrojovém dokumentu, než vrátí výsledky do přijímajícího dokumentu, i když se ve zdrojovém rozsahu žádný výpočet provést nemusí.

Doporučené postupy

• Omezte počet přijímajících listů, protože každý přijímající list musí číst ze zdrojového listu.
• Před použitím funkce IMPORTRANGE upravte strukturu výsledku a zestručněte ho, zejména pokud importujete z často aktualizované tabulky.
  • Vaším cílem je například vypočítat součet 1 000 000 řádků z jiné tabulky. Je rychlejší vypočítat součet ve zdrojové tabulce a pak pomocí funkce IMPORTRANGE načíst tuto jednu číselnou hodnotu součtu, než pomocí funkce IMPORTRANGE přímo přenést 1 000 000 řádků dat a součet vypočítat ve vaší tabulce. Tato metoda zestruční a agreguje informace pro funkci IMPORTRANGE před jejich přenosem.

Aktualizace funkce IMPORTRANGE se mohou šířit na další listy, když listy zřetězíte. Pokud list B obsahuje funkci IMPORTRANGE(list A) a list C funkci IMPORTRANGE(list B), vytvoří se řetězec. Každá aktualizace listu A způsobí, že se znovu načte list B a list C.

Doporučené postupy

• Omezte řetězce funkce IMPORTRANGE na více listech.
• Nepoužívejte cykly funkce IMPORTRANGE. Cyklus například vytvoříte, pokud použijete funkci IMPORTRANGE v několika tabulkách, které na sebe odkazují: data tabulky A používají funkci IMPORTRANGE na data z tabulky B a tabulka B také používá funkci IMPORTRANGE k načítání dat z tabulky A. Vzniká tak mezi nimi smyčka, ve které se každá z nich neustále snaží odkazovat na druhou a nikdy to nevede ke skutečnému výstupu dat.
• Mezi změnou ve zdrojovém listu a cílovým listem je zpoždění. To znamená, že více vrstev funkce IMPORTRANGE v několika zřetězených dokumentech může mít za následek dlouhá zpoždění mezi aktualizací zdrojového listu a výsledky na cílovém listu.

Funkce IMPORTRANGE se znovu načte při prvním otevření dokumentu nebo jeho otevření do posledních 5 minut. Stejně jako v případě řetězců s aktualizacemi je potřeba, aby funkce IMPORTRANGE „probudila“ všechny dokumenty, ze kterých importuje.

Doporučené postupy

• Aktualizace dokumentů, které se stanou aktivními, může nějakou dobu trvat. Zvažte omezení řetězců funkce IMPORTRANGE.

Oprávnění a přístup

Tabulkám musí být k importování dat z jiných tabulek pomocí funkce IMPORTRANGE explicitně uděleno oprávnění. Při prvním importování dat cílovým listem z nového zdrojového listu bude uživatel požádán, aby toto oprávnění udělil.

Pokud se pokusíte použít funkci IMPORTRANGE k přenosu dat z tabulky, kterou vlastníte, zobrazí se tato zpráva:

1. Po dokončení funkce IMPORTRANGE několik sekund počkejte.
2. Otevře se chyba #REF! s výzvou „Musíte tyto listy spojit. Povolte přístup.“
3. Pokud chcete udělit oprávnění zdrojové tabulce, klikněte na Povolit přístup.

Pokud se pokusíte použít funkci IMPORTRANGE k přenosu dat z tabulky, kterou nevlastníte, během několika sekund se zobrazí tato zpráva:

1. Zadejte do prohlížeče adresu URL zdrojové tabulky.
2. Požádejte o přístup k tabulce.
3. Počkejte, až vám vlastník tabulky přístup udělí.

Po udělení přístupu může kterýkoli uživatel s oprávněním editora k cílové tabulce pomocí funkce IMPORTRANGE načíst libovolnou část zdrojové tabulky. Oprávnění k přístupu bude platit, dokud uživatel, který ho udělil, nebude ze zdroje odebrán. Upozorňujeme, že přístup udělený k cílovému listu se započítává do limitu sdílení 600 uživateli zdrojového listu.

Výkon

IMPORTRANGE je externí datová funkce, podobně jako IMPORTXML a GOOGLEFINANCE. Znamená to, že k fungování vyžaduje připojení k internetu. Tabulky musí stáhnout celý rozsah do vašeho počítače a bude na ně mít vliv pomalé připojení. Navíc jsou omezeny na 10 MB přijatých dat na žádost. Pokud při používání funkce IMPORTRANGE pozorujete nízký výkon, zvažte omezení velikosti importovaných rozsahů. Případně ve zdrojovém dokumentu použijte sumarizační výpočty, aby se do místní tabulky nemuselo přenášet tolik dat a více výpočtů se mohlo provádět vzdáleně.

Tip: Můžete použít jiné nástroje. AppsScript může číst z jiných dokumentů a dá se spouštět při úpravách a v předdefinovaném plánu. Připojené tabulky mají plánované obnovování a jsou také vhodnější pro načítání a importování větších souborů dat.

Limity používání

Když funkce IMPORTRANGE vytvářejí příliš velký provoz, může se vám v buňce zobrazit zpráva „Načítání…“ s podrobnou chybovou zprávou „Chyba: Načítání dat může nějakou dobu trvat kvůli velkému počtu požadavků. Zkuste snížit počet funkcí IMPORTHTML, IMPORTDATA, IMPORTFEED nebo IMPORTXML v tabulkách, které jste vytvořili.“

Omezení platí pro autora dokumentu. Uživatel musí brát v úvahu součet všech využití funkcí importu ve všech otevřených dokumentech, které vytvoří. Do kvóty se můžou započítávat i úpravy, které provede spolupracovník.

K vyřešení chybové zprávy uživatelům doporučujeme snížit četnost změny dat u funkce importu. Pokud se například řešená hodnota pro argument ve funkci =IMPORTRANGE(arg) často mění, může se provádět mnoho externích volání, což může způsobovat omezení.

Aktuálnost dat

Tabulky Google zajišťují, aby uživatelé Tabulek měli k dispozici čerstvá data a zároveň jejich používání udržovali v přiměřených mezích. Funkce IMPORTRANGE automaticky kontroluje aktualizace každou hodinu, když je dokument otevřený, i když se vzorec a tabulka nezmění. Pokud buňky smažete, znovu přidáte nebo je přepíšete stejným vzorcem, funkce se znovu načtou. Pokud dokument otevřete a znovu načtete, funkce IMPORTRANGE se znovu nenačte.

Proměnlivost

Když použijete funkci IMPORTRANGE, může se v buňce zobrazit chyba „#ERROR“! s podrobnou chybovou zprávou „Chyba: Tato funkce nesmí odkazovat na buňku s NYNÍ, NÁHČÍSLO nebo RANDBETWEEN“. Funkce importu nemohou přímo ani nepřímo odkazovat na proměnlivou funkci, jako je NYNÍ, NÁHČÍSLO nebo RANDBETWEEN. Zabraňuje se tím přetížení tabulek uživatelů, protože tyto proměnlivé funkce se často aktualizují.

Tip: Jedinou výjimkou je funkce DNES, která je proměnlivá, ale neaktualizuje se více než jednou za den.

Doporučujeme tento postup:

1. Zkopírujte výsledky těchto proměnlivých funkcí.
2. Použijte možnost Vložit jinak Pouze hodnoty.
3. Odkazujte na tyto statické hodnoty.

V takovém případě budou všechny hodnoty statické. Pokud například zkopírujete a vložíte jinak výsledky funkce NYNÍ jako hodnoty, pak se vložené hodnoty již nezmění.

Pokud máte další dotazy, využijte komunitu nápovědy pro Editory Dokumentů Google.

Viz také

IMPORTXML: Importuje data z jakéhokoli typu strukturovaných dat včetně XML, HTML, CSV, TSV a zdrojů RSS a ATOM XML.

IMPORTHTML: Importuje data z tabulky nebo seznamu na stránce HTML.

IMPORTFEED: Importuje zdroj RSS nebo ATOM.

IMPORTDATA: Importuje z dané adresy URL data ve formátu .csv (hodnoty oddělené čárkami) nebo .tsv (hodnoty oddělené tabulátory).

Přečtěte si, jak optimalizovat odkaz na data.