IMPORTRANGE

מייבאת טווח של תאים מגיליון אלקטרוני שצוין.

דוגמאות לשימוש

IMPORTRANGE("‎https://docs.google.com/spreadsheets/d/abcd123abcd123‎", "sheet1!A1:C10")‎

IMPORTRANGE(A2,"B2")‎

תחביר

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 לפני ההעברה.

עדכונים של 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 כדי להעביר נתונים מגיליון אלקטרוני שבבעלותכם, תופיע ההודעה הבאה:

You need to connect these sheets error message

יש להמתין כמה שניות אחרי השלמת הפונקציה IMPORTRANGE.
תיפתח שגיאת ‎#REF!‎ שתציג את הבקשה "צריך לחבר את הגיליונות האלה. אישור גישה".
כדי להעניק הרשאת גישה לגיליון האלקטרוני המקורי, לוחצים על אישור גישה.

אם תנסו להשתמש ב-IMPORTRANGE כדי להעביר נתונים מגיליון אלקטרוני שאינו בבעלותכם, בתוך כמה שניות תופיע ההודעה הבאה:

You don't have permissions to access that sheet message

יש להזין בדפדפן את כתובת ה-URL של הגיליון האלקטרוני המקורי.
מבקשים הרשאת גישה לגיליון האלקטרוני.
ממתינים עד שהבעלים של הגיליון האלקטרוני יעניק לכם גישה.

לאחר שניתנה הרשאת הגישה, לכל מי שיש הרשאת עריכה בגיליון היעד תהיה אפשרות להשתמש בפונקציה IMPORTRANGE כדי לשלוף נתונים מכל חלק מגיליון המקור. הגישה תהיה בתוקף עד שהמשתמש שהעניק אותה יוסר מהמקור. לתשומת ליבכם: הגישה שניתנת לגיליון היעד נספרת למגבלת השיתוף של 600 משתמשים עבור גיליון המקור.

ביצועים

IMPORTRANGE היא פונקציית נתונים חיצונית, בדיוק כמו IMPORTXML ו-GOOGLEFINANCE. לכן נדרש חיבור לאינטרנט כדי לפעול. Sheets חייב להוריד את כל הטווח למחשב שלכם, והוא יושפע מרשת איטית. מכסת הנתונים מוגבלת ל-10MB של נתונים שמתקבלים בכל בקשה. אם הביצועים של IMPORTRANGE איטיים, כדאי להגביל את גודל הטווחים המיובאים. לחלופין, אפשר להוסיף סיכום של חישובים למסמך המקור, כדי שיהיה צורך להעביר פחות נתונים לגיליון המקומי ולבצע יותר פעולות חישוב מרחוק.

טיפ: אפשר להשתמש בכלים אחרים. AppsScript יכול לקרוא מסמכים אחרים וניתן להפעיל אותו בעת העריכה ובלוח זמנים מוגדר מראש. התכונה "גיליונות מקושרים" כוללת רענון מתוזמן, והיא גם מתאימה יותר לפעולות טעינה וייבוא של קבוצות נתונים גדולות יותר.

מגבלות שימוש

Loading data may take a while because of the large number of requests error message

כשפונקציות IMPORTRANGE יוצרות יותר מדי תנועה, ייתכן שתופיע בתאים ההודעה "בטעינה…" עם הודעת השגיאה המפורטת "שגיאה: טעינת הנתונים עשויה להימשך זמן-מה בגלל מספר רב של בקשות. כדאי לנסות לצמצם את מספר הפונקציות מסוג IMPORTHTML‏, IMPORTDATA‏, IMPORTFEED או IMPORTXML בכל הגיליונות האלקטרוניים שיצרת."

המגבלות נאכפות על מי שיצר את המסמך. משתמשים חייבים להביא בחשבון את סך כל השימוש בכל פונקציות הייבוא בכל המסמכים הפתוחים שהם יוצרים. גם עריכה של שותף עריכה יכולה להיחשב כחלק מהמכסה.

כדי לפתור את הודעת השגיאה, אנחנו ממליצים למשתמשים לצמצם את כמות הנטישה בפונקציית הייבוא. לדוגמה, אם הערך שלגביו התקבלה הודעת השגיאה ב-arg בפונקציה ‎=IMPORTRANGE(arg) משתנה לעיתים קרובות, זה עלול להוביל לביצוע של שיחות חיצוניות רבות שיכולות לגרום לויסות הנתונים (throttle).

עדכניות הנתונים

Google Sheets מוודא שהמשתמשים ב-Sheets מקבלים נתונים עדכניים כל עוד הם מקפידים על שימוש סביר. בזמן שהמסמך פתוח, הפונקציה IMPORTRANGE בודקת בכל שעה באופן אוטומטי אם יש עדכונים, גם אם הנוסחה והגיליון האלקטרוני לא משתנים. אם מוחקים תאים, קוראים אותם או מחליפים תאים שיש בהם את אותה הנוסחה, מופעלת טעינה מחדש של הפונקציות. אם פותחים את המסמך וטוענים אותו מחדש, לא תופעל טעינה מחדש של הפונקציה IMPORTRANGE.

תנודתיות

כשמשתמשים בפונקציה IMPORTRANGE, ייתכן שתופיע בתא ההודעה "‎#ERROR!‎", מלווה בהודעת השגיאה המפורטת "שגיאה: אין להשתמש בפונקציה הזו לאזכור תא שמכיל NOW‏, ‏RAND או RANDBETWEEN". פונקציות ייבוא אינן יכולות לאזכר פונקציות תנודתיות כמו NOW‏, ‏RAND או RANDBETWEEN. הגבלה זו מונעת עומס יתר בגיליון האלקטרוני של המשתמשים, כי הפונקציות התנודתיות האלה מתעדכנות בתדירות גבוהה.

This function is not allowed to reference a cell with NOW(), RAND(), or RANDBETWEEN() error message

טיפ: הפונקציה TODAY היא היחידה שיוצאת מהכלל. היא פונקציה תנודתית אבל לא מתעדכנת יותר מפעם ביום.

מומלץ לבצע את הפעולות הבאות:

מעתיקים את התוצאה של הפונקציות התנודתיות האלה.
משתמשים בהדבקה מיוחדת ערכים בלבד.
מאזכרים את הערכים הסטטיים.

אם תבצעו את הפעולות שפורטו, כל הערכים יהיו סטטיים. לדוגמה, אם מעתיקים תוצאות של NOW ומדביקים אותן בהדבקה מיוחדת כערכים, הערכים שהדבקתם לא ישתנו יותר.

לכל שאלה נוספת, ניתן לפנות לעזרה מהקהילה של עורכי Google Docs.

ראו בנוסף

IMPORTXML: מייבאת נתונים ממבחר של סוגי נתונים מובנים, כולל XML‏‏‏‏‏‏‏‏‏‏,‏‏‏‏‏‏‏‏ HTML‏‏‏‏‏‏‏‏‏‏,‏‏‏‏‏‏‏‏ CSV‏‏‏‏‏‏‏‏‏‏,‏‏‏‏‏‏‏‏ TSV ו-RSS וגם מפידים מסוג ATOM XML.

IMPORTHTML: מייבאת נתונים מטבלה או רשימה בדף HTML.

IMPORTFEED: מייבאת פיד מסוג RSS או ATOM.

IMPORTDATA: מייבאת נתונים מכתובת URL מסוימת בפורמט csv. (ערכים מופרדים בפסיקים) או בפורמט tsv. (ערכים מופרדים בטאבים).

איך מבצעים אופטימיזציה של הפניה לנתונים?