מייבאת טווח של תאים מגיליון אלקטרוני שצוין.
דוגמאות לשימוש
IMPORTRANGE("https://docs.google.com/spreadsheets/d/abcd123abcd123", "sheet1!A1:C10")
IMPORTRANGE(A2,"B2")
שימוש בהפניות בטבלה: IMPORTRANGE("https://docs.google.com/spreadsheets/d/abcd123abcd123", "DeptSales[Sales Amount]") מידע נוסף על שימוש בטבלאות ב-Google Sheets.
שימוש בטווח תאים בעל שם: IMPORTRANGE("https://docs.google.com/spreadsheets/d/abcd123abcd123", "Sales_total") מידע נוסף על איך לתת שם לטווח של תאים.
תחביר
IMPORTRANGE(spreadsheet_url, range_string)
-
spreadsheet_url‒ כתובת ה-URL של הגיליון האלקטרוני שממנו יתבצע ייבוא הנתונים.- הערך של
spreadsheet_urlחייב להיות בתוך מירכאות או לשמש כהפניה לתא שמכיל את כתובת ה-URL של הגיליון האלקטרוני.
- הערך של
-
range_string– מחרוזת בפורמט"[sheet_name!]range"(למשל"Sheet1!A2:B6"או"A2:B6") לציון הטווח שיש לייבא.-
הרכיב
sheet_nameשל המחרוזתrange_stringהוא אופציונלי. כברירת מחדל, הפונקציהIMPORTRANGEתבצע ייבוא מהטווח הנתון של הגיליון הראשון. -
הערך של
range_stringחייב להיות מוקף במרכאות, מלבד במקרים שבהם הערך הוא הפניה לתא שמכיל את הטקסט המתאים.
-
פרטים טכניים ושיטות מומלצות
כל עדכון של מסמך המקור IMPORTRANGE יגרום לרענון של כל המסמכים המקבלים הפתוחים, ולהצגת סרגל טעינה ירוק. IMPORTRANGE גם ממתין שחישובים יושלמו במסמך המקור לפני שהוא מחזיר תוצאות למסמך המקבל, גם אם לא מתבצע חישוב בטווח המקור.
שיטות מומלצות
- כדאי להגביל את מספר הגיליונות המקבלים, כי כל גיליון מקבל חייב להיקרא מגיליון המקור
- כדאי לסדר מחדש ולאחר מכן לרכז את התוצאה לפני שמשתמשים ב-
IMPORTRANGE, במיוחד אם מייבאים מגיליון Sheets שמתעדכן בתדירות גבוהה.- לדוגמה, המטרה היא לחשב את הסכום של 1,000,000 שורות שהתקבלו מגיליון אלקטרוני אחר. יהיה יותר מהיר לחשב את הסכום בגיליון האלקטרוני האחר ואז להשתמש ב-
IMPORTRANGEכדי לאחזר את הסכום האחד שהתקבל מאשר להשתמש ב-IMPORTRANGEכדי להעביר ישירות את כל 1,000,000 שורות הנתונים ולחשב את הסכום בגיליון האלקטרוני שלכם. השיטה הזו מרכזת ומארגנת מידע עבור הפונקציהIMPORTRANGEלפני ההעברה.
- לדוגמה, המטרה היא לחשב את הסכום של 1,000,000 שורות שהתקבלו מגיליון אלקטרוני אחר. יהיה יותר מהיר לחשב את הסכום בגיליון האלקטרוני האחר ואז להשתמש ב-
עדכונים של IMPORTRANGE יכולים להיכנס לתוקף בגיליונות אחרים אם משרשרים את הגיליונות יחד. אם ב-sheet B [גיליון ב'] יש את הפונקציה IMPORTRANGE(sheet A) ו-sheet C [גיליון ג'] מכיל את הפונקציה IMPORTRANGE(sheet B) אז נוצר שרשור. כל עדכון ב-sheet A [גיליון א'] יגרום לטעינה מחדש של sheet B ו-sheet C.
שיטות מומלצות
- כדאי להגביל את כמות השרשורים של
IMPORTRANGEשמופיעים במספר גיליונות. - כדאי להימנע ממחזורי
IMPORTRANGE. לדוגמה, אם משתמשים ב-IMPORTRANGEבמספר גיליונות אלקטרוניים שמפנים זה לזה אז נוצר מחזור: הנתונים של גיליון אלקטרוני א' משתמשים ב-IMPORTRANGEעל נתונים מגיליון אלקטרוני ב', ובגיליון אלקטרוני ב' נעשה שימוש גם ב-IMPORTRANGEכדי לאחזר נתונים מגיליון אלקטרוני א'. כך נוצרת ביניהם לולאה שבה כל גיליון אלקטרוני ינסה כל הזמן להפנות לשני ולא יתקבל בשום מקרה פלט נתונים בפועל. - יש עיכוב בין השינוי בגיליון המקור לבין השינוי בגיליון המושפע. המשמעות היא ששכבות מרובות של
IMPORTRANGEבמספר מסמכים משורשרים עלולות לגרום לעיכובים ארוכים מהעדכונים של גיליון המקור ועד להופעת התוצאות בגיליון המושפע.
הפונקציה IMPORTRANGE נטענת מחדש כשמסמך נפתח בפעם הראשונה או אם הוא נפתח ב-5 הדקות האחרונות. בדומה לשרשרת העדכונים, פעולה זו דורשת מהפונקציה IMPORTRANGE "להעיר" את כל המסמכים שהיא מייבאת מהם.
שיטות מומלצות
- חשוב להבין שעשוי לחלוף זמן מה עד לעדכון המסמכים שהופכים לפעילים. כדאי להגביל את השרשראות של
IMPORTRANGE.
הרשאה וגישה
IMPORTRANGE. בפעם הראשונה שגיליון היעד שולף נתונים מגיליון חדש המוגדר כמקור, המשתמש יתבקש להעניק הרשאה.IMPORTRANGE כדי להעביר נתונים מגיליון אלקטרוני שבבעלותכם, תופיע ההודעה הבאה:- יש להמתין כמה שניות אחרי השלמת הפונקציה
IMPORTRANGE. - תיפתח שגיאת #REF! שתציג את הבקשה "צריך לחבר את הגיליונות האלה. אישור גישה".
- כדי להעניק הרשאת גישה לגיליון האלקטרוני המקורי, לוחצים על אישור גישה.
אם תנסו להשתמש ב-IMPORTRANGE כדי להעביר נתונים מגיליון אלקטרוני שלא בבעלותכם, בתוך כמה שניות תופיע ההודעה הבאה:
- יש להזין בדפדפן את כתובת ה-URL של הגיליון האלקטרוני המקורי.
- מבקשים הרשאת גישה לגיליון האלקטרוני.
- ממתינים עד שהבעלים של הגיליון האלקטרוני יעניק לכם גישה.
IMPORTRANGE כדי לשלוף נתונים מכל חלק מגיליון המקור. הגישה תהיה בתוקף עד שהמשתמש שהעניק אותה יוסר מהמקור. לתשומת ליבכם: הגישה שניתנת לגיליון היעד נספרת למגבלת השיתוף של 600 משתמשים עבור גיליון המקור.כדאי לדעת: אם הפעלתם את אפשרות "השבתת האפשרויות להורדה, להדפסה ולהעתקה" בגיליון האלקטרוני המקורי, לא תוכלו להשתמש בנוסחאות חדשות של IMPORTRANGE כדי לייצא נתונים. נוסחאות אחרות שהגדרתם לפני שהפעלתם את האפשרות הזו ימשיכו לפעול כרגיל. מידע נוסף על עצירה, הגבלה או שינוי של שיתוף
ביצועים
IMPORTRANGE היא פונקציית נתונים חיצונית, בדיוק כמו IMPORTXML ו-GOOGLEFINANCE. לכן צריך חיבור לאינטרנט כדי שהפונקציה תפעל. Sheets חייב להוריד את כל הטווח למחשב שלכם, והוא יושפע מרשת איטית. מכסת הנתונים מוגבלת ל-10MB של נתונים שמתקבלים בכל בקשה. אם הביצועים של IMPORTRANGE איטיים, כדאי להגביל את גודל הטווחים המיובאים. לחלופין, אפשר להוסיף סיכום של חישובים למסמך המקור, כדי שיהיה צורך להעביר פחות נתונים לגיליון המקומי ולבצע יותר פעולות חישוב מרחוק.
טיפ: אפשר להשתמש בכלים אחרים. AppsScript יכול לקרוא מסמכים אחרים וניתן להפעיל אותו בעת העריכה ובלוח זמנים מוגדר מראש. התכונה 'גיליונות מקושרים' כוללת רענון מתוזמן, והיא גם מתאימה יותר לפעולות טעינה וייבוא של קבוצות נתונים גדולות יותר.
מגבלות שימוש
IMPORTRANGE יוצרות יותר מדי תנועה, יכול להיות שתופיע בתאים ההודעה 'בטעינה…' עם הודעת השגיאה המפורטת "שגיאה: טעינת הנתונים עשויה להימשך זמן-מה בגלל מספר רב של בקשות. כדאי לנסות לצמצם את מספר הפונקציות מסוג IMPORTHTML, IMPORTDATA, IMPORTFEED או IMPORTXML בכל הגיליונות האלקטרוניים שיצרת."=IMPORTRANGE(arg) משתנה לעיתים קרובות, זה עלול להוביל לביצוע של שיחות חיצוניות רבות שיכולות לגרום לויסות הנתונים (throttle).עדכניות הנתונים
IMPORTRANGE בודקת בכל שעה באופן אוטומטי אם יש עדכונים, גם אם הנוסחה והגיליון האלקטרוני לא משתנים. אם מוחקים תאים, קוראים אותם או מחליפים תאים שיש בהם את אותה הנוסחה, מופעלת טעינה מחדש של הפונקציות. אם פותחים את המסמך וטוענים אותו מחדש, לא תופעל טעינה מחדש של הפונקציה IMPORTRANGE.תנודתיות
IMPORTRANGE, יכול להיות שתופיע בתא ההודעה "#ERROR!", מלווה בהודעת השגיאה המפורטת "שגיאה: אין להשתמש בפונקציה הזו לאזכור תא שמכיל NOW, RAND או RANDBETWEEN". פונקציות ייבוא אינן יכולות לאזכר פונקציות תנודתיות כמו NOW, RAND או RANDBETWEEN. הגבלה זו מונעת עומס יתר בגיליון האלקטרוני של המשתמשים, כי הפונקציות התנודתיות האלה מתעדכנות בתדירות גבוהה.TODAY היא היחידה שיוצאת מהכלל. היא פונקציה תנודתית אבל לא מתעדכנת יותר מפעם ביום.מומלץ לבצע את הפעולות הבאות:
- מעתיקים את התוצאה של הפונקציות התנודתיות האלה.
- משתמשים בהדבקה מיוחדת
ערכים בלבד.
- מאזכרים את הערכים הסטטיים.
אם תבצעו את הפעולות שפורטו, כל הערכים יהיו סטטיים. לדוגמה, אם מעתיקים תוצאות של NOW ומדביקים אותן בהדבקה מיוחדת כערכים, הערכים שהדבקתם לא ישתנו יותר.
לכל שאלה נוספת, ניתן לפנות לעזרה מהקהילה של עורכי Google Docs.
ראו בנוסף
IMPORTXML: מייבאת נתונים ממבחר של סוגי נתונים מובנים, כולל XML, HTML, CSV, TSV ו-RSS וגם מפידים מסוג ATOM XML.
IMPORTHTML: מייבאת נתונים מטבלה או רשימה בדף HTML.
IMPORTFEED: מייבאת פיד מסוג RSS או ATOM.
IMPORTDATA: מייבאת נתונים מכתובת URL מסוימת בפורמט csv. (ערכים מופרדים בפסיקים) או בפורמט tsv. (ערכים מופרדים בטאבים).